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