DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。dsh-wechat-bridge 是一個由 zxz9988 維護的聯網工具插件,其核心作用是將手機微信接入 DSH 的 AI 助手。該插件使用騰訊官方的 iLink / ClawBot 協議,實現了在微信端與 DSH 進行流式交互的能力。
核心功能¶
插件主要解決了「如何在手機上方便地使用 DSH」的問題,具體能力如下:
- 連接與登錄:支持掃碼登錄,登錄憑證持久化存儲;支持流式回覆,模擬打字機效果。
- 會話管理:爲每個聯繫人維護獨立的 AI 會話,互不串擾;支持會話持久化,DSH 重啓後可恢復上下文。
- 消息處理:支持語音消息轉文字、圖片接收與 OCR、文件接收與解析。
- 排版與回傳:支持將 Markdown 格式轉換爲微信友好的純文本;支持 AI 生成文件後自動回傳到微信。
- 自動化與安全:支持通過 cron 配置定時任務;支持白名單 (
allowFrom) 和管理員 (admins) 權限控制;支持攔截純鏈接消息;具備重試機制與日誌記錄。 - 羣聊支持:代碼層面已支持羣聊,但受限於當前微信 ClawBot 平臺限制,機器人無法被拉入羣聊,因此羣聊功能暫不可用。
安裝與啓用¶
DSH 插件安裝在 profile 中(默認路徑爲 ~/.dsh/profiles/web/)。安裝後,建議重啓 DSH 以確保代碼生效。
方式 A:官方命令安裝(推薦普通用戶)
dsh plugin --profile web add @zxz9988/dsh-wechat-bridge
方式 B:本地鏈接安裝(推薦開發迭代)
cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm add "link:<插件倉庫路徑>"
使用
link:方式安裝後,修改源碼並重啓 DSH 即可生效,無需重複安裝。
配置與用法¶
首次安裝後,插件默認啓用,會自動生成登錄頁面。使用 /help 命令可查看幫助,/new 命令可清空當前聯繫人的對話上下文。
1. 配置權限與任務
可通過 override.json 文件配置白名單、管理員列表及定時任務。該文件位於 ~/.dsh/wechat-bridge/,修改後約 5 秒熱加載。
{
"allowFrom": ["<你的 iLink 用戶 ID>"],
"admins": ["<你的 iLink 用戶 ID>"],
"jobs": [
{
"id": "morning-news",
"cron": "0 7 * * *",
"prompt": "收集今天 AI 行業頭條並總結要點",
"to": "<你的 iLink 用戶 ID>"
}
]
}
2. 可選:網頁抓取(MCP)
若需 AI 在微信中讀取網頁內容,可配置自研的 mcp-fetch 服務器。需在 cordis.patch.yml 中掛載工具 mcp__fetch__fetch。
注意事項¶
- 代碼更新:修改插件源碼後必須重啓 DSH 才能加載新代碼;配置項的修改通常支持熱加載。
- Windows Defender:在 Windows 系統上,Windows Defender 可能會將
lib/index.js誤報爲威脅。如遇此情況,需在安全軟件中將該文件或目錄添加到排除列表。 - 依賴項:插件依賴
wechat-ilink-client(MIT),與 CC-Connect 項目無代碼關聯。 - 羣聊限制:雖然代碼已就緒,但由於平臺限制,目前無法實現機器人入羣。
結語¶
dsh-wechat-bridge 是一個功能完整的微信中轉方案,通過官方協議保證了連接的穩定性。它適合需要在移動端通過微信調用 DeepSeek 能力的場景。項目源碼及文檔可查閱:https://github.com/zxz9988/dsh-wechat-bridge