前言¶
DeepSeek Harness（DSH）跑在本机时，常见用法是坐在电脑前在网页或 IDE 里发任务。人离开工位、只带着手机时，要么远程桌面，要么把需求记到别处再回来执行，链路都偏长。若希望用日常 IM 当「遥控器」，又不必自建公网回调服务，需要 DSH 侧有一条官方通道的接入实现。下面介绍社区插件 dsh-wechat-assistant（维护者 Huangzihengcmd，分类：客户端）：扫码登录微信一次，之后在同一聊天窗口发自然语言指令，由本机 DSH Agent 执行并把结果回传。
这是什么¶
dsh-wechat-assistant 是 DSH 插件，把个人微信账号接到本机正在运行的 DSH 进程上。底层走腾讯为 Agent 生态提供的 微信 ClawBot 通道（官方包 @tencent-weixin/openclaw-weixin）；插件负责 DSH 侧的桥接：扫码授权、进程内长轮询收消息、把消息送入 DSH Session 执行、再把 Agent 输出发回微信。
与「自建 Webhook + 公网服务器收微信回调」相比，README 强调：无需公网服务器、无需手动复制 token；二维码在浏览器本地渲染，协议侧使用 iLink Bot 的 get_bot_qrcode / get_qrcode_status / getupdates / sendmessage 等接口。
核心功能¶
- 扫码登录：打开 DSH 设置里的「微信助理」即生成登录二维码；手机微信扫码并确认授权，必要时在页面填写手机上的数字配对码。
- 长轮询收消息：通道在 DSH 进程内长轮询微信服务端，README 说明不占用端口。
- 执行与回传：每条微信消息进入对应用户的 DSH Session；一轮跑完后把正文发回同一聊天窗口。
- 会话管理：发送
/new或/新会话会结束当前对话并开启新的 DSH Session。 - 状态持久化：每个微信用户对应独立 Session；账号凭据与续传游标等写在
<DSH_HOME>/wechat-assistant/accounts/下（默认<DSH_HOME>为~/.dsh）。
数据流可概括为：
微信 App ⇄ 微信 ClawBot 服务 ⇄ 本插件（长轮询）⇄ DSH Agent
安装与启用¶
插件通过 DSH 的 plugin add 安装，命令以 README 为准：
dsh plugin add Huangzihengcmd/dsh-wechat-assistant
也可在 DSH 界面 Plugins → 添加插件，填入仓库地址 Huangzihengcmd/dsh-wechat-assistant。
兼容性（README）：需要 DSH >=0.2.1-rc.5（依赖 ctx.agents.create/resume、agent.followup()、agent.whenIdle()、settings.section 等能力）。package.json 中声明 Node >=22.13.0。许可证为 MIT。
安装后可在 Plugins 页面或 profile 的 cordis.patch.yml 中调整插件行配置：
| 字段 | 默认 | 说明 |
|---|---|---|
autoConnect |
true |
启动时自动接上上次登录的账号 |
cwd |
空 | 新会话的工作目录；留空则用 DSH 默认目录 |
典型用法¶
- 打开 设置 → 微信助理。页面打开时会自动生成登录二维码。
- 用手机微信扫描二维码，在手机上确认授权；若提示输入数字配对码，填到页面输入框。
- 卡片显示「已连接」后，在微信里直接发指令。
普通自然语言即可，例如：
帮我看一下这个项目有哪些测试没跑
把这个目录里的 CSV 汇总成一张表
需要清空上下文时发送 /new 或 /新会话。
二维码过期：二维码有时效；过期后页面会提示，点「刷新二维码」即可。Host 侧也会自动换发（最多 3 次）。
适用场景与注意¶
适合谁：已经在本机跑 DSH、希望用手机微信临时下发任务或看执行结果，且能接受消息内容进入 DSH 会话日志（与网页端对话同样可追溯）的开发者。
权限与安全（README 原文要点）：
- 插件在本机 DSH 进程权限下执行指令，安装前应自行审阅源码与 MIT 许可证。
- 微信凭据只存在本机，不会发给浏览器或 DSH 之外；HTTP 路由仅接受本机 loopback 请求。
- 账号 JSON 等文件权限为
0600，路径见 README 中的accounts/<id>.json等说明。
DSH 生态采用「一切皆插件」的扩展方式；社区目录站点与 DeepSeek / 幻方无官方从属关系，本文仅介绍该仓库公开文档中的能力。
结尾¶
dsh-wechat-assistant 把微信 ClawBot 通道接到 DSH：一次扫码、进程内长轮询、结果回到同一聊天。需要安装命令与配置字段时，以 GitHub README 为准；在目录站可查看条目：dsh-wechat-assistant @ skillhub.cn。
