前言¶
在 DeepSeek Harness(DSH)里跑长任务时,助手可能要连续调用很多工具,桌面端会话里信息是完整的,但人一旦离开电脑,手机上往往只能看到零星文字,很难区分「还在跑」和「已经停住」。若还要先绑定会话才能发指令,出门路上还要额外做一步设置。
下面介绍社区插件 dsh-wechat-remote(维护者 yin1895):通过腾讯官方 ClawBot(iLink)协议,把个人微信接到 DSH,用作遥控器与进展监视器。配对不走第三方 hook,也不是非官方微信客户端。
这是什么¶
插件仓库:yin1895/dsh-wechat-remote。在 SkillHub 目录中归类为客户端插件。当前 package 版本为 1.1.0,许可证 MIT。
一句话定位:手机上看长任务进展、发下一条指令、接管正在进行的对话;出站与入站经 iLink 长轮询与发消息能力,与 DSH 的会话控制器、命令路由衔接。
数据流概览(摘自 README):
微信 ──getupdates──▶ Runtime ──▶ CommandRouter ──▶ SessionAttach(prompt)
│ │
│ follow():助手文字
▼ ▼
Outbox ◀── ProgressPusher ◀── ProgressTracker
│ (session/event · 覆盖每个会话)
▼
sendmessage ──▶ 手机
它解决什么问题¶
若只镜像助手 prose,一个「想了 4 分钟、跑了 20 个工具」的会话,在手机上可能和一个已经结束的会话看起来一样。插件把原先挤在同一绑定变量上的三件事拆开:
| 概念 | 含义 |
|---|---|
currents |
手机上直接发的文字,发给哪个会话 |
watches |
哪些会话把进展推给这个手机 |
notify |
哪些类别的通知要送达 |
进展采集来自全局会话事件流,因此每个会话都可见,包括从未在手机上打开过的会话。
核心功能¶
微信侧命令¶
| 你发 | 会发生什么 |
|---|---|
| 任意文字 | 发给当前会话(没选过就自动接入正在跑的那个,并回一句说明) |
/t |
进度快照:跑了多久、最近做了什么、最后一段输出 |
/ls → /open 2 |
看会话列表、换一个会话 |
/watch [序号\|off] |
订阅/取消某个会话的进展推送 |
/new [标题]、/ws …、/close、/stop、/status、/notify …、/help |
其他管理类命令 |
出门后的三种情况¶
- 在电脑上起了长任务然后出门 —— 不必先在手机上操作:正在运行的会话会自动推动作简报。插件每 15 秒看一次,同一用户最多每 45 秒收到一条;间隔里攒下的动作会合并在下一条。
- 长时间没有新事件 —— 超过 2 分钟会推一条「还在运行」,避免误判为卡死。
- 跑完了 —— 推「✅ 会话名 完成了这一轮」并附最后一段输出;若推送未显示,下次说话时会补一次。
推送与拉取¶
iLink 出站消息挂在用户自己那条消息打开的会话窗口上(context_token)。窗口不存在时消息会留存,下一句话到达时先回命令、再 📬 补发。主动发送可能被接受但用户看不到,因此完成推送会记为未确认,直到再次说话;面板显示推送通道为「就绪 / 等你先发一条微信消息」。拉取(/t、/status)不依赖窗口,始终可用。
安全与内容边界¶
上手机的内容只有:助手文字、动作行(凭据类字符串在上手机前打码)、通知。工具结果与原始参数不出本机。配对得到的 bot token 存在 <DSH_HOME>/wechat-remote/state.json,不在仓库内。
安装与启用¶
插件无依赖、无构建步骤,把仓库目录作为 bundle 安装。README 给出的命令如下(路径需换成你本机克隆或下载后的绝对路径):
plugin_manager install_bundle /本仓库的绝对路径
环境要求:Node >= 20.3(用到 AbortSignal.any)。
安装后在 DSH 设置 → 插件 → 微信遥控 里点「重新登录」,用手机微信扫码。面板上的「发一条测试消息到微信」可验证推送是否能落到手机。桌面端只需关注这一页:配对状态、手动操作、当前上下文(发到哪个会话、进展推给谁、通道是否就绪)。
典型用法¶
- 在桌面 DSH 里启动一个会跑较久的 agent 会话。
- 安装并扫码配对后,若未手动选会话,直接在微信发文字即可注入当前或正在运行的会话(
sessionController.prompt({ mode: 'queue' })排在当前 turn 之后,与桌面端串行)。 - 出门途中用
/t拉快照;需要持续感知时用/watch订阅,或依赖对运行中会话的自动进展推送。 - 用
/ls、/open切换currents;用/notify调整通知类别。
适用场景与注意¶
适合:需要在离开电脑后继续下发指令、查看工具级进展摘要、接收完成/报错/审批类通知的 DSH 用户;接受个人微信单账号、仅文字消息的场景。
限制(README 明确列出):
- 仅支持文字;图片/语音/文件会收到能力提示。
- 电脑需保持开机。
- 个人微信单账号,群聊不支持。
- 主动推送尽力而为并有留存补发;拉取可靠。
安装前:插件以当前 DSH 进程权限运行,安装前应自行阅读仓库源码与 MIT 许可证。社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,本文介绍的是社区维护的 bundle,不是官方应用商店条目。
结尾¶
dsh-wechat-remote 把微信变成 DSH 的遥控与监视通道,并把「当前会话」「进展订阅」「通知」拆开配置,同时用全局事件流渲染动作行与心跳,缓解「看不见是在跑还是已经停」的问题。配对走官方 iLink,推送侧有队列、节流与补发,拉取侧用 /t 等命令保底。