Jesse-njx/dsh-chatnode-wechat

dsh-chatnode-wechat

在微信里与你的 DSH agent 对话、监控、审批。

一个 DeepSeek Harness
bundle，通过腾讯非官方 iLink bot 网关（ilinkai.weixin.qq.com）把 DSH
profile 接到微信个人账号 —— 与 hermes-agent、OpenClaw 同机制。文字与图片
双向收发（微信发图自动下载解密交给 agent，/send 把图片发回微信），
支持 /sessions /use /new /stop /status 会话管理，权限请求直接在聊天里用
/yes / /no 回答，进度以摘要形式推送而不是刷屏式工具调用。

你 (微信)  ⇄  iLink  ⇄  wechat-gateway  ⇄  wechat-conversation-node  ⇄  DSH agent 会话

Bundle 内含两个可分离的 Cordis 插件：

| 插件 | 职责 |
| --- | --- |
| wechat-gateway（WechatGateway） | iLink 服务（ctx.wechat）：扫码登录、鉴权长轮询、断线重连/退避、发送重试 + 限流熔断、正在输入指示、加密 CDN 媒体下载/上传（downloadImage / sendImage）。 |
| wechat-conversation-node | 微信 ⇄ DSH 桥：allowlist 白名单闸门、会话定位、命令、摘要式出站（分块 + 限速）、审批。 |

⚠️ 先读这里

- 一个账号一个轮询者。 iLink 每个 bot token 只允许一个鉴权轮询者。如果
你在同一个微信账号上还跑 hermes-agent 或 OpenClaw，其中一方会收到
HTTP 403 并丢消息。请为 agent 使用专用微信账号，并且绝不要用同一个
token 跑两个本 bundle 实例。
- 非官方网关。 与 hermes/openclaw 同机制，腾讯可能限制该账号。再次建议：
使用可以接受的专用账号。
- 非官方协议。 iLink 细节是从 hermes-agent 源码逆向的，而非腾讯文档。
录制好的转录样本在 test/fixtures/inbound.ndjson，CI 不需要真实账号。

安装

git clone https://github.com/Jesse-njx/dsh-chatnode-wechat.git
cd dsh-chatnode-wechat
pnpm install && pnpm build
dsh plugin --profile  add .

凭据通过 dsh credentials 服务保存 —— 绝不写在 patch 文件里。先配对一次：

pnpm login          # 打印二维码链接，用微信扫码并确认

这会向 $DSH_HOME/.credentials.yaml 写入 WEIXIN_ACCOUNT_ID /
WEIXIN_BOT_TOKEN / WEIXIN_BASE_URL（经 dsh-credentials-local）。bundle
启动时解析并自动开始轮询。

配置

profile patch（cordis.patch.yml）
plugins:
dsh-chatnode-wechat:
allowFrom: [""]   # 硬白名单，必填，无默认值
digestIntervalSec: 300            # 运行中每 N 秒发一条进度摘要
approvalTimeoutSec: 600           # 审批超时 → 默认拒绝
maxMessageChars: 2000             # 微信单条气泡上限（协议限制）
sendChunkDelayMs: 1500            # 出站气泡间隔限速
cwd: /path/to/workspace         # /new 会话的工作目录
mediaDir: /path/to/media        # 入站图片落盘目录（默认 $DSH_HOME/attachments/wechat）
agentPreset:       # /new 会话使用的 agent preset
agentProvider / agentModel: ... # /new agent 的模型路由

allowFrom 必填且没有宽松默认值：接受任意微信联系人的指令等于把 prompt
注入的大门敞开。白名单外的消息只记日志、直接忽略，永远不会喂给模型。

用法

给机器人发文字或图片即可。只要存在至少一个会话就是零配置 —— 默认目标是
最近的一个会话。

图片收发

- 收图：直接给机器人发图片，网关会下载解密（加密 CDN + AES-128-ECB），
落盘到 mediaDir（默认 $DSH_HOME/attachments/wechat/），并把文件路径交给
agent —— agent 用 read_image/vision 工具识别内容。
- 发图：/send  把一张本地图片发回当前联系人（AES 加密 →
getuploadurl → CDN 上传 → sendmessage）。发送依赖该 peer 的
context_token，因此由网关进程内执行。

| 命令 | 作用 |
| --- | --- |
| (普通文字) | 路由到当前 agent（agent.followup） |
| (图片) | 下载解密落盘，把文件路径交给 agent 识别 |
| /sessions | 编号会话列表（最近优先） |
| /use N | 切换活动会话 |
| /new  | 新建 agent+会话并开始 |
| /stop | 取消当前任务 |
| /status | agent 状态 + 会话摘要 |
| /send  | 发送一张本地图片给当前联系人 |
| /yes /no（仅一条待确认时也可 1/2） | 回答权限请求 |
| /help | 命令列表 |

出站是摘要式的，绝不刷屏：

- 回合开始时 ⏳ 收到，开始处理…
- 每 digestIntervalSec 一条 🔄 仍在处理中… 心跳
- assistant 的实际文字（按 maxMessageChars 分块、限速）
- 回合结束时 ❌ 出错… / ⏹ 已停止 / ⚠️ 输出截断
- 🔐 #N 需要你的确认 权限提示，聊天内直接回答

审批

微信个人账号没有按钮。DSH 权限请求触发时，桥接层渲染成编号文本提示并等待：

🔐 #1 需要你的确认
工具: bash
原因: run a destructive command
回复 /yes 同意，/no 拒绝（仅一条待确认时也可回复 1/2）
10 分钟内未回复将自动拒绝。

/yes（仅一条待确认时 1）授予 allowed-once；/no（2）拒绝；超时回退到
DSH 默认拒绝。桥接层只回答当前微信用户驱动的 agent 的请求，其余请求沿
answerer 链继续委托。

开发

pnpm install
pnpm -r build
pnpm --filter @dsh-cowork/chatnode-wechat test   # 36 个测试，无需微信账号

- test/fake-ilink-server.ts 实现了 iLink 端点（getupdates 长轮询、
sendmessage、sendtyping、getconfig、扫码登录、加密 CDN），回放
test/fixtures/inbound.ndjson；完整的 入站→会话→出站 循环在 CI 中运行。
- pnpm smoke 是手动真机脚本（设置 WEIXIN_ALLOW_FROM）。
- 锁定 dsh-base 家族版本（本仓库 @deepseek-ai/ 为 0.1.0-rc.6）—— DSH
是开发者预览版，上游可能有破坏性变更。

风险

| 风险 | 对策 |
| --- | --- |
| iLink 独占锁 — 同一 token 两个轮询者 → 403 + 丢消息 | 专用账号；遇 403 大声报错并停止轮询；文档中明确共存警告 |
| 账号风险 — 非官方网关 | 专用账号；本 README 明示 |
| DSH v0.1 变更 | 锁定 @deepseek-ai/ 依赖；CI 针对锁定版本 |
| 协议不透明 | 协议移植自 hermes-agent；已录制样本，重构无需真实账号 |

Roadmap

- v0.1（本包）：扫码登录、双向文字、会话定位、命令、审批、摘要、白名单。
- v0.2：双向图片 ✅（见上文「图片收发」）、双向文件、出站语音回复。
- v0.3：群聊（高风险）、多账号、hermesclaw 式共享轮询代理（与
hermes/openclaw 共存）。
- 后续：复用 node/ 层的企业微信 / 钉钉 / 飞书 bundle。

License

MIT —— 见 LICENSE。