UNLINEARITY/CLI-WeChat-Bridge

Bridge WeChat, WeCom & Telegram to local Codex, Claude Code, OpenCode & Pi. Keep the native terminal experience & CLI options with bidirectional interaction, multi-session bridging, CLI switching, file transfer, approvals & status sync. 微信、企业微信与 Telegram 接入本地 Codex、Claude Code、OpenCode 和 Pi，保留原生终端体验与高级启动参数，支持原生双向交互、多会话桥接、多 CLI 切换、文件传输、审批交互与运行状态同步。

CLI WeChat Bridge – 这是什么

CLI WeChat Bridge 是一个 Node-JS 命令行工具，让您在使用 微信或企业微信作为远程入口点 的同时，能继续使用本地 AI 编码助手（OpenAI Codex、Anthropic Claude Code、OpenCode、Pi）。实际上，您在电脑上运行此桥接器，登录微信（或设置企业微信机器人），即可从聊天应用程序发送提示词、文件或控制指令。桥接器会将这些消息转发至选定的本地 CLI，捕获输出，并将回复（或状态更新）传回聊天对话中。

该项目 专注于保留原生的终端体验 – AI 模型在其原始 CLI 中运行，并保留其所有标志与交互功能，而微信仅作为轻量级的远程 UI。

谁适合使用

已经依赖 Codex、Claude Code、OpenCode 或 Pi 命令行界面的开发者。
希望从手机或其他设备触发这些工具，而无需切换至网页 UI 的使用者。
使用企业微信机器人进行内部自动化，并希望将其串接到现有本地 AI 工作流程的团队。

核心功能 (如 README 所述)

功能	作用
连接多种 AI-CLI 工具	支持 Codex、Claude Code、OpenCode 和 Pi。桥接器会启动或重复使用原生 CLI 并转发提示词。
两种远程频道	个人微信 (`wechat-setup`, `wechat-` 指令) 与企业微信 (`wecom-setup`, `wecom-` 指令)。
守护进程模式	`wechat-daemon` / `wecom-daemon` 可保持连接，让您即时切换四种 AI 工具，并管理单一工作目录。
单指令快捷键	`wechat-codex`, `wechat-claude`, `wechat-opencode`, `wechat-pi` (以及对应的 `wecom-` 指令) 可直接启动选定的 CLI。
文件传输	从微信发送的图片或通用文件会保存在本地，文件路径会附加到提示词中，以便 AI 模型读取。
丰富的远程指令	`/codex`, `/claude`, `/opencode`, `/pi` 用于切换工具；`/status`, `/model`, `/plan`, `/stop`, `/reset`, `/new`, `/resume`, `/confirm`, `/deny`, `/daemon-stop` 等。
表情符号绑定	消息开头的特定表情符号可绑定至指令 (例如：✅ → `/confirm`)。
上下文 Token 处理	桥接器会保留 `context_token`，确保回复能正确路由回原始聊天窗口。
跨平台支持	支持 Windows, macOS 和 Linux；在需要时使用 `node-pty` 进行 PTY 模拟。
安装与更新	通过 npm 发布 (`cli-wechat-bridge` 或 scoped `@unlinearity/cli-wechat-bridge`)。
疑难排解辅助	`wechat-daemon --doctor`，提供关于 PTY 问题、代理设置、Token 限制等的详细文档。

运作原理 – 高阶架构

登录 / 配对 – 运行 wechat-setup (QR 码登录) 或 wecom-setup (机器人 ID + Secret) 以获取本地存储的凭证。
桥接程序 – Node.js 运行环境会监控微信/企业微信频道是否有传入消息。
适配器层 – 每个支持的 AI 工具都有一个 适配器，知道如何启动 CLI (通过 PTY 或 WebSocket RPC) 以及如何输入提示词。
消息流
- 聊天消息 → 桥接器 → 对应适配器 → 本地 CLI。
- CLI 输出 (包含最终答案、状态更新、批准请求) → 桥接器 → 聊天。
守护进程 – 当您启动 wechat-daemon 时，桥接器会保持运行，锁定工作目录，并可在不重启整个程序的情况下随需切换适配器。
IPC – 守护进程公开了一个受 Token 保护的本地 IPC 端点，以便其他程序 (例如自定义网页面板) 能发送文字到同一个桥接器。

入门指南 (快速步骤)

先决条件 – Node ≥ 22.13，且已安装其中一种 AI CLI 并可在 PATH 中访问。
安装 – npm install -g cli-wechat-bridge。
登录 – wechat-setup (扫描 QR 码) 或 wecom-setup (输入机器人 ID/Secret)。
发送测试消息 从微信 (例如 hello)。这会初始化 context_token。
运行 CLI – 在项目文件夹内运行 wechat-codex (或任何其他快捷键)，或使用 wechat-daemon 启动持久化守护进程。
控制 – 使用上述斜线指令来切换工具、停止运行、变更模型等。

谁在维护

此仓库由 UNLINEARITY (GitHub 用户/组织) 拥有。README 链接至产品首页、CI 徽章以及相当详尽的文档集，显示这是一个活跃维护的开源项目。

授权

双重授权：开源使用采用 AGPL-3.0-or-later，封闭源代码部署则提供商业授权选项。

总结： CLI WeChat Bridge 是一个真正的工具，能将本地 AI 编码命令行界面连接至微信/企业微信，让您在从移动聊天客户端发送指令的同时，保留您偏好的终端工作流程。