前言¶
DeepSeek Harness（DSH）用戶在使用智能體時，常需要通過微信進行交互。傳統的接入方式通常需要搭建額外的代理服務或手動管理令牌。dsh-weixin 插件旨在解決這一問題，它允許用戶通過微信掃碼直接將機器人接入 DSH，並在 Host 進程內處理消息流轉。
是什麼¶
這是一個由 xmanrui 維護的工作流插件，用於將騰訊微信機器人接入 DeepSeek Harness。插件運行在 dsh web 的 Host 進程內：瀏覽器端僅負責顯示一次性二維碼和脫敏狀態；掃碼後得到的 bot_token 會直接寫入 Harness 的憑據服務，隨後由 Host 通過騰訊 iLink Bot API 進行長輪詢，實現消息的收發。
安裝與綁定¶
在安裝前，請確保滿足以下前提：
* DeepSeek Harness 版本爲 0.1.0-rc.6，運行環境 Node.js >=22.19；
* 手機微信賬號已開通微信機器人功能（該功能由騰訊分批開放，插件代碼無法繞過）；
* 運行 Harness 的設備能夠訪問 *.weixin.qq.com。
執行以下命令進行安裝：
npx -y github:xmanrui/dsh-weixin install
安裝完成後重啓 dsh web，然後按以下步驟綁定：
- 打開「設置 → 插件 → 微信」；
- 點擊「掃碼綁定微信」；
- 使用手機微信掃描頁面上的二維碼，並在手機上確認；
- 如果手機顯示配對數字，在 Harness 頁面輸入該數字；
- 頁面顯示“運行正常”後，即可在微信中向已綁定的機器人發送消息。
功能與消息行爲¶
- 多賬號隔離：支持重複掃碼添加多個微信賬號。每個賬號擁有獨立的憑據引用、長輪詢、同步游標、消息去重記錄和 Harness 會話映射。
- 消息支持：支持文字消息，以及微信已附帶文字識別結果的語音消息。當前不處理圖片、文件、視頻或無轉寫語音。
- 會話映射：每個微信用戶映射到一個持久 Harness 會話，支持連續對話。
- 命令：在微信中發送
/new可清除當前會話映射，/status用於檢查連接狀態，/help顯示幫助信息。
注意事項¶
- 項目狀態：項目已不維護，作者建議遷移至功能更全的
dsh-im插件。 - 安全設計：
bot_token不會發送給瀏覽器，僅保存在 Host 進程的憑據服務中。刪除賬號會同時停止該賬號的長輪詢、清理憑據、配置和會話映射。 - 網絡依賴：Host 進程必須能夠訪問
*.weixin.qq.com。 - 權限限制：僅接受掃碼確認用戶發來的私聊消息，其他用戶默認拒絕。
總結¶
dsh-weixin 提供了一種將微信集成到 DeepSeek Harness 中的原生方式，核心優勢在於 token 的安全存儲和 Host 進程內的消息處理。對於需要通過微信進行簡單文本交互的用戶，該插件提供了直接的解決方案。
