前言¶

DSH 的 agent 能力通常从 GUI 进入。如果希望从微信私聊触发 DSH agent、查看状态、切换工作区或会话，就需要一个把微信消息桥接到 DSH 的入口。

下面介绍 dsh-wechat。它的定位是：通过腾讯 iLink bot 协议，把微信私聊桥接到 DSH agent，让微信成为 DeepSeek Harness (DSH) 的第二客户端。

这是什么¶

dsh-wechat 由 pan17 维护，是一个 DSH 插件。它把微信私聊接成 DSH agent 的第二客户端。

它主要解决这些问题：

• 微信里的文本、图片、文件、语音消息可以进入 DSH agent。
• DSH agent 的文本回复可以回到微信。
• 微信内可以用 slash 命令处理常用管理动作。
• 微信端与 GUI 端可以弹出一致的审批/提问卡。
• DSH 设置页内嵌扫码登录、状态查看与连接配置。

许可证为：

MIT

核心功能¶

发送与接收¶

微信消息可以发送到 DSH agent，包括文本、图片、文件、语音。

媒体会先落到本地路径：

~/.dsh-wechat/tempfile/

下载解密后，本地路径作为附件注入 DSH agent。

agent 的文本回复会回到微信。

主动推送工具为：

send_wechat

它可用于向微信推送文本或文件。

微信内命令¶

以下 slash 命令由 bridge 直接处理：

/workspace
/session
/preset
/model
/perm
/silent
/notify
/next
/status
/stop
/rp
/rq

审批/提问卡¶

微信与 GUI 会弹出一致的原生审批/提问卡。

规则是：谁先回复谁生效。

微信渠道提示词¶

微信消息会注入“通过微信”提示。

当消息来自 GUI 时，这个提示自动消失。

静默与繁忙投递¶

静默模式命令为：

/silent on

开启后，每轮只发送最终回复。设置页也可以切换。

繁忙时投递按以下设置项排队或插话：

busyEnter

微信侧有同步命令：

/enter

跨会话通知¶

跨会话通知命令为：

/notify on|off|status

默认关闭。

登录、设置与会话恢复¶

二维码登录地址为：

http://127.0.0.1:3080/wechat/qr

该登录入口内嵌在设置页中。

设置页位于：

DSH 设置 → WeChat

页面展示状态、扫码、退出登录、连接配置与通知/静默开关。

断点续传会持久化：

sync-buf

以及微信会话映射。重启 DSH 后自动恢复会话。

单用户模式下，插件只服务第一个微信用户。

安装与启用¶

先安装到指定 DSH profile，再重启 DSH，最后扫码登录。

1、安装插件：

npx @deepseek-ai/dsh plugin --profile <profile> add dsh-wechat

插件从 npm 官方源安装，dsh plugin add 即 pnpm add dsh-wechat。

2、注意命令名。不要使用：

npx dsh plugin

原因是 npm 上 dsh 名字被不相关的 JS shell 包占用，且没有暴露 CLI bin。DSH CLI 在 scoped 包下：

@deepseek-ai/dsh

所以必须使用完整名。

3、重启 DSH 后启用：

• 浏览器打开 DSH 设置 → WeChat，扫码登录、查看状态、改配置。
• 或直接打开：

http://127.0.0.1:3080/wechat/qr

进行扫码。

升级命令：

npx @deepseek-ai/dsh plugin --profile <profile> update dsh-wechat

修改代码后需重启 DSH，改动才会生效。

典型用法¶

安装并登录后，可以直接在微信里发送命令。

查看当前状态：

/status

查看工作区：

/workspace list

切换工作区：

/workspace switch <编号|路径>

添加工作区：

/workspace add <路径>

新建会话：

/session new

切换会话：

/session switch <编号>

查看模型：

/model list

切换模型：

/model switch <提供商/模型>

开启静默：

/silent on

继续发送因微信限制被缓存的消息：

/next

agent 侧也可以通过：

send_wechat

主动推送文本或文件到微信。

适用场景与注意¶

适合希望从微信私聊触发 DSH agent 的单用户场景。适合需要在微信里查看状态、切换工作区、切换会话、切换模型，以及处理审批或提问卡的使用者。

需要注意：

• 单用户模式下，只服务第一个微信用户。
• bot token 缺失或失效时，不向微信推送，日志会写明原因。
• 工具：

send_wechat

对所有 agent 可见，任何会话的 agent 都能调用。

• 单用户模式下，工具推送与 assistant 回复共享唯一一份微信 10 条/窗口限流预算。
• 超限或发送失败会自动进入：

/next

FIFO 缓存队列。

• 微信真实限流响应也会被识别并缓存：

HTTP 200 + ret: -2 / prepare failed

不再误判成功。

• 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。
• dsh-wechat 来自社区目录。目录站是独立站点，不应理解为 DeepSeek 官方应用商店。

结尾¶

dsh-wechat 的价值在于把微信私聊变成 DSH 的第二客户端：微信消息可以进入 agent，agent 结果可以回到微信，常用管理动作也能在微信里完成。

• GitHub：https://github.com/pan17/dsh-wechat
• 目录页线索，未核实：https://www.skillhub.cn/plugins/pan17/dsh-wechat