deepseekplugins

DeepSeek Harness plugin

dsh-wechat-pro

DeepSeek Harness 进程内微信 ClawBot 通道插件：扫码连接、工作区/会话切换（与 Web 共享真实 DSH 会话）、/model /thinking、harness 原生命令、工具审批转发微信、过程事件流 + 长文分片输出、媒体收发、24h 自动续连。

Remote & Mobile
Jump to install

Source facts

Repository
bwhite55/dsh-wechat-pro
Latest update
Aug 16, 2026
Category
Remote & Mobile
GitHub stars
1
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/bwhite55/dsh-wechat-pro
Plugin: dsh-wechat-pro
Author: bwhite55

Check the source files

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

File explorer3 files
README.mdSource · read only

dsh-wechat-pro

DeepSeek Harness 进程内微信 ClawBot 通道插件：把 DSH 变成微信里的一只「龙虾」🦞。

  • 扫码即用：腾讯官方 iLink 通道（个人微信免白名单），二维码打印在 dsh web 终端，凭证 24h 自动续连 + 到期提醒；
  • 与 Web 共享真实会话：微信里新建/切换的会话就是真实 DSH 会话，出现在 Web 会话列表、可跨端续接（Codex 式附着）；
  • 工作区：/workspace 在注册工作区间切换，/workdir <路径> 切换任意工作路径（自动注册为工作区，Web 同源可见）；
  • 模型与思考强度：/model、/thinking 按会话切换，下一轮生效（走 Web 同款宿主 apiProxy）；
  • 原生命令：/plan、/permission、/compact、/goal、/feedback、/export 等 harness 原生命令直接在微信执行；
  • 审批转发微信：高风险工具调用（跨目录写入等）在微信里推送审批提示，回复 /yes 允许 / /no 拒绝即可；多个待审批同时存在时回复「允许 <4位码>」精确选择（提示里会给出）；
  • 流式输出：思考/工具调用过程事件实时推送，最终答复长文自动分片；
  • 媒体收发：/send 发电脑文件到微信；微信图片/文件/视频/语音自动下载解密落盘；
  • 主动能力：agent 可用 weixin_send 工具随时推送消息到微信。

架构：微信通道与宿主 apiProxy 都跑在 dsh web 进程内；会话事件经 session/event 订阅实时镜像到微信。不需要 OpenClaw、不需要公网服务器、不需要独立进程。

安装

方式一：从 GitHub 安装（推荐，发布后）

dsh plugin --profile web add github:bwhite55/dsh-wechat-pro
dsh web

方式二：本地源码（开发/修改）

# 1. 构建
cd D:\dsh-wechat-pro
pnpm install
pnpm run build

# 2. 装进 web profile（link 方式，改源码后重新 build 即生效）
dsh plugin --profile web add link:D:\dsh-wechat-pro

# 3. 重启 dsh web
dsh web

重启后 dsh web 终端会打印登录二维码（或已有凭证自动连接）。手机微信「我 → 设置 → 插件」添加 ClawBot/龙虾，扫二维码配对后即可对话。

> 隐藏窗口运行 dsh web 时（如 start-dsh-web-hidden.vbs）终端看不到二维码： > 浏览器打开 http://127.0.0.1:3080/api/dsh-wechat-pro/status，响应里的 qrLink > 就是当前登录二维码链接（手机微信打开即可扫码）；POST /api/dsh-wechat-pro/connect > 可强制重新扫码。

指令

| 指令 | 作用 | |---|---| | /help | 指令列表 | | /status | 连接、工作区、会话、模型状态 | | /time | 连接剩余时间 | | /workspace | 切换工作区（回复数字选择） | | /workdir <路径> | 切换任意工作路径（自动注册为工作区） | | /sessions | 当前工作区会话列表（回复数字切换/附着；📌=微信书签） | | /new <名字> | 当前工作区内新建会话并切换（Web 会话列表可见） | | /switch <名字> | 切换命名会话（main = 默认） | | /attach <序号\|会话ID> | 附着 Web 已有会话（同轨迹双向可见） | | /clear [名字] | 删除微信书签（真实会话与日志保留在 Web） | | /unbind | 停止接收当前会话的推送 | | /model | 切换模型（回复数字选择，下一轮生效） | | /thinking | 切换思考强度 off/high/max（回复数字选择） | | /level [级别] | 输出等级：minimal=只收最终答复与错误 / normal=思考+工具调用/结果+答复 / verbose=完整工具参数（按联系人持久化） | | /send <路径> [说明] | 发电脑文件到微信（相对路径按会话工作区目录） | | /reconnect | 重新扫码续连 | | /cancel | 取消当前回合 | | 其他 /xxx | 若为 harness 原生命令（/plan /permission /compact 等）直接执行 |

配置

插件配置在「设置 → 插件配置 → dsh-wechat-pro」或 cordis.patch.yml 的 config 段， 也支持环境变量（DSH_WXBOT_*，测试时可指向本地 mock）：

键 / 环境变量默认说明
autoConnecttrue启动时已有凭证自动连接
allowFrom / DSH_WXBOT_ALLOW_FROM空微信用户白名单（逗号分隔的 from_user_id；空 = 全部，建议设置）
dataDir / DSH_WXBOT_DATA_DIR$DSH_HOME/dsh-wechat-pro凭证/联系人注册表/媒体目录
baseUrl / DSH_WXBOT_BASE_URLhttps://ilinkai.weixin.qq.comiLink 端点（测试可指向 mock）
replyMaxChars / DSH_WXBOT_REPLY_MAX3800单条微信消息上限，超出分片（env 优先）
streamLevelnormal默认输出等级（minimal/normal/verbose；微信内可 /level 覆盖）
mirrorWebTurnsfalseWeb 发起的回合是否也推送到微信（默认只推微信发起的回合）
replyTimeoutMs / DSH_WXBOT_REPLY_TIMEOUT_MS300000单轮回复超时（env 优先）
announceToAgenttrue是否在系统提示词声明插件能力

输出等级与推送范围

  • /level（微信内即时切换，按联系人持久化）：

- minimal（默认，推荐）— 只推最终答复与错误（不含任何过程消息）； - normal — 思考（🤔）+ 工具调用（🔧）/结果（✅）+ 最终答复； - verbose — normal + 完整工具参数与结果（不截断）。

  • 回合来源：只有微信发起的回合会推送到微信；Web 端在同一会话发起的对话默认不推送（mirrorWebTurns: true 可改为也推送）。判断依据：该回合的触发消息是否带浏览器时区（微信侧不带）。
  • ⚠️ 腾讯发送额度限制（重要）：实测腾讯 iLink 对单条入站消息的回复发送有额度限制——过程消息刷屏（normal/verbose 下每个工具调用都推一条）会触发 sendMessage ret=-2 prepare failed，后续所有发送（含最终答复）都会被拒。因此默认 minimal（每回合只发最终答复+错误，最可靠）。若确实想看过程，可 /level normal，同时过程消息上限 maxProcessPerTurn（默认 3）会尽量为最终答复留额度，但不能保证。
  • 长度限制与超长回复降级：微信单条消息约 2048 字符限制，replyMaxChars 默认 3800（超出自动分片，每片间隔 1s）。最终答复分片预算 maxReplyChunks（默认 8 片）：分片数在预算内正常发送；超预算时降级为「首片 + 完整内容落盘为文件发给你」（一条媒体消息，不占文本条数额度，完整内容必达）。文件存于 dataDir/outbox/。
  • 发送可靠性：最终答复/审批提示等关键消息发送失败会自动重试一次；所有发送失败都会追加到 dataDir/logs/wechat-pro.log（隐藏窗口启动时这是唯一可查的发送痕迹，ret=-2 prepare failed 即额度/上下文被拒）。

数据与安全

  • 凭证 weixin-auth.json 含 bot token（= 以你微信身份收发消息的凭据），勿外传；
  • 每联系人注册表存于 dataDir/contacts/<key>.json（当前工作区 + 命名会话书签）；
  • 微信来的媒体解密后存 dataDir/media/<key>/；发送失败日志存 dataDir/logs/wechat-pro.log；
  • 控制路由（/api/dsh-wechat-pro/*）仅监听回环地址，LAN 暴露会被拒绝；
  • 建议保持 DSH 自身权限为 workspace-write，并用 allowFrom 只放行自己的微信号。

开发与测试

pnpm run typecheck   # 类型检查
pnpm run build       # tsc 构建到 dist/
node tests/test-mock-ilink.mjs --port 8899   # 起 mock iLink（登录/收发闭环）

自动化测试（无需真实微信）：

node tests/channel-smoke.mjs   # 通道冒烟：引擎直连 mock（登录/轮询/typing/回复/媒体接收）
node tests/e2e-harness.mjs     # harness 集成：侧路 dsh web + mock 队列，命令层端到端
node tests/e2e-chat.mjs        # 真实模型 e2e：对话/流式/审批转发/长文分片//model（需 DEEPSEEK_API_KEY，消耗少量配额）

侧路 dsh web 约定：DSH_E2E_WEB_PORT=3099（默认）、DSH_E2E_MOCK_PORT=8898（默认）、DSH_E2E_TIMEOUT（秒）。

本地闭环（手动，无需真实微信）：

# 终端 A：mock iLink
node tests\test-mock-ilink.mjs --port 8899

# 终端 B：带插件的 dsh web（另一端口 + mock 端点 + 隔离数据目录）
$env:DSH_WEB_PORT = "3099"
$env:DSH_WXBOT_BASE_URL = "http://127.0.0.1:8899"
$env:DSH_WXBOT_DATA_DIR = "D:\dsh-wechat-pro\.test-data"
dsh web

许可

MIT

Back to searchOpen GitHub repository

More related plugins

View category