DSH 插件：WeChat 悬浮球桥接

前言¶

DeepSeek Harness (DSH) 采用了模块化插件架构。lubaiUwU/dsh-wechatclawbot 插件实现了微信客户端的接入，通过本地运行的网关服务，将微信消息中继至 DSH 的智能体进行处理，并支持自动回复。

该方案不依赖 OpenClaw，而是直接使用腾讯官方的 iLink 协议（与 @tencent-weixin/openclaw-weixin 同源）。它为 DSH 提供了一个独立的微信对话区，消息不会混入 GUI 原生会话，适合需要在本地环境运行微信自动化的场景。

核心功能¶

• 扫码即用：通过 GUI 右下角的悬浮球扫码登录，登录凭证本地保存，重启 DSH 后自动恢复登录。
• 独立对话区：微信消息进入独立的对话窗口，上下文连续且不干扰 GUI 原生会话。
• 对话切换：支持通过发送 /new、/新对话 或在悬浮球面板点击「新对话」来切换独立的对话区。
• ClawBot 专用模型：在悬浮球面板配置模型（支持快捷选择或自定义）与思考强度（off/high/max），配置仅对微信回合生效。
• 联系人白名单：默认允许所有联系人，支持在面板对新联系人进行批准或忽略操作。

安装与启用¶

用户无需手动处理复杂的依赖或路径，只需通过 DSH 的自然语言接口或 CLI 命令安装。

1. 用户安装命令

对 DSH 说以下任意一句：

请帮我安装插件 https://github.com/lubaiUwU/DSH-WeChatClawBot

或在终端执行：

dsh plugin --profile <profile> add github:lubaiUwU/DSH-WeChatClawBot

（注：<profile> 需根据实际情况替换，如 desktop 或 web）

2. 安装 Agent 执行步骤

安装过程由 Agent 自动处理，需按顺序完成：

1. 确定 Profile：检测 $DSH_HOME/profiles/ 目录，优先级为 desktop > web > 其他。
2. 执行安装：运行 dsh plugin add 命令。
3. 处理依赖垫片：如果遇到 allowBuilds 错误，编辑 pnpm-workspace.yaml 添加：

    allowBuilds:
      dsh-wechat-clawbot: true

并重新执行安装命令。

4. 重启 DSH：安装完成后必须重启 DSH 或 DSH Desktop 才能加载插件。

典型用法¶

安装并重启后，右下角会出现微信绿色悬浮球，按以下步骤操作：

1. 登录：点击悬浮球，使用手机微信扫码。首次登录可能需要输入验证码。
2. 对话：微信发送消息，消息将直接进入 DSH 的独立微信对话区。
3. 切换：在微信或面板点击「新对话」，开启新的上下文窗口。
4. 配置：在悬浮球面板设置模型密钥和思考强度。
5. 审批：对于新联系人，面板会提示批准或忽略。

环境与架构¶

• 运行环境：
  • Node.js：必须安装 >= 22.19 版本。
  • DSH Desktop：必须通过环境变量 ELECTRON_RUN_AS_NODE=1 拉起网关服务。
• 本地端口：
  • 127.0.0.1:51235：微信网关（负责协议收发与登录）。
  • 127.0.0.1:51236：模型配置端点（悬浮球读写配置）。
• 数据存储：
  • 状态目录位于 ~/.dsh-wechat/，包含登录凭证、白名单、模型配置及会话映射。

适用场景与注意¶

• 适用对象：需要在 DSH 环境下进行微信自动化交互的开发者或个人用户。
• 协议来源：微信接入使用腾讯官方 iLink 协议，核心代码 MIT 许可。
• 风险提示：
  • 仅供学习与个人自动化研究使用。
  • 存在账号风控风险，强烈建议使用小号。
  • 个人微信自动化操作可能导致账号被限制或封禁，使用者需自行评估后果。