前言¶
DeepSeek Harness (DSH) 采用插件化架构，开发者在使用 Ollama Cloud 进行服务调用时，往往需要自行监控配额消耗情况。目前缺乏在 Web 聊天界面中直接查看账户使用率的便捷方式。
dsh-plugin-ollama-usage 插件在 DSH Web 界面中嵌入了一个面板，显示 Ollama Cloud 的账户使用情况（5 小时滚动窗口 / 每周），并提供 baseURL 和凭证模式配置。该插件由 CJ-SH 维护，采用 MIT 许可证。
核心功能¶
该插件提供以下能力：
- 可视化面板：在当前活动会话的编写器下方显示一个面板，同时在新的会话（Hero）页面显示另一个面板，两者内容一致。
- 使用量统计：报告会话（5 小时滚动）和每周窗口的使用百分比，默认每 5 分钟刷新一次。
- 只读访问：插件不触碰提供商配置，也不发起任何对话，仅读取账户使用数据。
- 凭证模式：支持两种模式：复用现有的 Ollama 密钥，或使用插件专用的密钥。
安装与启用¶
在安装前，请确保环境满足以下要求：
- dsh 版本 0.2.0-rc.1（需启用 web profile）。
- Node.js 版本 ^22.19.0 或 >=24.0.0。
- 已配置有效的 Ollama Cloud API Key。
通过官方命令安装：
dsh plugin --profile web add github:CJ-SH/dsh-plugin-ollama-usage
插件会在 dsh 启动时加载。安装完成后，建议重启 dsh 以确保配置生效。
配置与使用¶
配置入口位于设置页面的“Ollama Usage”，也可以直接编辑配置文件。
配置文件路径：~/.dsh/profiles/<profile>/cordis.patch.yml
在配置块 - id: ollama-usage 下，可以设置以下字段：
baseURL：Ollama Cloud 的 API 地址。credentialMode：凭证模式。apiKeyEnv：环境变量名。
凭证模式说明：
credential mode（reference，默认）：复用现有的环境变量（默认为OLLAMA_API_KEY）。此模式不会修改现有密钥配置。key mode（direct）：仅写入插件自身的引用OLLAMA_USAGE_API_KEY。
注意事项¶
- 卸载处理：卸载插件不会自动清除配置和凭证。如果需要彻底移除，需手动从
cordis.patch.yml中删除- id: ollama-usage块。 - 错误处理：当凭证缺失、端点无法访问或响应格式错误时，面板会静默消失，不会显示占位符或错误提示。
- 生态定位：此插件通过调用 Ollama 公共 API 提供服务，不隶属于 DeepSeek 或 Ollama 官方。
总结¶
dsh-plugin-ollama-usage 解决了在 DSH 开发过程中缺乏直观 Ollama Cloud 使用量监控的问题。通过在 Web 界面中嵌入只读面板，开发者可以更方便地追踪资源消耗。
