dsh-wechat

让微信成为 DeepSeek Harness (DSH) 的第二客户端：通过腾讯 iLink bot 协议把 微信私聊桥接到 DSH agent——文本/图片/文件/语音消息双向收发、微信内 slash 命令管理会话/工作区/Preset/模型/权限、审批与提问卡与 GUI 双端同卡同决策、 DSH 设置页内扫码登录与连接配置。以静态 Cordis 插件交付，零运行时 @deepseek-ai 依赖，直接调用 DSH 进程内服务。

功能

• 发送 — 微信文本/图片/文件/语音消息 → DSH agent（媒体自动下载解密到 ~/.dsh-wechat/tempfile/，本地路径作为附件注入）
• 接收 — agent 回复文本回微信；send_wechat 工具可主动推送文本/文件到微信
• 微信 slash 命令 — /workspace、/session、/preset、/model、 /perm、/silent、/notify、/next、/status、/stop、/rp、/rq 等 由 bridge 直接处理（见下方命令表）
• 审批/提问卡（双端同卡） — 微信与 GUI 弹一致的原生审批/提问卡， 谁先回复谁生效（原生防双决）
• 微信渠道提示词（动态注入） — 微信消息注入「通过微信」提示；GUI 消息时自动消失
• 静默模式 — /silent on 后每轮只发送最终回复，设置页可切换
• 繁忙时投递（与 DSH 同源） — 按 busyEnter 排队/插话；微信 /enter 同步
• 跨会话通知 — 后台会话的已完成/报错/卡片通过微信提醒，/notify on|off|status 切换，默认关闭（单用户单闸）
• 二维码登录 — http://127.0.0.1:3080/wechat/qr 扫码登录，设置页内嵌
• 设置页 UI — DSH 设置 → WeChat：单卡展示状态、扫码、重连、退出登录、连接配置与通知/静默开关（保存即生效，存储于 ~/.dsh-wechat/config.json 与 state.json）
• 断点续传 — sync-buf 与微信会话映射持久化，重启 DSH 后自动恢复会话

安装（部署到 DSH profile）

DSH 自带插件管理命令 dsh plugin（在 profile 目录转发 pnpm，并自动把 声明了 dsh.bundle 的依赖加入 bundle 层）：

# 安装（自动添加依赖 + 注册 bundle 层）
dsh plugin --profile <profile> add dsh-wechat

# 验证组合配置
dsh --profile <profile> --dump-config   # 应看到 "- id: dsh-wechat" 行

# 重启 DSH（必须），然后：
#   - 浏览器打开 设置 → WeChat：扫码登录、查看状态、重连、改配置
#   - 或直接打开 http://127.0.0.1:3080/wechat/qr 扫码

其他管理命令（同样自动维护 bundle 层）：

dsh plugin --profile <profile> update dsh-wechat   # 升级
dsh plugin --profile <profile> remove dsh-wechat   # 卸载（从 bundles 移除）

插件从 npm 官方源安装（dsh plugin add 即 pnpm add dsh-wechat）。 修改代码后需重启 DSH 才能让改动生效。

微信命令

与 DSH 原生命令同步

微信消息进入后，bridge 先向 DSH 的 ctx.commands 注册中心查询当前会话 已注册的命令（这是 DSH 内置的人类 slash 命令注册服务，由 @deepseek-ai/dsh-commands 提供；name /plan、name /goal、name /compact 等命令都由各自的 bundle 在那里 注册）。命中即直接交给原生 handler 执行，并把结果回执渲染到微信——和 GUI 走同 一条命令管线。

未注册的命令回落到本仓库硬写的本地命令表（/silent、/next、/rp、/rq、 /workspace、/session 等），命中失败时按 "未知命令" 提示并作为文本转发给 agent。 DSH 的 ctx.commands 服务在某些极简装配下可能不挂载（缺失时会打一次 warn）， 这种情形行为完全等同之前的版本。

所以：DSH 加任何新的 /xxx 命令 bundle，微信端无需改动即可识别——只要它是 按 DSH 命令注册契约挂上去的。例如装有 dsh-plan-mode 时微信发 /plan off 收 到原生回执 "Plan mode off."；装有 dsh-command-goal 时 /goal <目标> 收到原生 "Goal created ..."；装有 dsh-command-compact 时 /compact 收到 "Compacted N history items (~M tokens)."——与 GUI 同款回执，由原生 handler 自己算、自己发。

/help 在末尾加一段 ── DSH 原生命令（当前 profile 已注册）──，列出当前 profile 实际注册的所有原生命令；本地命令表里已有的名字自动去重，不会重复 出现。

本地命令表

其他 /xxx 命令作为文本转发给 agent；审批/提问卡双端同弹，已在其他端 处理的卡会提示。

所有命令均直接映射 DSH 原生服务（workspaceRegistry / sessionQuery / agentPresets / agentDefaultModel / permissionPresets），默认值与 GUI 设置页同源同步。

架构

微信 (iLink) ── long-poll getupdates ──► dsh-wechat (Cordis host plugin)
    ▲                                      │
    │ ◄── sendText/sendMedia ──────────────┤
    │                                      ▼
    │                          DSH 进程内服务（零 @deepseek-ai 运行时依赖）
    │        agents.create/resume ── agent.followup（消息入）
    │        session/event ── assistant/message、turn/end（消息出）
    │        apiProxy.events.mux 帧流 ── approval/question 卡（镜像 GUI）
    │        apiProxy.respond() ── 微信决策注入原生 pending 表
    │        tools.register ── send_wechat 工具

设计说明：微信端是 GUI 的第二客户端，功能不多也不少。

设置页（DSH 设置 → WeChat）

客户端半部通过 dsh.client + exports["./client"] 声明（与 dsh-mcp-manager 同款交付），挂载到 settings.section slot（nav 顺序 40）：

• 状态卡 — 登录阶段（未登录/等待扫码/已扫码，待确认/已登录/登录失败）、Bot ID、 监控运行状态、已绑定用户数，与 跨会话通知 / 静默 开关同卡展示
• 扫码 — 未登录时页面内直接显示二维码，扫码确认后自动进入已登录
• 操作按钮 — 重新扫码（清除 token 重新登录）、重连（重启长轮询 监控，token 失效时自动回到扫码）、退出登录，与保存配置同行
• 连接配置 — baseUrl / cdnBaseUrl / botType / cwd / textChunkLimit / cardTimeoutMs / 跨会话通知（全局）/ 静默；保存即生效， 网关参数变更自动重连；存储于 ~/.dsh-wechat/config.json 与 state.json

与宿主通信走插件自己的 HTTP API（/wechat/api/status|config|relogin| reconnect|logout），客户端零 @deepseek-ai 依赖。

配置

优先级：内置默认 ← 插件行 config: ← ~/.dsh-wechat/config.json （设置页写入，覆盖前两者）。插件行可带 config:：

# 例：追加到 profile 的 cordis.patch.yml
- id: dsh-wechat
  config:
    cwd: 'C:\projects\my-project'

开发

npm install
npm run build    # tsc → dist/
npm test         # vitest（64 个用例：splitText/格式化/解析/帧处理/状态存储/命令解析）

已知边界

• 帧流 events.mux/respond 是 ApiProxy 正式契约；若 DSH 版本调整帧 结构，按契约适配即可。
• send_wechat 工具对所有 agent 可见；任何会话的 agent 都能调用——绑定会话发送到绑定用户，未绑定会话回退到首个已知微信用户（单用户部署默认行为）。 工具推送与 assistant 回复共享同一份微信 10 条/窗口限流预算：超限或发送失败自动进入 /next 缓存队列（与回复同一套恢复流程），不会丢失。
• /preset switch 遵循 DSH 约束：只有未产生任何内容的会话才能当场 recompose；已有内容的会话会提示 Preset 应用于下一个新会话。默认 Preset 本身写入 DSH 设置文档（agent-presets namespace），GUI 设置 页与微信双端读写同一事实源。
• iLink 通道是腾讯官方 bot 协议，接口可能随官方调整；跟随 wechat-opencode 上游的 src/weixin/ 修复即可。

许可

MIT。src/weixin/、src/adapter/ 移植自 wechat-opencode（MIT， 原始来源 @tencent-weixin/openclaw-weixin），文件头保留出处注释。

免责声明

本项目与 DeepSeek Harness、腾讯微信官方互不隶属，非官方项目， 纯属个人学习用途。使用本项目即表示你自行承担由此产生的一切后果。