前言¶

在 DeepSeek Harness（DSH）的插件生態中，連接非 WSL 環境的設備（如手機、IoT 設備或遺留系統 Agent）通常需要針對特定平臺開發客戶端。dsh-device-bridge 是一個通用的 Companion 協議客戶端，作爲 dsh-wsl-kit 的可選配套插件，提供標準的 HTTP 接口，用於接入各類設備。

插件介紹¶

該項目由用戶 173787247 維護，採用 MIT 許可證。它並不在 install.sh 腳本中，需要手動安裝。其設計目的是讓任何實現 /v1/health 和 /v1/invoke 接口的設備都能接入 DSH 體系，與 dsh-mac-companion 共用同一協議，SSH 直連則使用 dsh-remote-ssh。

核心功能¶

該插件提供以下 DSH 插件命令：

• device_list：列出已配置的設備。
• device_status：發送 GET 請求到 /v1/health，檢查設備健康狀態。
• device_invoke：發送 POST 請求到 /v1/invoke，調用設備操作（動作受白名單限制）。

安裝與啓用¶

安裝前請確保 Node.js 版本大於等於 18。

dsh plugin --profile web add github:173787247/dsh-device-bridge

安裝完成後，可通過以下命令運行示例服務：

python3 companion/mock_server.py --port 18766 --kind phone

典型用法¶

對於輕量級設備（如 Android Termux），可以使用 Python 標準庫提供的示例代碼：

python3 examples/termux-companion.py --port 18767

配置文件位於 examples/devices.cordis.snippet.yml。注意：手機上的聊天入口仍由 dsh-wsl-im 負責，本插件僅負責設備側的能力實現。

適用場景與注意¶

• 可選配套：這是一個可選插件，不包含在 install.sh 中，需手動安裝。
• 環境要求：需要 Node.js >= 18。
• 權限與許可：安裝前請檢查源碼與許可證。
• 協議標準：接入設備需實現標準的 Companion 協議接口。

總結¶

通過 dsh-device-bridge，開發者可以統一管理手機、IoT 及遺留 Agent 的接入。更多細節請參考 GitHub 倉庫。