dsh-mobile-remote：通過微信遠程控制 DeepSeek Harness

DeepSeek Harness (DSH) 旨在通過插件擴展智能體的能力。在移動端管理智能體或處理即時任務時，直接操作網頁端或命令行往往不夠便捷。dsh-mobile-remote 插件將手機微信轉化爲控制台，讓你在任意網絡環境下通過微信指令控制本地運行的 DSH Agent。

插件簡介¶

該插件名爲 dsh-mobile-remote，由開發者 good-boy4069 維護。它基於騰訊 iLink SDK 協議，實現了 DSH Agent 的遠程微信控制。其核心價值在於利用長輪詢機制實現全出站通信，且不依賴第三方微信 API，能在任意網絡（如 4G、WiFi）下運行。

核心功能¶

• 雙向文件傳輸：支持下載和發送文件，並能自動解密圖片與視頻。
• 主動通知：提供 weixin_send 工具，支持發送文本與文件；支持在任務完成時發送通知。
• 多會話遠程控制：支持列出會話、切換會話。
• 協議對齊：嚴格遵循騰訊 iLink SDK v2.4.6 的協議細節。
• 可觀測性：提供 /health 健康端點和狀態欄，顯示運行狀態。
• 登錄方式：支持二維碼登錄。
• 權限控制：提供全權限模式，邊界由白名單決定。

安裝與啓用¶

使用以下命令將插件安裝到 web 配置文件中：

npx @deepseek-ai/dsh plugin --profile web add dsh-mobile-remote

安裝完成後，啓動或重啓 dsh web 服務：

dsh web

典型用法¶

1. 登錄：在瀏覽器打開 http://127.0.0.1:3080/mobile-remote-weixin/login（需在當前機器上），掃描二維碼綁定微信。
2. 指令操作：登錄後，可通過微信發送以下指令：
   • 查看狀態與工作區：/status, /workspace
   • 管理會話：/new (解綁當前), /sessions (列出), /switch <number-or-title> (切換)
   • 控制任務：/stop (停止), /reply <text> (繼續回覆)
   • 文件操作：/ls [path] (列出目錄), /send <file-path> (發送文件)
3. 文件發送：在模型的回覆中插入 [[send-file:path]]，即可觸發文件發送。

注意事項¶

• 消息傳輸：消息需通過騰訊 iLink 服務器中轉（微信本身無第三方 API），因此非端到端加密。
• 語音消息：語音消息會被拒絕處理，不會存儲或轉錄。
• 權限邊界：全權限模式下，邊界僅由白名單決定，請僅添加自己的微信賬號。
• 登錄限制：登錄頁面僅限迴環地址訪問。
• 日誌文件：插件提供 gateway.log 日誌文件，支持 1MB 輪轉。
• 健康檢查：/health 端點僅允許列出字段，不會泄露內部標識符。

結尾¶

該插件爲 DSH 提供了移動端控制的便捷入口。通過微信即可在任意網絡環境下管理智能體任務與文件。更多細節可查閱 GitHub 倉庫。