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 會話，這是一個直接可用的方案。
