前言¶

在 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 仓库。