前言¶
在使用 DeepSeek Harness (DSH) 的 Work 窗口进行开发时，开发者往往需要频繁切换窗口来确认当前的项目名称、分支以及变更状态。omdsh-status 插件将项目名称和 Git 状态直接嵌入到对话头部，位于 Session log 导出按钮的左侧，让这些信息一目了然。
插件定位¶
- 插件名: omdsh-status
- 维护者: omdsh-plugins
- 分类: Insight
- 定位: 在 DSH Work 窗口对话头部显示当前项目及 Git 状态。
核心功能¶
- 对话头部状态显示：在对话头部显示项目名称和 Git 状态。
- 详细变更计数：显示当前分支、ahead/behind、staged、modified、untracked 和 conflicts 的计数。
- API 接口：提供
GET /omdsh-status/status接口。 - 无配置需求：无需设置命名空间，自动读取工作目录状态。
安装与启用¶
使用官方插件中心安装：
npx @omdsh-plugins/omdsh-plughub add omdsh-status
该插件采用 MIT 许可证。
典型用法¶
- 有内容的会话：在对话头部左侧显示，格式如
omdsh-plugins ⎇ main ↑1 +2 ~3。 - 空白会话：当会话尚未开始时，在框架的浮动层中显示状态。
- 非 Git 仓库：如果当前目录不在 Git 仓库中，仅显示项目名称，并通过 tooltip 提示。
适用场景与限制¶
- Chat 模式：当使用 Chat 模式（如
basemode+chatmode）时，该插件不会显示状态，因为 Chat 模式下会话不属于特定的项目目录。 - Code 模式：Code 模式将对话栏替换为终端，插件会自动隐藏状态显示。
- 安全机制：Git 状态的解析在宿主机运行，只返回计数数字，不会向浏览器发送路径列表、diff 或分支图。
- 轮询策略：插件使用高效的轮询机制，缓存结果 2 秒，可见页面每 4 秒重新请求一次。
结语¶
omdsh-status 通过在头部提供直观的项目和 Git 状态，减少了上下文切换的干扰。更多细节可查阅 插件目录 或 GitHub。
