@fengming-gh/oc-wechat-bridge 1.0.6 → 1.0.7

package/README.md

@@ -1,32 +1,102 @@
-# @fengming-gh/oc-wechat-bridge
-
-WeChat ↔ OpenCode 双向桥接插件。
-
-基于微信官方 iLink Bot API 开发，非逆向/非破解。支持流式输出、跨会话转发、自动续命、子 AI 延续追踪。
-
-## 安装
-
-在 `opencode.json` 中添加：
-
-```json
-{
-  "plugin": ["@fengming-gh/oc-wechat-bridge"]
-}
-```
-
-重启 OC 后浏览器自动弹出微信二维码，扫码登录即可使用。
-
-## 功能
-
-- 微信消息 → OC 会话：在微信中发送消息，AI 自动回复推回微信
-- 流式输出：思考、工具调用、文字实时推送
-- `/switch` 切换绑定会话、`/rename` 改名、`/status` 查看状态
-- 内置跨会话转发与自动续命能力
-
-## 要求
-
-- OpenCode ≥ 1.15.10
-
-## 许可
-
-MIT
+# oc-wechat-bridge
+
+微信 ↔ OpenCode 双向桥接插件。在微信中直接与 OC AI 对话，接收实时进度、切换会话。集成跨会话转发与自动续命。
+
+## 功能
+
+- **双向消息**：微信↔OC 消息实时互通，AI 回复自动转发到微信
+- **流式输出**：AI 思考、工具调用、回复文字实时推送微信，不等完整回复
+- **多项目目录**：自动发现同级带 `.opencode/` 的项目，会话按目录分组显示
+- **会话管理**：全局编号 `/switch` 跨目录切换、`/status` 查看全貌
+
+- **自动恢复**：AI 出错或上下文压缩后自动重试，微信端无感（集成了 [oc-auto-continue](https://github.com/Fengming-GH/oc-auto-continue)）
+- **跨会话转发**：AI 可通过 `！` 指令将消息转发到其他会话（集成了 [oc-forward](https://github.com/Fengming-GH/oc-forward)）
+- **消息不阻塞**：`promptAsync` 注射消息后立即返回，AI 处理期间仍可接收新消息
+
+## 安装
+
+### 通过 npm 安装
+
+在项目根目录的 `opencode.json` 中添加：
+
+```json
+{
+  "plugin": ["@fengming-gh/oc-wechat-bridge"]
+}
+```
+
+重启 OC 后自动加载。无需手动 `npm install`。
+
+### 复制文件安装
+
+将 `src/index.ts` 复制到 OC 项目的 `.opencode/plugins/` 目录下：
+
+```bash
+cp src/index.ts 你的项目/.opencode/plugins/wechat-bridge.ts
+```
+
+重启 OC，首次启动弹出二维码，微信扫码登录。无需 `npm install`，插件零外部运行时依赖。
+
+## 指令
+
+所有指令通过微信发送给 Bot，以 `/` 开头。中英文别名均可识别。
+
+| 指令 | 别名 | 功能 |
+|------|------|------|
+| `/stop` | `/停止` | 中断 AI 任务 |
+| `/status` | `/状态` / `/会话` | 查看所有目录和会话 |
+| `/switch N` | `/切换 N` | 切换到指定会话并绑定 |
+| `/new [N]` | `/新建 [N]` | 创建新会话 |
+| `/unbind` | `/解绑` | 解绑当前会话 |
+| `/rename <标题>` | `/改名 <标题>` | 修改会话标题 |
+| `/mode` | `/模式` | 查看当前会话模式（只读） |
+| `/help` | `/帮助` | 显示指令列表 |
+
+**无空格参数：** `/switch3` 与 `/switch 3` 等价。
+
+## AI 工具 / 跨会话指令
+
+AI 对话中支持以下操作：
+
+| 输入 | 说明 |
+|------|------|
+| `！会话` 或 `!sessions` | AI 调用 `list_sessions` 列出所有会话 |
+| `！<前缀> <消息>` 或 `!<前缀> <消息>` | AI 调用 `forward_to_session` 转发消息到目标会话 |
+
+`！`（全角）和 `!`（半角）都支持。
+
+## 进度与格式
+
+AI 处理时微信实时收到：
+
+```
+思考中...       ← 推理进度
+read            ← 工具调用
+edit
+好的……         ← AI 回复文字
+```
+
+会话列表按目录分组，带空行分隔：
+
+```
+📁 项目A — 3 个会话
+  1. 📱WeChat插件 [当前会话]
+  2. 微信测试
+  3. 改造计划审查
+
+📁 项目B — 1 个会话
+  4. 编译 4.1 版本
+```
+
+## 技术栈
+
+- 单文件 TypeScript（~740 行）
+- 零外部运行时依赖（仅 Node 内置模块）
+- 基于微信官方 iLink Bot API 开发，非逆向/非破解
+- 原生 Web Fetch API
+- AES-128-ECB 加密传输（CDN 媒体文件）
+- 事件驱动架构（`message.part.updated` / `session.idle` 等）
+
+## 许可
+
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fengming-gh/oc-wechat-bridge",
-  "version": "1.0.6",
-  "description": "将微信消息桥接到 OpenCode，支持双向对话与权限审批",
+  "version": "1.0.7",
+  "description": "将微信消息桥接到 OpenCode，支持双向对话、会话管理、跨会话转发",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -20,10 +20,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.0.0",
-    "@opencode-ai/sdk": ">=1.0.0"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Fengming-GH/oc-wechat-bridge.git"
@@ -31,5 +27,5 @@
   "bugs": {
     "url": "https://github.com/Fengming-GH/oc-wechat-bridge/issues"
   },
-  "homepage": "https://github.com/Fengming-GH/oc-wechat-bridge#readme"
+  "homepage":     "https://github.com/Fengming-GH/oc-wechat-bridge#readme"
 }

package/src/index.ts

@@ -1,5 +1,6 @@
 // ============================================================
 // oc-wechat-bridge: 将微信消息桥接到 OpenCode
+// 本插件用于 OpenCode WIN平台 桌面端，实现打通微信和 OpenCode  会话。最多允许一个微信在同一时刻绑定一个会话，允许微信切换会话。
 // ============================================================
 
 import type { Plugin } from "@opencode-ai/plugin"
@@ -56,6 +57,7 @@ const sidTitle = new Map<string, string>()
 const wechatSid = new Map<string, string>()
 const _pendingFirstContact = new Set<string>()
 let _projectDirs: string[] = []
+let _worktree = ""
 const _modeCache = new Map<string, string>()
 
 const _thinkingSent = new Set<string>()
@@ -68,7 +70,7 @@ const _compacted = new Set<string>()
 
 function enqueueSend(sid: string, fn: () => Promise<void>) {
   const prev = _fwdQueue.get(sid) ?? Promise.resolve()
-  _fwdQueue.set(sid, prev.then(() => fn(), () => fn()))
+  _fwdQueue.set(sid, prev.then(() => fn()).catch(() => {}))
 }
 
 // ============================================================
@@ -141,7 +143,7 @@ function buildCdnUploadUrl(uploadParam: string, filekey: string): string {
 function initSessionCache(client: any) {
   setTimeout(async () => {
     try {
-      const { flat } = await listAllSessions(client)
+      const { flat } = await _listSessionsByDirs(client, _projectDirs)
       for (const s of flat) sidTitle.set(s.id, s.title)
       log("INIT", `cached ${sidTitle.size} sessions`)
     } catch (err) {
@@ -230,18 +232,6 @@ async function getOrCreateSession(client: any, wechatId: string, _worktree: stri
       return sid
     }
   } catch (err) { log("SESSION_CREATE_FAIL", `${err}`) }
-  try {
-    const resp: any = await client.session.list()
-    const all: Session[] = Array.isArray(resp) ? resp : resp.data ?? []
-    const first = all.find((s: Session) => !s.parentID)
-    if (first) {
-      wechatSid.set(wechatId, first.id)
-      sidTitle.set(first.id, first.title)
-      await updateSessionIcon(client, first.id, "normal")
-      saveState()
-      return first.id
-    }
-  } catch { /* best effort */ }
   throw new Error("No available session")
 }
 
@@ -311,7 +301,7 @@ function loadCredentials(): WechatCredentials | null {
 function saveCredentials(cred: WechatCredentials) {
   ensureDataDir()
   const tmp = CREDENTIALS_FILE + ".tmp"
-  try { writeFileSync(tmp, JSON.stringify(cred, null, 2), "utf-8"); renameSync(tmp, CREDENTIALS_FILE) } catch (e) { log("CRED_WRITE_ERR", `${e}`) }
+  try { writeFileSync(tmp, JSON.stringify(cred, null, 2), "utf-8"); renameSync(tmp, CREDENTIALS_FILE) } catch (e) { log("CRED_WRITE_ERR", `${e}`) } finally { try { rmSync(tmp) } catch { } }
 }
 
 async function validateCredentials(cred: WechatCredentials): Promise<string | null> {
@@ -338,7 +328,7 @@ function saveState() {
   for (const [wx, sid] of wechatSid) { if (wx.endsWith("@im.wechat")) sm[wx] = sid }
   const state: any = { syncBuf: syncBuffer, contextTokens: ct }
   if (Object.keys(sm).length) state.sessionMap = sm
-  try { writeFileSync(tmp, JSON.stringify(state), "utf-8"); renameSync(tmp, STATE_FILE) } catch (e) { log("STATE_WRITE_ERR", `${e}`) }
+  try { writeFileSync(tmp, JSON.stringify(state), "utf-8"); renameSync(tmp, STATE_FILE) } catch (e) { log("STATE_WRITE_ERR", `${e}`) } finally { try { rmSync(tmp) } catch { } }
 }
 function loadState() {
   try {
@@ -478,7 +468,7 @@ async function processInboundMessage(raw: any, account: WechatCredentials, clien
   recentMessageKeys.add(msgKey); recentMessageOrder.push(msgKey)
   while (recentMessageOrder.length > RECENT_KEYS_MAX) recentMessageKeys.delete(recentMessageOrder.shift()!)
   const senderId = raw.from_user_id ?? "unknown"
-  if (raw.context_token) { contextTokens.set(senderId, raw.context_token); saveState() }
+  if (raw.context_token && contextTokens.get(senderId) !== raw.context_token) { contextTokens.set(senderId, raw.context_token); saveState() }
   const downloadedPaths: string[] = []
   for (const att of attachments) {
     try { const enc = await downloadFromCdn(att.media); const pt = decryptInboundMediaPayload(enc, att.aesKey); downloadedPaths.push(saveAttachment(att.fileName || `wechat-${att.kind}`, pt)) }
@@ -529,11 +519,11 @@ function saveAttachment(fileName: string, data: Buffer): string {
 function resolveDir(dirIdx: number | null, worktree: string): string { return (!dirIdx || dirIdx < 1 || dirIdx > _projectDirs.length) ? worktree : _projectDirs[dirIdx - 1] }
 function getNick(dir: string): string { const n = basename(dir); return n || dir }
 
-async function listAllSessions(client: any): Promise<{ flat: Session[]; dirMap: Map<string, number> }> {
+async function _listSessionsByDirs(client: any, dirs: string[]): Promise<{ flat: Session[]; dirMap: Map<string, number> }> {
   const flat: Session[] = []; const dm = new Map<string, number>()
-  for (let di = 0; di < _projectDirs.length; di++) {
+  for (let di = 0; di < dirs.length; di++) {
     try {
-      const resp: any = await client.session.list({ query: { directory: _projectDirs[di] } })
+      const resp: any = await client.session.list({ query: { directory: dirs[di] } })
       const all: Session[] = Array.isArray(resp) ? resp : resp.data ?? []
       for (const s of all) { if (!s.parentID) { flat.push(s); dm.set(s.id, di) } }
     } catch { /* skip */ }
@@ -541,6 +531,11 @@ async function listAllSessions(client: any): Promise<{ flat: Session[]; dirMap:
   return { flat, dirMap: dm }
 }
 
+async function listAllSessions(client: any): Promise<{ flat: Session[]; dirMap: Map<string, number> }> {
+  _projectDirs = findProjectDirs(_worktree)
+  return _listSessionsByDirs(client, _projectDirs)
+}
+
 function formatDirSessions(flat: Session[], dm: Map<string, number>, cur: string | undefined): string[] {
   const lines: string[] = []; let idx = 0
   for (let di = 0; di < _projectDirs.length; di++) {
@@ -552,9 +547,9 @@ function formatDirSessions(flat: Session[], dm: Map<string, number>, cur: string
   return lines
 }
 
-async function formatSessionGuide(client: any, cur: string | undefined): Promise<string> {
+async function formatSessionGuide(client: any, cur: string | undefined, prefetched?: { flat: Session[]; dirMap: Map<string, number> }): Promise<string> {
   try {
-    const { flat, dirMap: dm } = await listAllSessions(client)
+    const { flat, dirMap: dm } = prefetched ?? await listAllSessions(client)
     const sl = formatDirSessions(flat, dm, cur)
     return (sl.length ? sl.join("\n") : "(无会话)") + "\n回复 /switch <编号> 切换"
   } catch { return "获取会话列表失败" }
@@ -576,13 +571,14 @@ async function handleCommand(cmd: string, senderId: string, account: WechatCrede
         if (pv && pv !== m.id) { const pt = flat.find(s => s.id === pv)?.title; await stripSessionIcon(client, pv, pt) }
         await updateSessionIcon(client, m.id, "normal"); await wx(`已切换到: ${m.title}`) } catch { await wx("切换失败") }; break }
     case "unbind": case "解绑": { const old = wechatSid.get(senderId)
+      let fetched: { flat: Session[]; dirMap: Map<string, number> } | undefined
       let oldTitle = sidTitle.get(old)
       if (old) {
-        try { const { flat } = await listAllSessions(client); const found = flat.find(s => s.id === old); if (found) oldTitle = found.title } catch { /* */ }
-        if (oldTitle && ICON_PREFIXES.some(p => oldTitle.startsWith(p))) { await stripSessionIcon(client, old, oldTitle) }
+        try { fetched = await listAllSessions(client); const found = fetched.flat.find(s => s.id === old); if (found) oldTitle = found.title } catch { /* */ }
         wechatSid.delete(senderId); saveState()
+        if (oldTitle && ICON_PREFIXES.some(p => oldTitle.startsWith(p))) { await stripSessionIcon(client, old, oldTitle) }
       }
-      await wx(`WeChat 桥接\n${await formatSessionGuide(client, undefined)}`); break }
+      await wx(`WeChat 桥接\n${await formatSessionGuide(client, undefined, fetched)}`); break }
     case "rename": case "改名": { const nn = args.join(" ").trim(); if (!nn) { await wx("请指定标题"); break }; const sid = wechatSid.get(senderId); if (!sid) { await wx("未绑定"); break }
       try { await client.session.update({ path: { id: sid }, body: { title: nn } }); sidTitle.set(sid, nn); await updateSessionIcon(client, sid, "normal"); await wx(`已改名: ${t(sid)}`) } catch { await wx("改名失败") }; break }
     case "mode": case "模式": { const sid = wechatSid.get(senderId); if (!sid) { await wx("未绑定"); break }
@@ -670,7 +666,7 @@ export const WechatBridgePlugin: Plugin = async ({ client, worktree }) => {
   try { await client.app.log({ body: { service: "wechat-bridge", level: "info", message: "plugin loaded" } }) } catch { /* */ }
   migrateOldDataDir()
   migrateOldStateFiles(worktree)
-  _projectDirs = findProjectDirs(worktree)
+  _projectDirs = findProjectDirs(worktree); _worktree = worktree
   initSessionCache(client)
   loadState()
   const abortController = new AbortController()
@@ -679,13 +675,7 @@ export const WechatBridgePlugin: Plugin = async ({ client, worktree }) => {
     event: createEventHandler(client),
     "permission.ask": createPermissionHandler(client),
     "experimental.chat.system.transform": async (_input: any, output: { system: string[] }) => {
-      try {
-        const { flat, dirMap } = await listAllSessions(client)
-        if (flat.length === 0) return
-        const sl = formatDirSessions(flat, dirMap, undefined)
-        const lines = ["当前可用的会话：", ...sl, "", "用户输入以 ！ 或 ! 开头的消息时，这是跨会话指令：", "  - ！会话 或 !sessions → 调用 list_sessions 工具", "  - ！<前缀> <消息> 或 !<前缀> <消息> → 调用 forward_to_session 工具转发"]
-        output.system.push(lines.join("\n"))
-      } catch { /* best effort */ }
+      output.system.push("用户输入以 ！ 或 ! 开头的消息时，这是跨会话指令：\n  - ！会话 或 !sessions → 调用 list_sessions 工具\n  - ！<前缀> <消息> 或 !<前缀> <消息> → 调用 forward_to_session 工具转发\n\n注意：list_sessions 工具返回的内容包含 ``` 代码块，这是数据格式的一部分，删除代码块会导致数据损坏，必须一字不差地输出。")
     },
     tool: createTools(client),
   }
@@ -706,7 +696,6 @@ function createEventHandler(client: any) {
       await updateSessionIcon(client, sid, "normal")
       try { const resp: any = await client.session.messages({ path: { id: sid }, query: { limit: 15 } }); const msgs = Array.isArray(resp) ? resp : resp.data ?? []
         for (let i = msgs.length - 1; i >= 0; i--) { if (msgs[i].info?.role === "assistant") { if (msgs[i].info.mode) _modeCache.set(sid, msgs[i].info.mode); break } } } catch { /* */ }
-      _thinkingSent.delete(sid)
       if (_pendingContinue.has(sid)) { _pendingContinue.delete(sid); try { await client.session.prompt({ path: { id: sid }, body: { parts: [{ type: "text" as any, text: "检测到异常，请继续" }] } }) } catch { } }
       if (_compacted.has(sid)) { _compacted.delete(sid); try { await client.session.prompt({ path: { id: sid }, body: { parts: [{ type: "text" as any, text: "上下文被压缩" }] } }) } catch { } }
       return
@@ -741,9 +730,9 @@ function createTools(client: any) {
         if (!_creds) return { output: "微信桥接尚未完成登录" }
         return { output: [`微信账户: ${_creds.accountId}`, `绑定用户: ${_creds.userId ?? "(无)"}`, `会话缓存: ${sidTitle.size} 个`, `上下文令牌: ${contextTokens.size} 个`, `同步游标: ${syncBuffer ? "存在" : "无"}`, `数据目录: ${DATA_DIR}`].join("\n") }
       } }),
-    list_sessions: tool({ description: "列出所有可用会话的标题和 ID", args: {},
+    list_sessions: tool({ description: "列出所有可用会话的标题和 ID。调用后带 ``` 代码块原样输出，删除代码块会破坏数据格式，必须保留。", args: {},
       execute: async (_args: any, ctx: any) => {
-        try { const { flat, dirMap } = await listAllSessions(client); if (flat.length === 0) return { output: "暂无会话" }; return { output: formatDirSessions(flat, dirMap, ctx?.sessionID).join("\n") } } catch { return { output: "获取会话列表失败" } }
+        try { const { flat, dirMap } = await listAllSessions(client); if (flat.length === 0) return { output: "暂无会话" }; const body = formatDirSessions(flat, dirMap, ctx?.sessionID).join("\n"); return { output: "```\n" + body + "\n```" } } catch { return { output: "获取会话列表失败" } }
       } }),
     forward_to_session: tool({ description: "转发消息到标题前缀匹配的会话。用户说「转发」时使用此工具", args: { prefix: tool.schema.string().describe("目标会话标题前缀"), message: tool.schema.string().describe("要转发的消息内容") },
       execute: async (args: any, ctx: any) => {