前言¶
DeepSeek Harness (DSH) 是一個基於插件構建的智能體運行環境。本地任務執行通常需要打開終端或管理後臺，而手機端的微信是觸手可及的交互入口。zhy5/dsh-wx-bridge 插件通過騰訊 iLink 通道將手機微信接入本機 DSH，讓微信內的消息直接驅動本地執行任務。
插件介紹¶
- 定位：聯網工具類插件，負責打通微信與本地 DSH 之間的指令通路。
- 維護者：zhy5
- 協議：MIT
- 核心價值：把手機微信變成一個控制台，通過審批、推送和指令執行，實現遠程或移動端對本地 DSH 的控制。
核心功能¶
- ACP 原生會話集成：不再由插件拼接上下文，而是直接交給 DSH 的 Agent Client Protocol (ACP) 處理。每個微信聯繫人或檔位對應一條獨立會話，重啓後可恢復，上下文不丟失。
- 審批與推送：支持微信內審批應答（1.1.0 新增），任何需要越權或特殊權限的操作會以審批卡片形式推送到微信，回覆即可批准或拒絕。支持主動推送，任何進程可通過命令將消息推送到手機。
- 內核組件：內置零依賴的
bridge.mjs（iLink 長輪詢收發 + ACP 會話執行）與keeper.mjs（存活自檢 + 脫樹重啓）。 - 管理與控制：提供實時狀態面板與預設管理，支持通過 HTTP 接口控制橋進程與配置。
安裝與啓用¶
使用官方安裝命令添加插件。注意：插件原名 @zmainer/wxbridge，自 1.0.8 起改名爲 @zmainer/dsh-wx-bridge（舊包已棄用）。
dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
安裝後，確認 profile 的 package.json 裏 dsh.profile.bundles 包含 @zmainer/dsh-wx-bridge（若 pnpm 構建腳本非零退出，可能被跳過，需手工追加）。
典型用法¶
推送消息：
node "<dataDir>/wxpush.mjs" --text "跑完了：1442 條全部落庫"
微信內指令：
- /預設 自檢：驗證當前檔位是否按預設組裝。
- /審批 詢問|自動|拒絕：切換審批策略。
- /sessions：列出並接上 DSH 已有會話。
注意事項¶
- 數據安全：數據經騰訊 iLink 通道傳輸，不得用於涉密內容。
- 權限保護：狀態與憑據文件爲明文，僅靠 ACL 保護。
- 默認策略：審批默認 120 秒未回按拒絕；准入默認 strict（未登記不執行）。
- 版本：當前版本 1.1.8。
結語¶
該插件通過原生會話與審批機制，解決了移動端控制本地任務的安全性與上下文連貫性問題。適合需要在移動端遠程執行本地任務或利用微信作爲控制入口的場景。
