xcisxc29/dsh-wechat · 上手攻略
- 仓库：xcisxc29/dsh-wechat
- 链接：https://github.com/xcisxc29/dsh-wechat
- 分类：工具 · AI Agent 远程控制
- 作者：Tom
- 更新：2026-10-13
这是什么
dsh-wechat 是一个 DeepSeek Harness（DSH）桌面端的微信频道插件。它的核心用途只有一件事：让你用微信随时随地操控电脑上正在运行的 DSH Agent——发消息、下指令、传文件、回答权限提示，全部在手机微信里完成，电脑锁着屏也行。
不需要 OpenClaw，不需要公网 IP，不依赖任何第三方中转服务器。DSH 桌面端跑在一台长期开机的电脑上，插件通过腾讯官方的 iLink 网关与你的微信账号做密码学绑定，整个链路是纯点对点的。
解决什么问题
使用 AI Agent 桌面应用最常见的痛点：人不在电脑前，或者电脑开着但锁着屏，Agent 跑着跑着遇到权限确认、多选提问，或者跑完了想汇报结果——全都被卡住，等你去桌面端操作。
dsh-wechat 把这个链路彻底打通了。Agent 可以主动推送消息到你微信，你可以在微信里用命令切换会话、发起新任务、回答确认提示。它解决的不是"能用微信聊 AI"这种玩具场景，而是"人在外面，Agent 在家 24 小时运转，随时待命"的真正实用需求。
快速安装
前置要求
- DSH 桌面端（DSH 0.2.0-rc.2，实测版本）
- 一台保持开机的电脑
- 手机微信账号
安装插件
在 DSH 侧边栏点「插件」→「添加插件」，输入包名：
dsh-wechat-plugin
⚠️ 注意：仓库名是
dsh-wechat，但包名带-plugin后缀，打错就装不上。
从 npm 安装不需要额外配置；若从 GitHub 安装（会自动构建），pnpm 可能会拦一次构建并要求放行，DSH 会提示在 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 中添加 allowBuilds 条目，这是正常现象。
启用后重启 DSH，然后打开设置 → 微信，点「重新扫码」，用手机微信扫二维码绑定。
终端命令安装（可选）
dsh plugin --profile desktop add dsh-wechat-plugin
# 或从 GitHub 直接安装（自动构建）
dsh plugin --profile desktop add https://github.com/xcisxc29/dsh-wechat
语音支持（可选）
微信语音是 SILK 格式，如需本地转录为 WAV：
dsh plugin --profile desktop add silk-wasm
不装也能用，原始 SILK 文件会连同服务端的转写一起交给 Agent 处理。
核心用法
基础对话
在微信里直接发消息，内容会变成 DSH 的 prompt，Agent 回复会推回微信：
你好
帮我查一下桌面上的 report.pdf
会话管理指令
在微信里发送以下指令来控制会话：
| 指令 | 作用 |
|---|---|
/new |
开新会话，后面的字作为标题 |
/new 修复登录 |
创建名为「修复登录」的会话 |
/list |
列出当前工作区的会话 |
/list all |
列出本机所有工作区及其会话数 |
/switch 3 |
切换到列表第 3 个会话 |
/switch e716f0 |
按短 ID 切换（不受编号过期影响） |
/model |
查看可用模型 |
/model 2 |
切换到第 2 个模型 |
/current |
查看当前在哪个会话 |
/cancel |
中断正在运行的任务 |
/help |
打印指令列表 |
💡 编号会过期——会话在列表呈现后仍在运行，回"3"时第3行可能已换人。每个列表行末尾都有短 ID（最多6位），直接回那个 ID 更可靠。引用列表消息后回编号，编号会冻结在该引用时刻。
权限与多选提示
当 Agent 遇到权限确认或多选提问时，会自动推送到微信，回一个数字即可回答，人不在电脑前也不会卡住任务。
文件双向传输
- 手机 → 电脑：在微信里发文件或图片，自动落盘到会话工作区，Agent 能读取并处理。
- 电脑 → 手机：Agent 调用
send_to_wechat工具，可以把文件、图片发回微信。
主动推送
任何工作区的任何会话都可以主动给你发微信，不只是微信绑定那个工作区。在设置页面可以限制哪些会话允许推送。
典型适用场景
- 远程监控长任务：让 Agent 在家里电脑上跑数据处理、代码生成，跑完了主动推结果到手机。
- 不在电脑前时的权限处理：人在外面，Agent 遇到 sudo 确认或 API key 授权，手机上回个数字就继续。
- 多会话管理：同时跑多个 Agent 会话（不同项目、不同任务），在微信里用
/switch切换，不用切窗口。 - 移动端文件处理：手机拍张照片发过去，让 Agent 识别、提取信息、写文件，再发回来。
坑与注意
包名和仓库名不一样。仓库叫 dsh-wechat，但安装时填的是 dsh-wechat-plugin，漏掉 -plugin 后缀会导致安装失败。
微信对话默认是"完全访问"。Agent 收到的每条微信消息都有完整执行权限，不会先弹确认。这是有意设计——否则每次都要手机回复权限确认，反而更麻烦。如需更谨慎的权限控制，在设置页把对应微信对话的权限改成「跟随 DSH 设置」。
Agent 以你的身份运行。它能读写文件、执行命令，和你坐在电脑前操作用的是同一个用户权限。离开时建议锁屏（不影响 Agent 干活），防止路过的人操作你的桌面。
微信只能绑定你自己的账号。插件通过 iLink 网关与微信账号做密码学绑定，机器人不是微信联系人，别人搜不到、加不上，陌生人发消息无法触发任何操作——协议层本身就是白名单。
pnpm 构建拦截：从 GitHub 安装时，第一次构建会被 pnpm 拦住，按 DSH 提示添加 allowBuilds 即可。这是所有 Git 来源插件的共同行为，不是 dsh-wechat 特有的问题。
与同类对比
| 方案 | 架构 | 公网 IP | 第三方中转 | 多会话管理 |
|---|---|---|---|---|
| dsh-wechat | DSH 插件 + iLink | 不需要 | 不需要 | ✅ 完整支持 |
| OpenClaw 微信桥接 | 独立服务 | 可能需要 | 可能需要 | 看配置 |
| 自建 Web + 微信机器人 | 独立服务 | 需要 | 自建 | 自定义 |
dsh-wechat 的核心优势是深度集成 DSH 桌面端、无需任何基础设施，以及完整的多会话管理——大多数方案解决的是"微信能发消息"，它解决的是"人在外面也能完整操控一个 AI 工作站"。
一句话推荐结论
如果你的 DeepSeek Harness 桌面端需要真正的移动端远程控制能力（不是玩具聊天，而是人在外面也能管 Agent、传文件、应答确认），这是目前最省事的方案——装上就能用，零额外基础设施。