dsh-wechat-bridge —— 把 DSH 接到你的微信（含「龙虾」直连版）

把本机 DSH（DeepSeek Harness） 变成你微信里的一只「龙虾」🦞：微信发消息 → DSH 干活 → 回复回微信。不需要 OpenClaw、不需要公网服务器、不需要网关。

手机微信 ──► 腾讯 iLink 官方通道 (ilinkai.weixin.qq.com) ──► weixin-bot.mjs ──► 本机 DSH
    ▲                                                              │
    └────────────────────────── 回复 ──────────────────────────────┘

Overview

解决什么问题？ 把微信变成 DSH 的移动终端：人在外面用手机微信发一条消息，家里/办公室电脑上的 DSH 就替你查资料、写代码、跑脚本、处理文件，结果直接回微信。任何能跑 dsh web 的机器都能挂上。

适合谁？ 已经会装 DSH 的开发者与重度用户；想要一个「随时在微信里」的私有 AI 助理、又不想搭公网服务器的人。

怎么做？ 直接实现腾讯官方 iLink Bot 协议（微信 ClawBot/「龙虾」的同款官方通道）——扫码配对 → 长轮询收消息 → 调用本机 DSH → 发回微信。官方 OpenClaw 插件本身也只是这套协议的客户端，AI 后端（OpenClaw/DeepSeek/…/DSH）完全自选，腾讯只是"管道"。本仓库 weixin-bot.mjs 即完整实现（协议依据腾讯官方开源 SDK @tencent-weixin/openclaw-weixin，对照版本 2.4.6，详见 RESEARCH.md）。

特性一览：

零运行时依赖：只用到 Node 内建模块，无需任何 npm 依赖、无需 daemon、无需 OpenClaw 全家桶；
扫码即用：个人微信免申请/免白名单，登录凭证自动续期（到期前提醒 + -14 自动重扫码）；
一人一上下文：每个微信联系人有独立的 DSH 对话记忆、工作目录与多个命名会话；
双向文件：/send 发电脑文件到微信；微信发来的图片/文件/视频自动下载解密落盘；
可审计：聊天记录、DSH 完整运行轨迹、运行日志三层可查。

Compatibility

依赖	支持/已验证	最后验证日期
Node.js	`>= 18`	2026-08-14
DSH	`dsh@0.1.0-rc.6`（npm）	2026-08-14
腾讯 iLink	对照官方 SDK `2.4.6`	2026-08-14

指令	作用
`/help`	指令列表
`/status`	连接剩余时间 + 当前会话与记忆条数
`/time`	本次连接剩余时间
`/sessions`	列出你的会话（记忆轮数 + 当前标记）
`/new`	新建命名会话并切换过去
`/switch`	切换会话（`main` 为默认会话）
`/clear [名字]`	清除当前（或指定）会话的对话记忆（工作目录文件保留）
`/reconnect`	手动重新连接
`/send [说明]`	把电脑上的文件发给你（绝对路径直接用；相对路径按当前会话的工作目录算；图片/视频按媒体发送，其余按文件发送）

选项	默认	说明
`--base-url`	`https://ilinkai.weixin.qq.com`	iLink 端点（测试时可指向 mock）
`--channel-version`	`2.4.6`	base_info.channel_version
`--bot-agent`	`dsh-wechat-bridge/…`	base_info.bot_agent（仅观测用途）
`--data-dir`	`./data`	凭证/记忆/工作目录根
`--auth-file`	`/weixin-auth.json`	🔒 登录凭证（含 bot token，勿外传）
`--allow-from`	全部	🔒 只响应指定用户 ID（逗号分隔，强烈建议设置）
`--reply-max-chars`	`3800`	单条回复截断上限
`--no-typing`	关	不发"正在输入"状态
`--session-ms` / `--relogin-before-ms`	24h / 2h	会话有效期 / 到期提醒提前量
`--dsh-bin`	自动解析	DSH 可执行文件路径（找不到 `dsh` 时用）
`--timeout-ms` / `--max-turns` / `--max-history-chars`	同 bridge	DSH 调用超时 / 记忆条数上限 / 记忆字符上限

类别	内容
网络	仅 HTTPS 访问 `ilinkai.weixin.qq.com`（登录/收发）与腾讯 CDN（媒体上传下载）；闭环测试时指向本地 mock。不访问其他任何公网地址。
文件（读写）	`data/`（默认，含凭证、历史、会话注册表、工作目录、媒体）；`test-data/`（测试）。
文件（只读）	`~/.dsh/sessions/`（`sessions` 命令读取 DSH 运行轨迹）。
凭据	`weixin-auth.json` 含 bot token——即"以你的微信身份收发消息"的凭据，🔒 切勿提交版本控制或外传（`.gitignore` 已覆盖）。
用户数据	所有往来消息原文 + 时间戳存于 `data/history/`（本地明文 JSON）；媒体文件解密后存于 `data/media/`。数据只在你机器与腾讯通道之间流动，不发给任何第三方。
执行权限	任何能给你微信发消息的人都能触发本机 DSH 执行任务（等于你本机账号的操作权）→ 务必用 `--allow-from` 只放行自己的微信号，并维持 DSH 自身的沙箱/审批配置。

现象	原因与处理
回复 `errcode -14` / 提示 token 失效	凭证过期：实现会自动重新扫码续连；也可手动 `dsh-weixin login`
二维码过期 / 扫了没反应	重新 `dsh-weixin login`，并确认手机微信打开的是最新打印的链接
收不到消息	确认 `run` 进程在跑；`/status` 看连接剩余时间；看终端有无 `[bridge …]` 报错
`dsh: command not found`	安装 DSH，或用 `--dsh-bin` 指定可执行文件路径
媒体下载/上传失败（如 `x-encrypted-param` 缺失）	腾讯协议变更或端点被代理改写：升级本仓库、确认 `--base-url` 为官方地址
`bridge.mjs serve` 端口被占用	`--port` 换端口
查看 DSH 轨迹提示 `zstd` 不存在	安装 zstd，或改用 DSH WebUI 查看对应 session
扫码成功后无法配对（节点跳转）	网络环境问题：换网络重试；实现已覆盖节点跳转分支

文件	说明
`weixin-bot.mjs`	龙虾直连版：iLink 客户端 + DSH 后端（login/run/status/logout/probe/chats/history/sessions）
`bridge.mjs`	通用桥接（CLI/HTTP），供 OpenClaw exec 工具、wechaty 等调用
`lib/core.mjs`	共享核心：DSH headless 调用、对话记忆、工作目录
`lib/ilink.mjs`	iLink 协议客户端（对照官方 SDK 2.4.6 实现，含 `getuploadurl`/通用 `sendMessageItems`）
`lib/ilink-media.mjs`	媒体通道：CDN 上传（AES-128-ECB）+ 下载解密落盘 + MIME/密钥工具
`lib/sessions.mjs`	多会话管理：每联系人命名会话（/new /switch /sessions）、当前会话指针注册表
`lib/ws.mjs`	零依赖 WebSocket 服务端（备用：未来 ClawChat 小程序直连网关用）
`test-mock-ilink.mjs`	mock iLink 服务器（闭环测试）
`test-ws.mjs`	ws 帧编解码单元测试
`dsh-weixin.cmd`	Windows 启动器（任意目录运行 `dsh-weixin login/run/…`）
`RESEARCH.md`	协议调研笔记（来源清单、实现备忘）
`LICENSE` / `package.json` / `SECURITY.md`	MIT 许可证 / 包信息 / 安全策略

dsh-wechat-bridge

安装

说明文档

dsh-wechat-bridge —— 把 DSH 接到你的微信（含「龙虾」直连版）

Overview

Compatibility

已验证

已知限制

Install / Uninstall

安装

升级

禁用

彻底移除

Quick start

最小配置：连真实微信

可复现示例：本地闭环（无需真实微信）

Configuration

Permissions & data

Troubleshooting

常见错误

日志位置

回滚

Development

工作原理

仓库文件

参考资料与替代实现

License & security