前言¶
DeepSeek Harness 微信連接插件是一個客戶端插件，用於將微信賬號接入 DeepSeek Harness。插件運行在 dsh web 的 Host 進程內：設置頁只負責顯示一次性二維碼和脫敏狀態，掃碼得到的 bot_token 直接寫入 Harness 憑據服務，隨後由 Host 通過騰訊 iLink Bot API 長輪詢收消息並把回答發回微信。該插件由 1841220388zzzcccxxx-star 維護，採用 MIT 許可證。
前提條件¶
使用前需滿足以下環境要求：
* DeepSeek Harness 版本：0.1.0-rc.6
* Node.js 版本：>=22.19
* 手機微信賬號需已開通機器人功能（騰訊分批開放，若微信裏尚未出現相關入口，請先檢查「我 → 設置 → 插件」；該功能由騰訊分批開放，插件代碼無法繞過賬號側的開放範圍）
* 運行 Harness 的設備能夠訪問 *.weixin.qq.com
安裝與掃碼綁定¶
- 執行安裝命令：
npx -y github:1841220388zzzcccxxx-star/dsh-wechat install
- 重啓
dsh web。 - 打開「設置 → 插件 → 微信」。
- 點擊「掃碼綁定微信」。
- 使用手機微信掃描頁面上的二維碼，並在手機上確認。
- 如果手機顯示配對數字，在 Harness 頁面輸入該數字。
掃碼成功後必須同時滿足以下條件，頁面纔會顯示在線：
1. 騰訊 iLink 返回 bot_token、機器人賬號 ID、掃碼用戶 ID 和消息 API 地址。
2. bot_token 已寫入 Harness Host 憑據服務。
3. 非敏感賬號配置已原子保存。
4. 微信 notifystart 驗證通過並啓動 getupdates 長輪詢。
5. 插件能訪問當前 Harness Host。
可以重複掃碼添加多個微信賬號。每個賬號擁有獨立憑據引用、長輪詢、同步游標、消息去重記錄和 Harness 會話映射；一個賬號重連或移除不會影響其他賬號。
核心功能¶
- 消息支持：支持文字消息，以及微信自帶轉寫結果的語音消息。目前不支持圖片、文件、視頻或無轉寫語音。
- 多賬號隔離：支持添加多個微信賬號。每個賬號擁有獨立憑據引用、長輪詢、同步游標、消息去重記錄和 Harness 會話映射；一個賬號重連或移除不會影響其他賬號。
- 安全設計：瀏覽器永遠不會收到或提交
bot_token、二維碼內部令牌、掃碼用戶 ID 或憑據引用。bot_token只保存在 Harness Host 憑據服務中。微信消息 API 地址必須是https://weixin.qq.com或其子域，且只能使用默認 HTTPS 端口。
消息交互¶
掃碼綁定成功後，可以在微信中向已綁定的機器人發送以下命令：
* /new：清除當前會話映射。
* /status：檢查連接狀態。
* /help：顯示幫助信息。
Harness 回答較長時會拆成多條微信文本，每條都沿用入站消息的 context_token。
本地驗證¶
源碼安裝後可進行本地驗證：
npm run check
該命令會運行測試並檢查包結構。若僅需驗證騰訊掃碼端點兼容性，可執行：
npm run verify:protocol
注意事項¶
- 消息範圍：只接受掃碼確認用戶發來的私聊消息，其他用戶默認拒絕。
- 運行環境：插件以當前 Harness Host 進程的權限運行，安裝前請檢查源碼與許可證。
- 協議限制：微信消息 API 地址必須是
https://weixin.qq.com或其子域，且只能使用默認 HTTPS 端口。
總結¶
該插件通過微信掃碼將騰訊微信機器人接入 DeepSeek Harness，實現了多賬號隔離與安全憑據管理，適合需要在微信環境中使用 DeepSeek Harness 能力的場景。
詳細文檔與源碼請參考：
* DeepSeek Harness 插件目錄
* GitHub 倉庫
