canadaeee/dsh-weixin

dsh-weixin

属于 DSH 生态系统 的一部分——基于 DeepSeek Harness (DSH) 插件架构构建的频道插件。

用于 DeepSeek Harness (DSH) 的个人 微信 频道插件——将 dsh 变成一个微信机器人，每个聊天对端对应一个长期存活的 Agent（真正的滚动记忆，会刷写到磁盘）。

工作原理

此插件直接与微信官方的 iLink Bot API 通信（与腾讯的 @tencent-weixin/openclaw-weixin 网关插件背后的协议相同）。它将该腾讯维护的包用作纯协议库——没有 OpenClaw 网关、没有转发、没有云中继——并用 DSH Agent 替换了网关胶水层：

你的微信 ⇄ 腾讯 iLink API ⇄ 此插件（getUpdates 长轮询）
└→ 每个对端一个常驻 DSH Agent
通过 sendMessage 回复

- 首次启动时扫码登录：二维码链接会打印到日志并写入 /login-qr.txt（可渲染它或在微信中打开）。该流程会自动刷新过期的二维码并重试。
- 凭据存储在 /state/openclaw-weixin/accounts/.json（0600 权限），通过 OPENCLAW_STATE_DIR 与任何 OpenClaw 安装隔离。
- 入站：每条文本消息都会唤醒该对端的 Agent（惰性创建，记忆跨越进程生命周期；会话持久化到 DSH 会话存储）。
- 模型：使用宿主机的默认模型选择（~/.dsh/settings.yaml 中的 agent-default-model）。
- 具备韧性：长轮询超时和传输错误会以指数退避（5s→120s）并重新连接。

安装

1. 将 bundle 放到 DSH 解析 bundle 的位置，例如运行时安装目录：
cp -R dsh-weixin ~/.dsh/runtime/node_modules/dsh-weixin
（加上协议依赖，见下一步）

2. 将 iLink 协议库安装到同一运行时：
cd ~/.dsh/runtime
npm install @tencent-weixin/openclaw-weixin@2.4.6 openclaw
（openclaw 用于满足该库 logger 中的一个工具导入；
不会启动或使用任何网关）

3. 创建 ~/.dsh/profiles/weixin/package.json：
{
"name": "dsh-profile-weixin",
"private": true,
"dependencies": {},
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "dsh-weixin"] } }
}
再加上空的 cordis.yml（[]）、cordis.patch.yml（[]）、pnpm-workspace.yaml。

4. 启动：
dsh --profile weixin

首次启动时会打印一个二维码链接——用手机微信扫描、确认，
然后桥接进入轮询循环。后续启动会复用已保存的 token。

配置（可选，通过 profile 的 cordis.patch.yml）

- id: weixin-bridge
config:
rootDir: ~/.dsh/weixin-channel   # 状态 + 工作区根目录
accountId: default               # 逻辑账户标签
loginTimeoutSeconds: 240         # 每次尝试的二维码等待时间
minBackoffSeconds: 5             # 传输退避下限
maxBackoffSeconds: 120
maxReplyChars: 3800              # 出站回复上限

注意事项与限制

- 每个微信账号全局只能有一个 iLink 连接 —— 在此桥接运行期间，不要在同一账号上运行另一个微信网关（OpenClaw、Hermes、hermesclaw……），否则令牌会冲突（403 错误／消息丢失）。
- v0.1 仅支持文本消息（协议库也支持图片／语音／文件——媒体处理是自然的下一步）。
- 自己发送的消息不会到达机器人频道；请从另一个账号进行测试。
- 回复延迟 = 模型回合时间（通常为几十秒）；iLink 侧在 v0.1 中尚未接入输入指示器。

许可证：MIT 风格，随你怎么用；无任何担保。