dsh-companion：DeepSeek Harness 原生客戶端的只讀工作區與會話 API

前言¶

DeepSeek Harness（DSH）採用插件化架構。原生客戶端（如 dsh-native）往往需要獲取項目與會話元數據，但無法直接加載或抓取 Harness 的 Web UI。dsh-companion 旨在爲此類場景提供解法。

插件定位¶

這是一個由 leonardoxr 維護的插件，爲 DeepSeek Harness 原生客戶端提供只讀的 JSON 視圖、可配置的通知事件流以及 Web 設置卡片。

核心功能¶

1. JSON 端點：提供三個小型、無緩存的 JSON 端點，用於獲取工作區和實時會話信息。
2. 工作區瀏覽器：當頁面在 DSH Native 中運行時，在 Harness 左側邊欄顯示統一的工作區瀏覽器。
3. 通知流：提供可重連的 Server-Sent Events (SSE) 流，用於接收原生完成、失敗、問題和批准警報。
4. 設置卡片：在 Web UI 中提供一個設置卡片，用於篩選警報類型和子代理事件。
5. Images 選項卡：與 dsh-better-sidebar 工作臺集成的可選 Images 選項卡。
6. 安全與投影：顯式字段投影以避免序列化內部 Harness 對象，並在每次請求時執行 DSH trusted-host 和同源檢查。

安裝與啓用¶

先安裝插件到 Web 配置文件：

dsh plugin --profile web add github:leonardoxr/dsh-companion

啓動 Web 界面後，通過以下命令驗證插件是否可用：

curl http://127.0.0.1:3080/api/companion/workspaces

典型用法¶

在 Harness Web UI 中，打開 Settings → Plugins → DSH Companion notifications 以配置通知設置。

注意事項¶

• 此項目不是 npm 上的未限定作用域 dsh-companion 包。
• 不要將 DSH 服務器暴露給不應讀取該元數據的網絡。
• 這是一個網絡信任邊界，而非用戶認證機制。

生態與來源¶

該插件遵循 MIT 許可證。更多詳情及源碼，請訪問：
* GitHub: https://github.com/leonardoxr/dsh-companion
* 插件目錄: https://www.skillhub.cn/plugins/leonardoxr/dsh-companion