deepseekplugins

DeepSeek Harness plugin

dsh-weixinbot

DeepSeek Harness 微信 ClawBot（iLink）消息桥插件：微信 ↔ DSH 双向消息通道。

Remote & Mobile
Jump to install

Source facts

Repository
MadDoooog/dsh-weixinbot
Latest update
Aug 15, 2026
Category
Remote & Mobile
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/MadDoooog/dsh-weixinbot
Plugin: dsh-weixinbot
Author: MadDoooog

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-weixinbot

把 DeepSeek Harness（DSH） 接入 微信 ClawBot（腾讯官方 iLink Bot API） 的 DSH 插件： 微信里发消息，DSH 用专属持久 agent 会话（im-wechat-*）回答并回发；DSH / agent 可主动推送通知、审批请求到微信。

  • 接入方式：ilink-direct（插件内置 iLink 协议，扫码登录 + 长轮询 + 发送，零外部服务依赖）
  • 合规：只走微信官方 ClawBot 能力，GUI 始终可用作降级通道

文档

  • [功能设计](./docs/功能设计.md) —— 完整功能设计（架构、功能清单 P0/P1/P2、里程碑）

状态

  • [x] 功能设计 v0.2
  • [x] M1 原型：工程骨架 + ChannelAdapter + ilink-direct 协议客户端 + 扫码 CLI + 文本单向桥（已通过 typecheck 与 17 项单测）
  • [ ] M2 MVP：断网重连打磨、限速队列校验、真实扫码联调
  • [ ] M3 增强：typing、多模态、管理命令完善、审批桥
  • [ ] M4 进阶：群聊、会话 TTL、GUI 微信目录、统计

安装

1. 构建

git clone <本仓库> && cd dsh-weixinbot
npm install        # 安装依赖
npm run build      # 产出 lib/
npm test           # 17 项单测（mock iLink 服务器）

2. 挂载到 profile

dsh plugin --profile web add file:/绝对/路径/dsh-weixinbot

然后把 dsh-weixinbot 加入 profile 的 dsh.profile.bundles（如 $DSH_HOME/profiles/web/package.json）。

3. 微信扫码绑定

node tools/wechat-login.mjs --write          # 扫码，凭据写入 $DSH_HOME/weixinbot/credentials.json
node tools/wechat-login.mjs --patch          # 或直接更新 profile 的 cordis.patch.yml（enabled=true）

4. 配置（profile 的 cordis.patch.yml，覆盖层）

> ⚠️ weixinbot 行由插件 bundle patch 插入，profile 层必须用 id 定向覆盖（非 insert）， > 否则会产生重复 id 导致 loader 报错（duplicate loader entry id）。可用 > node tools/mount.mjs --apply 自动写入，或手写：

- id: weixinbot
  name: dsh-weixinbot
  config:
    enabled: true
    allowUsers:
      - '<你的 userId，扫码输出里有>'   # 空 = 全部拒绝（fail-closed）
    server:
      enabled: true
      port: 3901

5. 生效

dsh web        # 或 dsh --profile <name>

重启后给机器人发一条微信消息即可使用；健康检查：curl http://127.0.0.1:3901/health。

微信命令

命令说明权限
/help帮助白名单用户
/status登录态 / 轮询 / 队列 / 收发统计白名单用户
/whoami你的 ID / 管理员 / 当前会话白名单用户
/new切换到新会话（旧会话保留，可切回）管理员（缺省=白名单用户）
/list列出本会话的所有代次（会话号）白名单用户
/switch <n>切回指定会话号（上下文保留）白名单用户
/cancel取消正在运行的任务管理员
/approve <id> / /reject <id>审批决策（agent 请求批准时）白名单用户

> 会话切换：同一微信会话内，普通消息永远复用当前会话；/new 开启新一代次， > 旧代次连同上下文完整保留，/list + /switch <n> 可随时切回。 > 代次记录持久化在 $DSH_HOME/weixinbot/session-map.json。

M3 增强功能

  • typing「正在输入」：agent 回答期间微信显示输入状态（自动，失败静默降级）
  • 主动通知工具：agent 可调用 wechat_send / wechat_notify 把消息推到你的微信（默认发给你本人）
  • 审批桥：agent 需要批准的操作（如执行危险命令）会推送审批卡片到微信，

回复 /approve <id> 或 /reject <id> 即可决策；超时自动拒绝（fail-closed）

配置项（cordis.patch.yml config: 段）

键默认说明
enabledfalse总开关
adapterilink-direct通道适配器（openclaw-relay 预留）
credentials空botToken/baseUrl/botId/userId；为空回退读 credentials.json
poll.timeoutMs35000getupdates 长轮询超时
poll.retryDelayMs3000轮询出错重试间隔
queue.turnTimeoutMs120000单轮 agent 回答超时
queue.rateLimitPer5min6官方限速窗口（留 1 条余量）
allowUsers[]单聊白名单；空 = 全部拒绝
adminUsers[]管理命令白名单；空 = 沿用 allowUsers
commandPrefix/命令前缀
dsh.cwdhome专属 agent 工作目录
server.port3901健康检查端口
notifier.enabledtrue注册 wechat_send / wechat_notify 工具
approval.enabledtrue审批桥（agent 请求批准 → 微信卡片）
approval.timeoutMs300000审批等待超时（超时自动拒绝）
media.dir$DSH_HOME/weixinbot/media多媒体保存目录
media.maxBytes26214400单个媒体大小上限（25MB）

M3 范围与已知限制

  • typing、主动通知工具、审批桥、多模态接收（图片/语音/文件/视频，CDN + AES-128-ECB 解密后保存，agent 以附件路径方式读取）已实现。
  • 已知限制：

- 语音以原始 SILK 格式保存（silk→wav 转码未内置），agent 直接读文件路径； - 图片尚未以视觉 block 注入模型（设计 R5，需视觉模型支持）； - 主动推送（wechat_send / 审批卡片）不带 context_token，若腾讯端静默丢弃需实测确认。

  • 仅单聊；群聊（F13）降级 P2。
  • 凭据/游标/代次/会话映射持久化：$DSH_HOME/weixinbot/（credentials.json 0600、cursor.json、session-map.json、media/）。
  • 掉线检测（errcode=-14 / 401）→ 日志与健康检查标记，重新扫码即可恢复。

运维

  • 重启：dsh web 是 systemd 用户服务，systemctl --user restart dsh-web（不要用 PID）
  • 联网搜索：微信 agent 的 web_search 工具由 @deepseek-ai/dsh-tool-web 提供，

dsh-web-app 默认禁用；在 profile 的 cordis.patch.yml 按 id 覆盖启用：

``yaml - id: tool-web name: '@deepseek-ai/dsh-tool-web' disabled: false config: fetch: false searchTimeoutMs: 60000 ``

  • 启动通知：notifyOnStart: true 时插件每次启动向绑定者微信推送「启动好了」（进程级去重）
  • agent 自重启 + 续跑：agent 需要重启自己时，先写续跑标记

$DSH_HOME/weixinbot/pending-continuation.json（含自己的 DSH_SESSION_ID 与待办）， 再委托 claudecode（systemd-run --user 独立 unit，重启不杀它）执行 systemctl --user restart dsh-web；新实例启动后插件读到标记，向该会话注入 「重启完成通知」唤醒 agent 继续待办（成功才删标记，失败保留重试）。 辅助脚本：node tools/self-restart.mjs "<重启后待办>"。 ⚠️ 续跑回合只挂载 dsh 工具（如 web_search），无 bash/文件等宿主工具—— 重活会在用户下一条消息（工具齐全）时继续。

  • 健康检查：curl http://127.0.0.1:3901/health；日志：journalctl --user -u dsh-web

参考

Back to searchOpen GitHub repository

More related plugins

View category