前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者通过插件扩展宿主功能。对于使用 Ollama Cloud 的开发者，监控 Cloud 账号的余量（包括每 5 小时会话配额和周配额）通常需要手动打开网页查看。dsh-ollama-usage 插件将这一过程可视化并集成到 DSH 界面中。
核心功能¶
该插件提供以下能力：
- 会话用量：展示每 5 小时会话的用量进度。
- 周用量：展示本周的配额使用情况。
- 侧边栏双横条：在侧边栏底部以极简双横条形式常驻显示会话和周用量，包含百分比数字。
- 插件详情页完整面板：在插件详情页渲染完整的用量面板，包括历史记录和倒计时。
- 持久化：API Key 与用量快照保存在本地，支持跨对话或重启后恢复。
- 自动刷新：宿主自动查询用量，Key 失效时自动清除。
- 登录引导：引导用户在 ollama.com/settings 创建 API Key 并进行检测。
安装与启用¶
通过 CLI 安装插件：
dsh plugin --profile web add dsh-ollama-usage
dsh --profile web
安装后，插件会自动注入到宿主中。
使用步骤¶
- 打开 DSH 插件列表，找到
dsh-ollama-usage。 - 在插件面板中，如果未登录，点击引导跳转到 ollama.com/settings 创建 API Key。
- 返回插件面板点击「检测」，或使用终端
ollama signin后点击「重新检测本地凭证」。 - 检测成功后，展开侧边栏底部即可看到双横条显示用量。
- 若不再需要本地存储的 Key，可在面板中点击「清除已存 Key」。
数据与隐私¶
- 数据来源：插件仅向
https://ollama.com/api/usage发送带 Bearer Token 的查询请求。 - 本地存储：API Key 以明文保存在本机目录
$DSH_HOME/storages/ollama-usage/usage.json，文件权限为 600。 - 清理：用户可随时清除已存储的 Key。
兼容性¶
- 支持 DSH >= 0.1.5-rc.1。
- 对于旧版 DSH (0.1.0-rc.5 ~ rc.8)，请使用 npm 版本 0.1.5。
