@unlinearity/cli-wechat-bridge 1.0.7 → 1.0.9

package/README.md

@@ -10,7 +10,7 @@
   <a href="https://www.npmjs.com/package/cli-wechat-bridge"><img alt="npm downloads" src="https://img.shields.io/npm/dm/cli-wechat-bridge?label=Downloads&amp;style=for-the-badge&amp;logo=npm&amp;color=16a34a&amp;labelColor=1c1917"></a>
   <a href="https://www.npmjs.com/package/@unlinearity/cli-wechat-bridge"><img alt="scoped npm downloads" src="https://img.shields.io/npm/dm/@unlinearity/cli-wechat-bridge?label=Scoped%20downloads&amp;style=for-the-badge&amp;logo=npm&amp;color=15803d&amp;labelColor=1c1917"></a>
   <a href="https://www.npmjs.com/package/cli-wechat-bridge">
-  <img alt="License" src="https://img.shields.io/npm/l/cli-wechat-bridge?label=License&style=for-the-badge&color=7c3aed&labelColor=1c1917">
+  <img alt="License" src="https://img.shields.io/badge/License-AGPL--3.0-7c3aed?style=for-the-badge&labelColor=1c1917">
 </a>
 </p>
 
@@ -305,9 +305,44 @@ wechat-claude-start --model sonnet --dangerously-skip-permissions
 | `/new` 或 `/new-session` | OpenCode 模式下新建 session |
 | `/confirm` / `/deny` | 处理 CLI 权限请求；需要一次性 code 的请求会在消息中提示具体确认格式 |
 | `/daemon-stop` | daemon 模式下停止常驻进程 |
+| `/bindings` | 查看当前所有表情绑定 |
+| `/bind [表情] /命令` | 绑定表情到指定命令 |
+| `/unbind [表情]` | 解除指定表情的绑定 |
 
 说明：微信侧 `/resume` 目前暂时保持禁用；需要切换 Codex / Claude / OpenCode 会话时，优先在本地 companion 中使用原生 `/resume`、`/new` 或对应 CLI 命令，微信会跟随本地活动会话。
 
+### 表情绑定
+
+Daemon 模式支持将微信表情映射为命令，在微信中发送表情即可快速触发操作。（不过注意，第一次启动相关cli的时候，最好不要带消息，等启动完成再“表情+文本”快速给指定 cli 发送消息。
+
+![表情触发](docs/images/image-10.png)
+
+**默认绑定：**
+
+| 表情 | 命令 | 说明 |
+| --- | --- | --- |
+| `[OK]` | `/confirm` | 批准权限请求 |
+| `[闭嘴]` | `/stop` | 中断当前任务 |
+| `[拥抱]` | `/claude` | 切换到 Claude Code |
+| `[强]` | `/codex` | 切换到 Codex |
+| `[胜利]` | `/opencode` | 切换到 OpenCode |
+| `[再见]` | `/daemon-stop` | 停止 daemon |
+
+**管理命令：**
+
+```
+/bindings              查看当前所有绑定
+/bind [表情] /命令     绑定表情到命令，如 /bind [微笑] /status
+/unbind [表情]         解除绑定，如 /unbind [微笑]
+```
+
+**触发规则：**
+
+- 表情必须出现在消息开头才会触发（如 `[OK]` 触发，`你好[OK]` 不触发）；
+- 如果表情后面还有文本（如 `[拥抱]帮我写个脚本`），会先执行命令再将剩余文本作为消息转发；
+- 大小写不敏感（`[OK]` 和 `[ok]` 等价）；
+- 修改后立即生效并持久化到 `~/.cli-bridge/emoji-bindings.json`，重启 daemon 后保留。
+
 ## 工作区模型
 
 本项目采用“当前目录即当前工作区”的模型：
@@ -390,7 +425,19 @@ npm install -g cli-wechat-bridge@latest
 
 ## License
 
-[MIT](LICENSE.txt)
+本项目采用**双协议**授权：
+
+**开源协议：[AGPL-3.0](LICENSE.txt)**
+
+- 个人使用、学习、研究：完全免费
+- 修改和衍生作品必须以相同协议（AGPL-3.0）开源
+- 通过网络提供基于本项目的服务，也必须公开完整源代码
+
+**商业授权**
+
+如果你希望在闭源商业产品中使用本项目（不公开你的源代码），需要获得商业许可。请联系作者获取商业授权方案：
+
+- GitHub: [@UNLINEARITY](https://github.com/UNLINEARITY)
 
 <p align="center">
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=UNLINEARITY/CLI-WeChat-Bridge&type=timeline&legend=top-left">

package/dist/bridge/bridge-adapters.claude.js

@@ -200,6 +200,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         this.pendingCliApprovalHints = null;
         this.flushPendingClaudeHookApprovals();
         this.writeToPty("\u0003");
+        this.scheduleTaskComplete(shared.INTERRUPT_SETTLE_DELAY_MS);
         return true;
     }
     async reset() {
@@ -566,6 +567,9 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         }
         return `${CLAUDE_BRACKETED_PASTE_START}${normalizedText}${CLAUDE_BRACKETED_PASTE_END}`;
     }
+    // Fallback heuristic for older Claude Code versions that lack PostCompact hooks.
+    // The structured PostCompact hook event (handled in handleClaudeHookEnvelope) is
+    // the reliable signal; this regex match serves as a best-effort fallback.
     shouldTreatClaudeOutputAsCompactCompletion(text) {
         if (this.state.status !== "busy" &&
             this.state.status !== "awaiting_approval" &&
@@ -695,6 +699,10 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
                 this.handleClaudeStopFailure(payload);
                 this.respondToClaudeHook(params.socket, params.requestId);
                 return;
+            case "PostCompact":
+                this.completeClaudeCompact();
+                this.respondToClaudeHook(params.socket, params.requestId);
+                return;
             default:
                 this.respondToClaudeHook(params.socket, params.requestId);
                 return;

package/dist/bridge/bridge-adapters.codex.js

@@ -495,9 +495,27 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             this.sessionPartialLine = "";
             this.seedSessionReplayCutoff(startedAtMs);
         }
-        let content;
+        let chunk;
         try {
-            content = fs.readFileSync(this.sessionFilePath, "utf8");
+            const stat = fs.statSync(this.sessionFilePath);
+            if (stat.size < this.sessionReadOffset) {
+                this.sessionReadOffset = 0;
+                this.sessionPartialLine = "";
+            }
+            if (stat.size === this.sessionReadOffset) {
+                return;
+            }
+            const fd = fs.openSync(this.sessionFilePath, "r");
+            try {
+                const bytesToRead = stat.size - this.sessionReadOffset;
+                const buf = Buffer.alloc(bytesToRead);
+                fs.readSync(fd, buf, 0, bytesToRead, this.sessionReadOffset);
+                chunk = buf.toString("utf8");
+                this.sessionReadOffset = stat.size;
+            }
+            finally {
+                fs.closeSync(fd);
+            }
         }
         catch {
             this.sessionFilePath = null;
@@ -505,15 +523,6 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             this.sessionPartialLine = "";
             return;
         }
-        if (content.length < this.sessionReadOffset) {
-            this.sessionReadOffset = 0;
-            this.sessionPartialLine = "";
-        }
-        if (content.length === this.sessionReadOffset) {
-            return;
-        }
-        const chunk = content.slice(this.sessionReadOffset);
-        this.sessionReadOffset = content.length;
         const lines = `${this.sessionPartialLine}${chunk}`.split(/\r?\n/);
         this.sessionPartialLine = lines.pop() ?? "";
         for (const line of lines) {
@@ -1627,10 +1636,14 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         const requestId = ++this.rpcRequestCounter;
         const requestKey = this.rpcRequestKey(requestId);
         const responsePromise = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRpcRequests.delete(requestKey);
+                reject(new Error(`Codex RPC request timed out after 30s (method: ${method})`));
+            }, 30_000);
             this.pendingRpcRequests.set(requestKey, {
                 method,
-                resolve,
-                reject,
+                resolve: (value) => { clearTimeout(timer); resolve(value); },
+                reject: (err) => { clearTimeout(timer); reject(err); },
             });
         });
         try {

package/dist/bridge/bridge-adapters.core.js

@@ -294,6 +294,7 @@ export class LocalCompanionProxyAdapter {
         }
     }
     detachPanelSocket() {
+        this.rejectPendingRequests("Companion socket disconnected unexpectedly.");
         this.detachMessageListener?.();
         this.detachMessageListener = null;
         if (this.socket) {
@@ -393,7 +394,14 @@ export class LocalCompanionProxyAdapter {
         }
         const id = `${++this.requestCounter}`;
         const response = new Promise((resolve, reject) => {
-            this.pendingRequests.set(id, { resolve, reject });
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`${this.options.kind} companion request timed out after 30s (command: ${payload.command})`));
+            }, 30_000);
+            this.pendingRequests.set(id, {
+                resolve: (value) => { clearTimeout(timer); resolve(value); },
+                reject: (err) => { clearTimeout(timer); reject(err); },
+            });
         });
         sendLocalCompanionMessage(socket, {
             type: "request",
@@ -588,15 +596,21 @@ export class AbstractPtyAdapter {
             return;
         }
         this.shuttingDown = true;
+        const pty = this.pty;
+        this.pty = null;
+        this.state.status = "stopped";
+        this.state.pid = undefined;
         try {
-            this.pty.kill();
+            const exitPromise = new Promise((resolve) => {
+                const timeout = setTimeout(resolve, 3_000);
+                pty.onExit(() => { clearTimeout(timeout); resolve(); });
+            });
+            pty.kill();
+            await exitPromise;
         }
         catch {
             // Best effort shutdown.
         }
-        this.pty = null;
-        this.state.status = "stopped";
-        this.state.pid = undefined;
     }
     getState() {
         return JSON.parse(JSON.stringify(this.state));

package/dist/bridge/bridge-adapters.opencode.js

@@ -285,21 +285,25 @@ export class OpenCodeServerAdapter {
         if (this.nativeProcess) {
             const proc = this.nativeProcess;
             this.nativeProcess = null;
-            try {
-                killProcessTreeSync(proc.pid);
-            }
-            catch {
-                // Best effort.
+            if (proc.pid != null) {
+                try {
+                    killProcessTreeSync(proc.pid);
+                }
+                catch {
+                    // Best effort.
+                }
             }
         }
         if (this.serverProcess) {
             const proc = this.serverProcess;
             this.serverProcess = null;
-            try {
-                killProcessTreeSync(proc.pid);
-            }
-            catch {
-                // Best effort.
+            if (proc.pid != null) {
+                try {
+                    killProcessTreeSync(proc.pid);
+                }
+                catch {
+                    // Best effort.
+                }
             }
         }
         this.client = null;

package/dist/bridge/bridge-process-reaper.js

@@ -328,9 +328,14 @@ export function killProcessTreeSync(pid) {
     }
     else {
         try {
-            process.kill(pid);
+            process.kill(-pid);
+        }
+        catch {
+            try {
+                process.kill(pid);
+            }
+            catch { /* best effort */ }
         }
-        catch { /* best effort */ }
     }
 }
 export async function reapPeerBridgeProcesses(params = {}) {

package/dist/bridge/bridge-utils.js

@@ -268,8 +268,8 @@ function formatPromptByteSize(bytes) {
 }
 function formatWechatInboundAttachmentPrompt(attachments) {
     const lines = [
-        "[WeChat inbound attachments]",
-        "The user sent attachment files through WeChat. They have been saved locally. Read the local paths directly if the user's request requires inspecting them.",
+        "[WeChat inbound attachments — ACTION REQUIRED]",
+        "The user sent the following files through WeChat. You MUST use the Read tool to read each file path below BEFORE responding. Do NOT skip reading these files — the user expects you to see their content (including images).",
     ];
     attachments.forEach((attachment, index) => {
         const sizeText = formatPromptByteSize(attachment.sizeBytes);
@@ -280,6 +280,8 @@ function formatWechatInboundAttachmentPrompt(attachments) {
         ].filter(Boolean);
         lines.push(`${index + 1}. ${metadata.join(" ")} path=${attachment.path}`);
     });
+    lines.push("");
+    lines.push("Remember: Read each path above with the Read tool NOW. Images are viewable via Read.");
     return lines.join("\n");
 }
 export function buildWechatInboundPrompt(text, attachments = []) {

package/dist/bridge/claude-hooks.js

@@ -71,6 +71,11 @@ export function buildClaudeHookSettings(command) {
             ],
             Stop: [hook],
             StopFailure: [hook],
+            PreToolUse: [hook],
+            PostToolUse: [hook],
+            PreCompact: [hook],
+            PostCompact: [hook],
+            SubagentStop: [hook],
         },
     };
 }

package/dist/companion/local-companion-link.js

@@ -210,10 +210,16 @@ export function sendLocalCompanionMessage(socket, message) {
         return false;
     }
 }
+const MAX_IPC_BUFFER_SIZE = 1_048_576; // 1MB
 export function attachLocalCompanionMessageListener(socket, onMessage) {
     let buffer = "";
     const onData = (chunk) => {
         buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+        if (buffer.length > MAX_IPC_BUFFER_SIZE) {
+            socket.destroy(new Error("IPC buffer overflow: exceeded 1MB without complete frame"));
+            buffer = "";
+            return;
+        }
         while (true) {
             const newlineIndex = buffer.indexOf("\n");
             if (newlineIndex < 0) {

package/dist/daemon/daemon-link.js

@@ -80,10 +80,16 @@ export function sendDaemonResponse(socket, id, response) {
         return false;
     }
 }
+const MAX_IPC_BUFFER_SIZE = 1_048_576; // 1MB
 export function attachDaemonRequestListener(socket, onRequest) {
     let buffer = "";
     const onData = (chunk) => {
         buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+        if (buffer.length > MAX_IPC_BUFFER_SIZE) {
+            socket.destroy(new Error("IPC buffer overflow: exceeded 1MB without complete frame"));
+            buffer = "";
+            return;
+        }
         while (true) {
             const newlineIndex = buffer.indexOf("\n");
             if (newlineIndex < 0) {

package/dist/daemon/emoji-bindings.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import { EMOJI_BINDINGS_FILE } from "../wechat/channel-config.js";
+export const DEFAULT_EMOJI_BINDINGS = {
+    "[OK]": "/confirm",
+    "[闭嘴]": "/stop",
+    "[拥抱]": "/claude",
+    "[强]": "/codex",
+    "[胜利]": "/opencode",
+    "[再见]": "/daemon-stop",
+};
+let bindingsMap = null;
+function buildMap(bindings) {
+    const map = new Map();
+    for (const [emoji, command] of Object.entries(bindings)) {
+        map.set(emoji.toLowerCase(), command);
+    }
+    return map;
+}
+export function loadEmojiBindings() {
+    if (bindingsMap) {
+        return bindingsMap;
+    }
+    try {
+        if (fs.existsSync(EMOJI_BINDINGS_FILE)) {
+            const raw = JSON.parse(fs.readFileSync(EMOJI_BINDINGS_FILE, "utf-8"));
+            if (raw.bindings && typeof raw.bindings === "object") {
+                bindingsMap = buildMap(raw.bindings);
+                return bindingsMap;
+            }
+        }
+    }
+    catch {
+        // Fall through to defaults on parse error.
+    }
+    bindingsMap = buildMap(DEFAULT_EMOJI_BINDINGS);
+    return bindingsMap;
+}
+export function saveEmojiBindings(map) {
+    const bindings = {};
+    for (const [emoji, command] of map) {
+        bindings[emoji] = command;
+    }
+    const data = { bindings };
+    fs.writeFile(EMOJI_BINDINGS_FILE, JSON.stringify(data, null, 2) + "\n", () => { });
+}
+export function setBinding(emoji, command) {
+    const map = loadEmojiBindings();
+    map.set(emoji.toLowerCase(), command);
+    bindingsMap = map;
+    saveEmojiBindings(map);
+}
+export function removeBinding(emoji) {
+    const map = loadEmojiBindings();
+    const key = emoji.toLowerCase();
+    if (!map.has(key)) {
+        return false;
+    }
+    map.delete(key);
+    bindingsMap = map;
+    saveEmojiBindings(map);
+    return true;
+}
+export function listBindings() {
+    return loadEmojiBindings();
+}
+export function resolveEmojiCommand(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("[")) {
+        return null;
+    }
+    const map = loadEmojiBindings();
+    const lower = trimmed.toLowerCase();
+    for (const [emoji, command] of map) {
+        if (lower.startsWith(emoji)) {
+            const remainder = trimmed.slice(emoji.length).trim();
+            return { command, remainder };
+        }
+    }
+    return null;
+}