前言¶
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。
