前言¶
DeepSeek Harness (DSH) 是一个基于插件架构的平台。在 Web 界面开发或使用过程中，开发者通常需要实时掌握多模型提供商的额度情况、高峰时段以及当前工作区的状态。原生状态栏在支持多模型和精细化管理方面往往有所欠缺。dsh-statusline-plus 旨在为 DSH Web 提供一个响应式的增强状态栏，解决这些信息透明度的问题。
插件定位¶
这是一个由 overact 维护的 MIT 许可证插件，专注于为 DeepSeek Harness Web (dsh web) 提供状态栏增强。它不仅提供多模型余额和配额的实时展示，还集成了 DeepSeek 高峰时段监控、Git 状态、上下文管理、成本估算以及代理活动监控。
核心功能¶
- 多模型额度监控：支持 DeepSeek、Kimi Code、Z.ai (智谱)、Antigravity、Codex、OpenCode Go 和 OpenRouter 的余额与配额显示，点击卡片可查看详情并刷新。
- DeepSeek 高峰时段：提供状态指示、倒计时、每日时间轴以及侧边栏标记，帮助用户识别并避开高峰期。
- 工作区与会话指标：在底部状态栏展示 Git 分支与变更、上下文使用量、流式输出 TPS (Tokens Per Second)、API 参考成本以及子代理和工具的活动状态。
- 布局定制：支持开关组件、调整排列顺序、使用布局预设，并提供交互式预览。
安装与启用¶
该插件要求 DSH 版本为 >=0.2.0-rc.2 且 <0.3.0。安装发布版本：
dsh plugin --profile web add https://github.com/overact/dsh-statusline-plus/releases/download/v0.1.1/dsh-statusline-plus-0.1.1.tgz
若用于本地开发调试，可安装本地路径：
dsh plugin --profile web add file:/path/to/dsh-statusline-plus
配置与用法¶
安装完成后，进入 DSH Web → Settings → Statusline。设置会保存在原生配置的 statusline-plus 下。
- 组件开关与顺序：通过
enabled、showGit、showContext、showCost等开关控制组件显示，使用componentOrder调整底部状态栏的组件顺序。 - 凭证管理：配置时应使用凭证引用而非明文密钥。例如 DeepSeek 使用
DEEPSEEK_API_KEY，Kimi 使用KIMI_API_KEY，Z.ai 使用ZAI_API_KEY等。密钥仅保存在 Host 端，不会由插件直接持有。 - 缓存与超时：通过
cacheTtlMs设置额度结果的缓存时间（默认 60 秒），通过fetchTimeoutMs设置请求超时时间（默认 10 秒）。
注意事项¶
- 成本估算：显示的成本是基于实际使用量和厂商公开 API 价格的估算值，不包括子会话、继承的分支历史和额外费用，不代表实际账单。
- 请求机制：额度请求使用插件专用的连接池，地址尝试窗口为 5 秒。网络失败会进行重试，但成功查询会立即更新显示，无需等待连接窗口结束。
- 版本兼容性：插件依赖于 DSH
>=0.2.0-rc.2。注意 v0.1.1 版本中，部分功能（如窄屏适配开关）尚未在发布版本中包含（参见 release notes）。
结尾¶
dsh-statusline-plus 通过在头部和底部提供结构化的状态信息，显著提升了在 DeepSeek Harness 中管理多模型工作流的效率。如果你想深入了解或贡献代码，可以访问其 GitHub 仓库。
- GitHub: https://github.com/overact/dsh-statusline-plus
- Catalog: https://www.skillhub.cn/plugins/overact/dsh-statusline-plus
