DeepSeek Harness 微信接入插件 (dsh-wechat-suite)

DeepSeek Harness (DSH) 是一個基於插件架構的智能體開發與運行框架。開發者通常需要在微信端與智能體進行對話、監控運行狀態或進行人工審批。dsh-wechat-suite 插件通過騰訊的 iLink 協議，將 DSH 的 Profile 連接到微信個人賬號，實現無需公網 IP 和端口轉發的雙向通信。

是什麼¶

這是一個將 DSH Profile 連接到微信個人賬號的插件包。它利用騰訊的 ilinkai.weixin.qq.com 網關實現通信。插件包含兩個核心組件：
* wechat-gateway：處理 iLink 服務，包括二維碼登錄、認證長輪詢、重連/退避、發送重試與限流熔斷、輸入指示器、加密 CDN 媒體傳輸及入站消息去重。
* wechat-conversation-node：微信與 DSH 的橋接層，負責會話定向、命令執行、上下文輪換以及多模態媒體處理。

核心功能¶

消息與媒體支持：支持雙向文本、圖片、語音、文件、視頻傳輸。集成 OCR（文字識別）、STT（語音轉寫）、TTS（文本轉語音）、圖片生成及視頻處理能力。
連接與可靠性：提供二維碼登錄、認證長輪詢。具備自動重連/退避機制、發送重試、限流熔斷、輸入指示器。媒體下載/上傳通過加密 CDN 進行，支持入站消息去重。
會話與控制：支持會話定向、命令執行、上下文輪換。提供智能體審批、提醒、早間天氣、摘要導出及燈光控制功能。
多平臺與運維：支持微信與 QQ 雙平臺，統一管理。提供獨立的管理控制台，支持前端編輯即時生效。YAML 配置保存後不會破壞 Profile。

安裝與啓用¶

環境準備：確保安裝了 Node.js >= 22、pnpm，並擁有一個 DSH Profile 和一個專用的微信賬號。
安裝插件：

    dsh plugin --profile <your-profile> add github:PRTS168/dsh-wechat-suite

賬號綁定：

    pnpm login

掃描生成的二維碼以登錄微信賬號，系統將存儲 `WEIXIN_BOT_TOKEN`、`WEIXIN_ACCOUNT_ID` 等憑據。

配置：

    pnpm setup

填充 `allowFrom` 允許列表條目及其他必要憑據。

典型用法¶

安裝並配置完成後，重啓 dsh web，向微信發送消息即可與智能體交互。若需管理控制台，運行：

node admin/server.ts

控制台將運行在 http://127.0.0.1:8790/（Token 將生成在 admin/.admin-token）。

注意事項¶

單實例限制：iLink 協議對每個賬號只允許一個認證輪詢器。在同一微信賬號上運行第二個實例會導致 HTTP 403 並丟失消息。
賬號風險：建議使用專用微信賬號，將其視爲一次性賬號，騰訊可能會隨時限制該賬號。
必要配置：必須配置 allowFrom 允許列表條目，以及 WEIXIN_BOT_TOKEN、WEIXIN_ACCOUNT_ID、WEIXIN_BASE_URL 憑據。缺少這些配置插件將保持空閒。
預設文件：插件不包含 Persona 預設，需將 agentPreset 指向自己目錄下的預設（如 $DSH_HOME/.agent-presets/<name>/）。

結語¶

該插件通過封裝 iLink 協議，爲 DSH 提供了在微信端的完整交互能力。對於需要在移動端或微信生態內部署和管理智能體的開發者，這是一個可行的解決方案。更多細節可參考 GitHub 倉庫。