dsh-plugin-wechat
Manifest validCommand the DSH Agent from WeChat · Left sidebar "WeChat Remote Control": Scan the code once to direct the DSH agent on your computer to get things done using WeChat
微信遥控 · dsh-plugin-wechat
给 DeepSeek Harness(DSH)左侧栏加一个「微信遥控」入口: 扫码一次,之后出门在外也能用微信给电脑上的智能体派活。
微信(你的号) ⇄ 腾讯 iLink 机器人通道 ⇄ 本插件 ⇄ DSH 会话(sessionController)
手机发一句话 → 电脑上的 DSH 开一轮 → 干完把结果发回微信。不需要公网 IP、不需要服务器、 不需要微信开发者账号,扫一次码就能用。
界面
| 扫码连接 | 已连接 |
|---|---|
![]() | ![]() |
左侧栏「微信遥控」面板:
| 区域 | 作用 |
|---|---|
| 连接卡 | 未连接时显示扫码二维码(含「手机数字校验」输入框);已连接时显示机器人 ID、微信用户、当前会话 |
| 开关 | 开始/暂停接收;新建会话;断开微信(清除本机令牌) |
| 测试卡 | 直接往你微信发一条消息,确认通道是通的 |
| 工作目录 | 微信里这一轮在哪个目录干活(留空用 DSH 默认) |
| 日志 | 收发的简版流水,出问题先看这里 |
特性
- 扫码即连:走腾讯 iLink Bot 开放接口,二维码由插件自带的纯 JS 编码器生成,不依赖第三方服务。
- 完全访问、永不弹授权:微信里点不了「允许」,插件每轮强制把会话切到
danger-full-access, 并在提示词里告诉模型「没人能回答问题」,卡死 12 秒自动取消——不会把会话挂死。 - 指令化:
/status、/new、/stop、/help、/cd,长回复自动按条切分。 - 零运行时依赖:宿主侧只用 Node 内置模块,二维码编码器自己实现(版本 1–10,纠错 M)。
安装
前置:DSH 0.2.x(桌面版或 CLI 都可以),profile 目录通常是 ~/.dsh/profiles/desktop。
-
克隆仓库:
git clone https://github.com/nixuejun888/dsh-plugin-wechat.git -
在 profile 的
package.json里登记(路径换成你克隆的位置):{ "dependencies": { "@local/dsh-plugin-wechat": "link:/path/to/dsh-plugin-wechat" }, "dsh": { "profile": { "bundles": [ // …原有的 bundle 列表… "@local/dsh-plugin-wechat" ] } } } -
在 profile 目录执行
pnpm install,然后重启 DSH。 -
左侧栏出现「微信遥控」。之后改了代码,在插件管理器里对配置条目
include:dsh-wechat做一次 disable → enable 即可热重载(客户端改动需在窗口按Ctrl+R刷新)。
包名保持
@local/dsh-plugin-wechat,因为它是按本地路径 link 进 profile 的,未发布到 npm。
使用
- 打开左侧栏「微信遥控」→ 点「生成二维码」。
- 手机微信扫码;如果微信要求输入数字,把数字填进面板的输入框点「提交」。
- 面板显示「已连接」后,直接在微信里发消息即可。
- 想换话题:发
/new;想打断:发/stop。
微信里的指令
| 指令 | 作用 |
|---|---|
/status | 看连接状态、当前会话、工作目录 |
/new | 开一个新会话 |
/stop | 打断正在跑的这一轮 |
/help | 说明 |
/cd D:\项目\xxx | 换工作目录并新开会话 |
实现要点
- 微信侧:腾讯 iLink Bot 开放接口(
ilinkai.weixin.qq.com),扫码登录拿到 bot token,之后用getupdates长轮询收消息、sendmessage发消息。协议实现见lib/ilink.js,只保留文本收发。 - 二维码:
lib/qr.js是自带的纯 JS 编码器(字节模式 / 纠错 M / 版本 1–10), 不依赖任何 npm 包,也不把二维码内容发给第三方服务。test/qr.check.mjs与 Pythonqrcode的矩阵逐格对齐,test/decode-check.py用 OpenCV 真解码验证。 - DSH 侧:
lib/bridge.js用ctx.sessionController的create / prompt / wait / cancel,把一条微信消息变成一轮提问,wait期间产生的assistant/message文本按段落切条回传(微信单条别太长)。 - 状态:
~/.dsh/plugins/dsh-wechat/state.json(bot token、首选会话、工作目录、消息游标)。 令牌属于敏感信息,写盘时尽量收紧权限;点「断开微信」会清掉。
权限:完全访问,永远不要你确认
微信里点不了「允许」,所以插件做了三层保证:
- 会话强制「完全访问」:每轮开始前把会话权限预设切到
danger-full-access(沙箱完全访问 + 审批never),冷会话会先resolveAgent()唤醒再切, 所以重启 DSH 后第一条消息也不会弹授权; - 告诉模型别问:每条消息前带一段「微信远程会话,没人能回答问题」的约束,
模型不会调用
ask_user_question; - 兜底不挂死:万一还是卡在需要确认的步骤,先尝试自动应答;12 秒还卡着就 自动取消这一轮并在微信里说明——会话永远不会一直挂着。
面板「账号」卡片里有一行「权限」,显示当前是不是完全访问,不是的话点 「切到完全访问」一键修好。
限制(重要)
- 电脑要开着、DSH 要运行:这是本机桥接,不是云端服务;电脑关机或 DSH 退出就掉线。
- 只处理文本消息:图片/语音/文件暂不转发(微信侧发过来会被忽略,日志里能看到)。
- 只认绑定的那个微信号:其他账号发来的消息一律忽略。
- 需要你在电脑上操作时(例如必须点「授权」的步骤),这一轮会挂起;处理完结果仍会回到微信。
排错
| 现象 | 先看什么 |
|---|---|
| 发消息没反应 | 面板「接收消息」是不是「开」;日志里有没有「收消息出错」 |
| 扫码后一直「等待扫码」 | 二维码 5 分钟过期,点「刷新二维码」 |
| 回了「出错了:…」 | 这条错误就是 DSH 侧的真实报错,按提示处理 |
| 想彻底重来 | 「断开微信」→ 重新「生成二维码」 |
| 微信里「一直转圈/没反应」 | 正常情况下不会发生:卡在确认上 12 秒会自动取消并回你一条说明;真遇到就发 /stop |
自检 / 开发
node test/qr.check.mjs # 二维码编码器 vs Python qrcode 参考矩阵(7 个版本逐格比对)
node test/host-smoke.mjs # 宿主链路:扫码→消息→会话→回复→去重→指令→HTTP 路由
node test/client-smoke.mjs # 客户端 bundle:可解析、侧边栏/面板注册正确
二维码的真机扫读验证(可选,需要 Python qrcode 和 opencv-python):
python test/gen-reference.py test/reference.json # 生成参考矩阵
node test/qr.export-png.mjs test/out # 导出自己编码的二维码
python test/decode-check.py test/out # OpenCV 解码比对
目录结构
dsh-plugin-wechat/
├── index.js 宿主侧:扫码登录、getupdates 长轮询、指令派发、HTTP 面板接口
├── client.js 左侧栏入口 + 遥控面板(二维码渲染、状态、日志)
├── lib/ilink.js 微信 iLink 通道:fetchQrCode / getupdates / sendmessage
├── lib/bridge.js DSH 会话桥:create / prompt / wait / cancel
├── lib/qr.js 纯 JS 二维码编码器(无第三方依赖)
├── lib/store.js 状态持久化(~/.dsh/plugins/dsh-wechat/state.json)
├── locale/ zh / en 文案
├── icon.svg 侧边栏图标
├── cordis.patch.yml 以 bundle 方式挂载(id: dsh-wechat)
└── test/ host-smoke / client-smoke / QR 参考比对
许可
MIT。微信、WeChat、腾讯 iLink 等商标归腾讯所有;本项目与腾讯无关。
Comments
Loading…
Similar plugins
by Carl-5535
微信 × DeepSeek Harness (DSH):进程内插件,扫码即用,双向消息/文件,wechat_notify 主动推送
★ 10
NOASSERTION
TypeScript
Oct 22, 2026
dsh plugin --profile web add dsh-wechat-gatewayby Huangzihengcmd
DSH plugin: drive DeepSeek Harness from WeChat — scan a QR code, send instructions from WeChat, get results back in the same chat.
★ 0
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add dsh-wechat-assistantby zp-home
Phone-to-DSH control through Tencent's official Weixin ClawBot/iLink channel | 基于腾讯官方微信 ClawBot/iLink 的 DSH 手机远程控制插件
★ 4
MIT
JavaScript
Aug 22, 2026
dsh plugin --profile web add @local/dsh-weixinby liushQAQ
DSH 微信通道增强插件 — 集成 iLink 消息双向桥接、单实例锁、大文件智能投递与 Web 设置管理界面
★ 0
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-weixin-plusby GuZhengSVT
DeepSeek Harness (dsh) 插件:事件驱动的企业微信(WeCom)群机器人通知 — goal 完成/阻塞与每轮对话自动推送,另含 wechat_notify 工具;走官方 webhook,零封号风险。
★ 3
MIT
TypeScript
Aug 15, 2026
dsh plugin --profile web add dsh-wecom-notifyby Shr-CS
微信公众号通道插件:在微信里发消息操控 DeepSeek Harness,结果经客服消息接口推回微信。回调签名校验 + openid 白名单,零运行时依赖。
★ 2
MIT
JavaScript
Sep 16, 2026
dsh plugin --profile web add dsh-wechat-channel
