前言¶

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