微信龙虾通道bwhite55/dsh-wechat-pro

dsh-wechat-pro

DeepSeek Harness 进程内微信 ClawBot 通道插件：把 DSH 变成微信里的一只「龙虾」🦞。

- 扫码即用：腾讯官方 iLink 通道（个人微信免白名单），二维码打印在 dsh web 终端，凭证 24h 自动续连 + 到期提醒；
- 与 Web 共享真实会话：微信里新建/切换的会话就是真实 DSH 会话，出现在 Web 会话列表、可跨端续接（Codex 式附着）；
- 工作区：/workspace 在注册工作区间切换，/workdir  切换任意工作路径（自动注册为工作区，Web 同源可见）；
- 模型与思考强度：/model、/thinking 按会话切换，下一轮生效（走 Web 同款宿主 apiProxy）；
- 原生命令：/plan、/permission、/compact、/goal、/feedback、/export 等 harness 原生命令直接在微信执行；
- 审批转发微信：高风险工具调用（跨目录写入等）在微信里推送审批提示，回复 /yes 允许 / /no 拒绝即可；多个待审批同时存在时回复「允许 」精确选择（提示里会给出）；
- 流式输出：思考/工具调用过程事件实时推送，最终答复长文自动分片；
- 媒体收发：/send 发电脑文件到微信；微信图片/文件/视频/语音自动下载解密落盘；
- 主动能力：agent 可用 weixin_send 工具随时推送消息到微信。

架构：微信通道与宿主 apiProxy 都跑在 dsh web 进程内；会话事件经 session/event 订阅实时镜像到微信。不需要 OpenClaw、不需要公网服务器、不需要独立进程。

安装

方式一：从 GitHub 安装（推荐，发布后）

dsh plugin --profile web add github:bwhite55/dsh-wechat-pro
dsh web

方式二：本地源码（开发/修改）

1. 构建
cd D:\dsh-wechat-pro
pnpm install
pnpm run build

2. 装进 web profile（link 方式，改源码后重新 build 即生效）
dsh plugin --profile web add link:D:\dsh-wechat-pro

3. 重启 dsh web
dsh web

重启后 dsh web 终端会打印登录二维码（或已有凭证自动连接）。手机微信「我 → 设置 → 插件」添加 ClawBot/龙虾，扫二维码配对后即可对话。

隐藏窗口运行 dsh web 时（如 start-dsh-web-hidden.vbs）终端看不到二维码：
浏览器打开 http://127.0.0.1:3080/api/dsh-wechat-pro/status，响应里的 qrLink
就是当前登录二维码链接（手机微信打开即可扫码）；POST /api/dsh-wechat-pro/connect
可强制重新扫码。

指令

| 指令 | 作用 |
|---|---|
| /help | 指令列表 |
| /status | 连接、工作区、会话、模型状态 |
| /time | 连接剩余时间 |
| /workspace | 切换工作区（回复数字选择） |
| /workdir  | 切换任意工作路径（自动注册为工作区） |
| /sessions | 当前工作区会话列表（回复数字切换/附着；📌=微信书签） |
| /new  | 当前工作区内新建会话并切换（Web 会话列表可见） |
| /switch  | 切换命名会话（main = 默认） |
| /attach  | 附着 Web 已有会话（同轨迹双向可见） |
| /clear [名字] | 删除微信书签（真实会话与日志保留在 Web） |
| /unbind | 停止接收当前会话的推送 |
| /model | 切换模型（回复数字选择，下一轮生效） |
| /thinking | 切换思考强度 off/high/max（回复数字选择） |
| /level [级别] | 输出等级：minimal=只收最终答复与错误 / normal=思考+工具调用/结果+答复 / verbose=完整工具参数（按联系人持久化） |
| /send  [说明] | 发电脑文件到微信（相对路径按会话工作区目录） |
| /reconnect | 重新扫码续连 |
| /cancel | 取消当前回合 |
| 其他 /xxx | 若为 harness 原生命令（/plan /permission /compact 等）直接执行 |

配置

插件配置在「设置 → 插件配置 → dsh-wechat-pro」或 cordis.patch.yml 的 config 段，
也支持环境变量（DSH_WXBOT_，测试时可指向本地 mock）：

| 键 / 环境变量 | 默认 | 说明 |
|---|---|---|
| autoConnect | true | 启动时已有凭证自动连接 |
| allowFrom / DSH_WXBOT_ALLOW_FROM | 空 | 微信用户白名单（逗号分隔的 from_user_id；空 = 全部，建议设置） |
| dataDir / DSH_WXBOT_DATA_DIR | $DSH_HOME/dsh-wechat-pro | 凭证/联系人注册表/媒体目录 |
| baseUrl / DSH_WXBOT_BASE_URL | https://ilinkai.weixin.qq.com | iLink 端点（测试可指向 mock） |
| replyMaxChars / DSH_WXBOT_REPLY_MAX | 3800 | 单条微信消息上限，超出分片（env 优先） |
| streamLevel | normal | 默认输出等级（minimal/normal/verbose；微信内可 /level 覆盖） |
| mirrorWebTurns | false | Web 发起的回合是否也推送到微信（默认只推微信发起的回合） |
| replyTimeoutMs / DSH_WXBOT_REPLY_TIMEOUT_MS | 300000 | 单轮回复超时（env 优先） |
| announceToAgent | true | 是否在系统提示词声明插件能力 |

输出等级与推送范围

- /level（微信内即时切换，按联系人持久化）：
- minimal（默认，推荐）— 只推最终答复与错误（不含任何过程消息）；
- normal — 思考（🤔）+ 工具调用（🔧）/结果（✅）+ 最终答复；
- verbose — normal + 完整工具参数与结果（不截断）。
- 回合来源：只有微信发起的回合会推送到微信；Web 端在同一会话发起的对话默认不推送（mirrorWebTurns: true 可改为也推送）。判断依据：该回合的触发消息是否带浏览器时区（微信侧不带）。
- ⚠️ 腾讯发送额度限制（重要）：实测腾讯 iLink 对单条入站消息的回复发送有额度限制——过程消息刷屏（normal/verbose 下每个工具调用都推一条）会触发 sendMessage ret=-2 prepare failed，后续所有发送（含最终答复）都会被拒。因此默认 minimal（每回合只发最终答复+错误，最可靠）。若确实想看过程，可 /level normal，同时过程消息上限 maxProcessPerTurn（默认 3）会尽量为最终答复留额度，但不能保证。
- 长度限制与超长回复降级：微信单条消息约 2048 字符限制，replyMaxChars 默认 3800（超出自动分片，每片间隔 1s）。最终答复分片预算 maxReplyChunks（默认 8 片）：分片数在预算内正常发送；超预算时降级为「首片 + 完整内容落盘为文件发给你」（一条媒体消息，不占文本条数额度，完整内容必达）。文件存于 dataDir/outbox/。
- 发送可靠性：最终答复/审批提示等关键消息发送失败会自动重试一次；所有发送失败都会追加到 dataDir/logs/wechat-pro.log（隐藏窗口启动时这是唯一可查的发送痕迹，ret=-2 prepare failed 即额度/上下文被拒）。

数据与安全

- 凭证 weixin-auth.json 含 bot token（= 以你微信身份收发消息的凭据），勿外传；
- 每联系人注册表存于 dataDir/contacts/.json（当前工作区 + 命名会话书签）；
- 微信来的媒体解密后存 dataDir/media//；发送失败日志存 dataDir/logs/wechat-pro.log；
- 控制路由（/api/dsh-wechat-pro/）仅监听回环地址，LAN 暴露会被拒绝；
- 建议保持 DSH 自身权限为 workspace-write，并用 allowFrom 只放行自己的微信号。

开发与测试

pnpm run typecheck   # 类型检查
pnpm run build       # tsc 构建到 dist/
node tests/test-mock-ilink.mjs --port 8899   # 起 mock iLink（登录/收发闭环）

自动化测试（无需真实微信）：

node tests/channel-smoke.mjs   # 通道冒烟：引擎直连 mock（登录/轮询/typing/回复/媒体接收）
node tests/e2e-harness.mjs     # harness 集成：侧路 dsh web + mock 队列，命令层端到端
node tests/e2e-chat.mjs        # 真实模型 e2e：对话/流式/审批转发/长文分片//model（需 DEEPSEEK_API_KEY，消耗少量配额）

侧路 dsh web 约定：DSH_E2E_WEB_PORT=3099（默认）、DSH_E2E_MOCK_PORT=8898（默认）、DSH_E2E_TIMEOUT（秒）。

本地闭环（手动，无需真实微信）：

终端 A：mock iLink
node tests\test-mock-ilink.mjs --port 8899

终端 B：带插件的 dsh web（另一端口 + mock 端点 + 隔离数据目录）
$env:DSH_WEB_PORT = "3099"
$env:DSH_WXBOT_BASE_URL = "http://127.0.0.1:8899"
$env:DSH_WXBOT_DATA_DIR = "D:\dsh-wechat-pro\.test-data"
dsh web

许可

MIT