DeepSeek Harness（DSH）是一个本地运行的智能体开发环境。如果你需要在手机上查看对话、插入消息或控制会话，单纯使用桌面端会不方便。dsh-openai-bridge 插件提供了一个 OpenAI 兼容的 HTTP 接口，让运行在手机上的 Chatbox 应用能够直接操作本地 DSH 会话。
插件名称为 dsh-openai-bridge，仓库位于 github.com/AprilCrystal/dsh-remote。它将 DSH 的能力封装成标准的 OpenAI API 格式，并附带一个轻量级的移动端控制面板。
核心功能¶
- OpenAI 兼容接口：提供
/v1/models和/v1/chat/completions端点，同时支持流式和非流式请求。 - 移动端控制：允许手机端通过 Chatbox 驱动桌面 DSH 会话，提供思考、复制、停止消息、插入消息等面板功能。
- 会话管理：支持查看任意会话的记录，切换模型，以及监控和压缩上下文。
- 文件与沙箱：支持浏览和暂存文件，允许通过桌面端显示的代码更改沙箱预设。
- 审批转发：当会话尝试写入文件或执行敏感操作时，审批请求会转发到连接的浏览器客户端。
安装与启用¶
在安装之前，请确保你已经配置好 DeepSeek Harness 的 profile。
- 执行以下命令安装插件：
dsh plugin --profile <your-profile> add github:AprilCrystal/dsh-remote
该插件无需编译，安装过程不会强制执行构建脚本。
- 配置 Token：插件需要一个随机密钥作为访问凭证。你可以通过环境变量或配置文件设置：
DSH_OPENAI_BRIDGE_TOKEN=<a-long-random-secret>
也可以在 profile 的 `cordis.patch.yml` 中配置。
典型用法¶
1. 获取配置信息
首次使用时，在本地浏览器访问 http://127.0.0.1:19387/setup（该路由仅限本机访问，其他网络请求会返回 403）。页面会显示本机局域网 IP、端口号以及 Token 的生成方式。
2. 配置 Chatbox
在手机的 Chatbox 应用中，设置自定义 OpenAI 兼容提供商：
| 配置项 | 填写值 |
|---|---|
| API Key | $DSH_HOME/openai-bridge.token （或环境变量中的 Token 值） |
| API Host | http://<this-machine-lan-ip>:19387/v1/ |
| Model ID | dsh-agent |
3. API 调用示例
安装后，/v1/models 会返回一个名为 dsh-agent 的模型，以及当前所有 DSH 会话的列表（格式为 <title> · <sessionId>）。/v1/chat/completions 接口则用于发送对话请求。
安全与注意事项¶
- 默认绑定地址：插件默认绑定
127.0.0.1（回环地址）。若要允许局域网内其他设备访问，必须手动修改 DSH 的webserver配置项为0.0.0.0。 - 会话权限：通过该插件驱动的会话默认运行在
read-only权限预设下（沙箱只读 + 审批询问）。这意味着插件只能读取文件，不能直接写入；任何写入尝试都会被沙箱拦截并转为审批请求。 - 隐私保护范围：该插件主要保护数据完整性，而非机密性。沙箱不会阻止读取文件、执行命令或网络出站请求。任何人持有 Token 均可读取会话记录。
- 审批机制：审批请求必须有一个已打开会话的 GUI 客户端（如桌面端浏览器）来响应，否则请求会一直挂起。
- 网络传输：插件使用明文 HTTP 传输 Token 和 Cookie。在不可信的公共 Wi-Fi 环境下请勿使用。
总结¶
dsh-openai-bridge 解决了在移动设备上操作本地 DSH 会话的痛点。它通过标准的 OpenAI API 协议，结合本地沙箱控制，既保证了操作的灵活性，又对文件写入等敏感操作保留了审批机制。如果你正在寻找一种方式让手机端也能介入或监控桌面上的 DeepSeek Harness 会话，这是一个直接可用的方案。
