前言¶
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 界面中嵌入只讀面板，開發者可以更方便地追蹤資源消耗。
