opencode-chat-channel 1.1.0 → 1.2.0

package/README.md

@@ -47,7 +47,26 @@ Edit `~/.config/opencode/opencode.json` and add the plugin:
 
 opencode will pull and install the package automatically on next startup.
 
-#### Step 2: Configure the channel(s) you want to use
+#### Step 2: Select channels to enable
+
+Add `CHAT_CHANNELS` to `~/.config/opencode/.env` to control which channels are active:
+
+```bash
+# ~/.config/opencode/.env
+
+# Enable Feishu only (recommended to start)
+CHAT_CHANNELS=feishu
+
+# Enable multiple channels at once
+# CHAT_CHANNELS=feishu,wecom
+
+# Leave unset or empty = auto mode: any channel with valid credentials starts automatically
+# CHAT_CHANNELS=
+```
+
+Then configure credentials for each enabled channel (see sections below).
+
+#### Step 3: Configure channel credentials
 
 See the [Feishu Configuration](#feishu-configuration) section below.
 
@@ -205,7 +224,26 @@ opencode AI (Sisyphus)
 
 下次启动 opencode 时会自动拉取并安装。
 
-#### 第二步：配置需要使用的渠道
+#### 第二步：选择要启用的渠道
+
+在 `~/.config/opencode/.env` 中配置 `CHAT_CHANNELS`，指定要开启哪些渠道：
+
+```bash
+# ~/.config/opencode/.env
+
+# 只开启飞书（初始推荐）
+CHAT_CHANNELS=feishu
+
+# 同时开启多个渠道
+# CHAT_CHANNELS=feishu,wecom
+
+# 留空或不配置 = 自动模式：凭证存在的渠道自动启用
+# CHAT_CHANNELS=
+```
+
+然后配置对应渠道的凭证（见下方各渠道配置说明）。
+
+#### 第三步：配置渠道凭证
 
 参见下方各渠道的配置说明。
 

package/dist/index.d.ts

@@ -1,19 +1,21 @@
 /**
  * opencode-chat-channel — opencode 多渠道机器人插件
  *
- * 支持多个即时通讯渠道同时运行，每个渠道独立处理消息。
- * 当前已实现：飞书（Feishu/Lark）
- * 骨架已创建：企业微信（WeCom）
+ * 通过 .env 文件中的 CHAT_CHANNELS 配置项选择启用哪些渠道：
  *
- * 凭证加载：
- *   FEISHU_APP_ID 等非敏感凭证存放在 ~/.config/opencode/.env
- *   敏感凭证存放在 macOS Keychain（各渠道独立 service/account）
+ *   CHAT_CHANNELS=feishu          # 只启用飞书
+ *   CHAT_CHANNELS=feishu,wecom    # 同时启用飞书和企业微信
+ *   CHAT_CHANNELS=                # 留空：自动探测（凭证存在即启用）
+ *   # 不配置此项：同留空，自动探测
  *
- * 每个渠道用户独享一个 opencode session，对话历史保留 2 小时。
+ * 其他配置项：
+ *   OPENCODE_BASE_URL   opencode API 地址（默认 http://localhost:4321）
+ *
+ * 各渠道的凭证配置详见 README。
  */
 import type { Plugin } from "@opencode-ai/plugin";
 export declare const ChatChannelPlugin: Plugin;
 export default ChatChannelPlugin;
-export type { ChatChannel, ChannelFactory, IncomingMessage, PluginClient } from "./types.js";
+export type { ChatChannel, ChannelFactory, ChannelName, IncomingMessage, PluginClient } from "./types.js";
 export { SessionManager, extractResponseText, loadDotEnv } from "./session-manager.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAgGlD,eAAO,MAAM,iBAAiB,EAAE,MAoE/B,CAAC;AAEF,eAAe,iBAAiB,CAAC;AAGjC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAgIlD,eAAO,MAAM,iBAAiB,EAAE,MAyF/B,CAAC;AAEF,eAAe,iBAAiB,CAAC;AAGjC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -261,11 +261,32 @@ var wecomChannelFactory = async (client) => {
 };
 
 // src/index.ts
-var OPENCODE_BASE_URL = process.env["OPENCODE_BASE_URL"] ?? "http://localhost:4321";
-var CHANNEL_FACTORIES = [
-  feishuChannelFactory,
-  wecomChannelFactory
-];
+var CHANNEL_REGISTRY = {
+  feishu: feishuChannelFactory,
+  wecom: wecomChannelFactory
+};
+function resolveEnabledChannels(client) {
+  const raw = process.env["CHAT_CHANNELS"]?.trim();
+  if (!raw)
+    return null;
+  const requested = raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const known = Object.keys(CHANNEL_REGISTRY);
+  const enabled = [];
+  for (const name of requested) {
+    if (known.includes(name)) {
+      enabled.push(name);
+    } else {
+      client.app.log({
+        body: {
+          service: "chat-channel",
+          level: "warn",
+          message: `[config] 未知渠道名 "${name}"，已忽略。可用渠道：${known.join(", ")}`
+        }
+      });
+    }
+  }
+  return enabled;
+}
 function createMessageHandler(channel, sessionManager, client) {
   return async (msg) => {
     const { userId, replyTarget, text } = msg;
@@ -313,18 +334,30 @@ function createMessageHandler(channel, sessionManager, client) {
 var ChatChannelPlugin = async ({ client }) => {
   const configDir = join(process.env["HOME"] ?? `/Users/${process.env["USER"] ?? "unknown"}`, ".config", "opencode");
   loadDotEnv(join(configDir, ".env"));
+  const enabledNames = resolveEnabledChannels(client);
+  const factories = enabledNames ? enabledNames.map((name) => [name, CHANNEL_REGISTRY[name]]) : Object.entries(CHANNEL_REGISTRY);
+  if (enabledNames) {
+    await client.app.log({
+      body: {
+        service: "chat-channel",
+        level: "info",
+        message: `[config] CHAT_CHANNELS="${process.env["CHAT_CHANNELS"]}"，将启用: ${enabledNames.join(", ") || "（无）"}`
+      }
+    });
+  }
   const channels = [];
-  for (const factory of CHANNEL_FACTORIES) {
+  for (const [, factory] of factories) {
     const channel = await factory(client);
     if (channel)
       channels.push(channel);
   }
   if (channels.length === 0) {
+    const hint = enabledNames ? `检查 CHAT_CHANNELS="${process.env["CHAT_CHANNELS"]}" 指定的渠道是否已配置凭证` : "请在 .env 中配置至少一个渠道的凭证，或设置 CHAT_CHANNELS=<渠道名> 明确指定";
     await client.app.log({
       body: {
         service: "chat-channel",
         level: "warn",
-        message: "所有渠道均未就绪（凭证缺失或未配置），插件空启动。"
+        message: `所有渠道均未就绪，插件空启动。${hint}`
       }
     });
     return {};

package/dist/types.d.ts

@@ -49,4 +49,9 @@ export interface ChatChannel {
  * 若凭证未配置，应返回 null（插件将跳过该渠道并记录日志）。
  */
 export type ChannelFactory = (client: PluginClient) => Promise<ChatChannel | null>;
+/**
+ * 已注册的渠道名称。
+ * 新增渠道时在此处添加对应字面量，便于编译期检查。
+ */
+export type ChannelName = "feishu" | "wecom";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAI3D,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;;OAGG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,kBAAkB;IAClB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,YAAY,KACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAI3D,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;;OAGG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,kBAAkB;IAClB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,YAAY,KACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAIjC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-chat-channel",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "opencode plugin — multi-channel bot (Feishu/Lark, WeCom) with extensible ChatChannel interface",
   "type": "module",
   "main": "./dist/index.js",