前言¶

DSH 的常见使用方式是先在电脑端打开 Web 或桌面 Host，再在工作区里下发任务、观察输出、切换模型和权限。若希望离开电脑后仍能处理长任务，就需要一个不依赖电脑界面的通道。

zp-home/dsh-weixin-clawbot 提供的是一个独立的 DeepSeek Harness（DSH）Host Bundle：它把腾讯官方微信 ClawBot/iLink 通道接入 DSH，让手机微信通过文本命令远程控制 DSH 执行电脑任务。

它不修改 DSH 核心，也不依赖桌面微信或 WxHook。原版 Web 和桌面 DSH 仍可打开，并复用同一 DSH Session。

这是什么¶

• 项目：zp-home/dsh-weixin-clawbot
• 定位：独立 DSH Host Bundle，将微信 ClawBot/iLink 通道桥接到 DSH Agent
• 维护者：zp-home
• 许可证：MIT
• 适用平台：Windows、macOS、Linux
• 运行环境：Node.js 22.19.0 或更高版本
• 已验证 DSH 版本：0.1.0-rc.8、0.1.1-rc.2
• 项目边界：社区独立适配项目，不是腾讯、微信、DeepSeek 或 DeepSeek Harness 官方项目

核心能力¶

消息与任务¶

• 接收微信文本任务，并将 DSH 执行结果以文本形式回复；长回复会自动分段。
• 接收微信语音的官方转写文本，并按普通文本任务处理。
• 当前仅处理文字和微信侧语音转写文本，不支持接收微信图片、文件、视频或其他媒体内容。
• 不支持向微信发送图片、文件、音频或视频；DSH 的结果目前仅以文本回复。

会话管理¶

• 为授权微信用户维护独立的持久 DSH Session。
• 支持新建、切换、重命名、归档、搜索和跨 Host 重启恢复。
• 可复用 Web 或桌面端已打开的同一 DSH Session，避免重复创建 Agent。

运行中控制¶

• 支持 /cancel，在长任务执行期间取消。
• 支持 /steer，追加纠偏。
• 支持 /task、/queue、/doctor，查看任务、队列和通道诊断。
• 支持查看或切换模型、Preset、工作目录与会话权限。
• 将未由插件处理的 DSH 原生命令，例如 /plan、/goal、/compact，转交给 DSH 命令系统。

权限与审批¶

• 默认使用 workspace-write。
• 切换为 danger-full-access 需要发送明确确认命令：/permission danger-full-access confirm。
• 主用户可通过 /users、/invite、/revoke、/audit 管理授权用户。
• workspace-write 的 DSH 审批可通过 /approve、/reject 在微信一次性处理。

可靠性¶

• 回复先写入持久 Outbox。
• 临时发送失败会指数退避。
• Host 重启后继续重试。

安装与启用¶

下面介绍 DSH Web Profile 的快速安装方式。先执行安装命令，再按照仓库说明完成微信 ClawBot/iLink 二维码配对；配对完成后，微信消息会通过该通道进入 DSH。

Web Profile 快速安装命令如下：

dsh plugin --profile web add github:zp-home/dsh-weixin-clawbot

如果实际启动的是桌面 DSH Host，需要把命令中的 web 换成桌面构建实际启动的 Profile；资料未给出固定桌面 Profile 命令，具体以本地 DSH 启动方式为准。

启用前需要满足以下条件：

• Host 必须常驻运行；一次性 headless 进程退出后无法维持 iLink 长轮询。
• Node.js 版本需要为 22.19.0 或更高版本。
• 已验证 DSH 0.1.0-rc.8 与 0.1.1-rc.2。
• 支持 Windows、macOS、Linux。

注意：本项目按设计不提供 Windows 开机启动、计划任务或系统服务安装。

典型用法¶

经过上面的安装和配对步骤后，可以先在微信中发送：

/status

该命令用于查看会话、任务、工作区、Preset、权限和模型。

如果任务正在运行，需要立即停止，可以发送：

/cancel

如果希望在最近的 DSH step 边界追加修正，可以发送：

/steer <内容>

查看或切换当前会话模型，可以发送：

/model [provider/model]

如果确实需要当前会话拥有完整机器访问，必须发送明确确认命令：

/permission danger-full-access confirm

默认情况下仍应优先使用 workspace-write。

适用场景与注意¶

适合以下场景：

• 需要在手机上查看 DSH 任务状态、队列和通道诊断。
• 需要远程取消长任务或在 step 边界追加纠偏。
• 希望手机微信与电脑端 DSH 共用同一 Session，不重复创建 Agent。
• 需要在微信中处理 workspace-write 的一次性审批。

使用前注意：

• 插件以当前 DSH Host 进程的权限运行，安装前应检查源码与 MIT 许可证。
• 状态文件会保存 iLink 游标、允许用户 ID 和 Session 映射，应视为私有文件。
• 不要提交 $DSH_HOME/.credentials.yaml、state.json、配对二维码或未经脱敏的日志。
• 当前媒体能力有限：不接收也不发送图片、文件、音频或视频。
• 它依赖常驻 Host；若关闭 Host 或使用一次性 headless 进程，无法持续接收微信消息。

链接¶

• GitHub：https://github.com/zp-home/dsh-weixin-clawbot
• 插件线索中给出的目录页：https://www.skillhub.cn/plugins/zp-home/dsh-weixin-clawbot
  该 URL 来自插件线索，未在已抓取资料正文中直接确认。