DeepSeek Harness (DSH) 的核心設計是將能力通過插件擴展到不同渠道。對於開發者或用戶而言,直接在微信中與 AI 交互是常見的訴求。dsh-wechat 插件通過將微信聯繫人橋接到 DSH 會話,實現了在微信中調用 DeepSeek 服務的功能。
這是一個由 dAI-aigc 維護的插件,使用 MIT 許可證。它利用騰訊官方的 iLink 通道,將微信聯繫人映射爲獨立的 DSH 會話,允許特定的微信 ID 驅動 DeepSeek Harness 進行回覆。
核心功能¶
- 獨立會話管理:每個微信聯繫人擁有獨立的 DSH 會話(命名格式爲
wechat-<contactId>),確保對話上下文與該聯繫人綁定。 - 多格式傳輸:支持文本、圖片和文件的傳輸,圖片會從 CDN 獲取並掛載到會話,文件會直接讀取。
- 原生打字指示器:支持微信原生的打字狀態顯示,通過獲取票據、發送狀態並定時刷新來實現。
- 白名單機制:通過
allowFrom配置項控制允許驅動代理的微信 ID 列表。默認情況下,僅允許掃碼登錄的賬號,配置爲空數組時即爲“僅允許登錄賬號”。 - 本地運行:登錄流程在本地機器的包目錄中運行,微信端僅需掃碼確認。
安裝與啓用¶
- 安裝插件:
在 Web profile 下安裝該插件:
dsh plugin --profile web add github:dAI-aigc/dsh-wechat
- 本地登錄:
進入插件目錄並安裝依賴、啓動登錄:
cd <package dir>
pnpm install
pnpm login
登錄腳本會在本地 8899 端口提供二維碼頁面,掃描並確認後,憑據將存儲在 `$DSH_HOME/data/dsh-wechat/weixin/` 目錄下。
- 重啓服務:
重啓dsh web以便插件讀取存儲的憑據。
典型用法¶
- 配置白名單:在 DSH 的配置中設置
dsh-wechat.allowFrom。例如,將特定的微信號加入列表以允許其發送消息。 - 交互:從白名單中的微信 ID 發送消息,DeepSeek Harness 將在對應的獨立會話中處理並回復。
- 回覆分塊:回覆內容會被自動分塊,每塊 1800 個字符。
- 查看賬號:在插件目錄運行
pnpm accounts可以列出存儲在本地機器上的賬號列表。
適用場景與注意事項¶
- 權限與安全:插件以當前 dsh 進程的權限運行,請確保對源碼和許可證(MIT)有了解後再安裝。
- 併發限制:一次只能有一個進程進行長輪詢 (
getupdates)。如果手動運行pnpm listen,插件將無法正常工作。 - 功能限制:語音、視頻和轉發卡片會被跳過,且不會顯示警告信息。
- 會話維護:如果遇到錯誤代碼
-14,表示會話過期,需要重新執行pnpm login進行登錄。
該插件適合需要將微信作爲 DeepSeek Harness 交互入口的場景。插件倉庫:GitHub。