前言¶
DeepSeek Harness (DSH) 的核心設計理念是插件化。在實際使用中，用戶往往需要在多個 CLI 工具、模型提供商之間切換，導致使用記錄、配額消耗和訂閱成本分散在不同處。dsh-hub-oauth-gateway 插件旨在提供一個本地優先的統一中心，將歷史記錄、成本估算、配額監控與編碼訂閱的 OAuth 登錄功能整合在一起。
核心功能¶
該插件主要提供以下能力：
- 本地化儀表盤與 HUD：提供浮動 HUD（快速預覽）和全屏儀表盤。支持多時間範圍（今天、7天、30天、本月）對比。儀表盤包含分頁設置，涵蓋顯示、賬戶、網關、能力、提供商和費用。
- 活動追蹤與歷史：提供 370 天的活動熱力圖和連續使用天數統計。使用情況會記錄到 SQLite 本地數據庫（路徑爲
${DSH_HOME}/storages/usage-stats-v1.sqlite），記錄維度爲(session, turn, step)。 - 成本與訂閱分析：支持成本估算（基於用戶自有價格和覆蓋率）和訂閱費用臺賬。提供趨勢和預測功能，按小時、天、周、月統計，採用線性外推法。
- 賬戶與配額適配：提供賬戶和配額適配器，顯示餘額、重置時間等，並設置軟性提醒。
- 數據導出：支持 CSV 和 JSON 格式的導出，可按過濾條件、每日或批量佈局導出。
- 編碼訂閱 OAuth：支持通過設備代碼、瀏覽器或 PKCE 方式登錄 Grok Build、Codex、Kimi Code 和 Claude Code。支持多賬戶存儲（最多 8 個）。
- 可選迴環 API 網關：提供默認關閉的 OpenAI/Anthropic 兼容服務器，用於本地工具對接。
- 本地監控與狀態探測：提供可選的只讀 CLI 身份快照和跨工具 Token 掃描。支持對允許列出的供應商狀態頁面進行 GET 探測。
- OpenCode Go 支持：通過隔離的提供者
coding-opencode-go連接 OpenCode Go，支持外部工具調用。 - 雙語界面：通過 DSH 本地化服務支持中英文切換。
安裝與啓用¶
安裝此插件需要 DeepSeek Harness Web 環境。安裝命令如下：
dsh plugin --profile web add dsh-hub-oauth-gateway
安裝後，需要重啓 DSH Web 進程以生效。該插件依賴共享的核心庫 dsh-coding-oauth-core@0.1.2，該核心庫作爲 npm 依賴存在，並非獨立的 DSH 插件。
典型用法¶
- 查看使用情況：通過浮動 HUD 快速查看今日指標和賬戶配額芯片。
- 查看詳細數據：點擊 HUD 中的鏈接進入全屏儀表盤，切換標籤頁查看趨勢、賬戶詳情或本地數據。
- 管理訂閱：在設置中配置編碼訂閱的 OAuth，支持多賬戶池模式。
- 數據導出：在儀表盤中使用 CSV/JSON 導出功能，按需篩選數據。
- CLI 操作：
dsh-hub-oauth：用於 OAuth 相關操作。dsh-hub-grok-build：Grok Build 的別名。
- 數據庫：所有歷史數據存儲在
${DSH_HOME}/storages/usage-stats-v1.sqlite。
注意事項¶
- 權限與安全：插件以當前 DSH 進程權限運行。安裝前應檢查源碼與許可證（MIT）。
- Token 隱私：聊天內容中不會出現 Token，本地監控僅進行快照和掃描，不包含對話內容。
- 數據完整性：缺失的價格不會被當作免費處理，缺失的會話 ID 會被拒絕。
- 依賴關係：該插件不再更新舊的 npm 包名，安裝前建議移除舊條目。
結語¶
dsh-hub-oauth-gateway 爲 DSH 用戶提供了從使用統計到訂閱管理的完整閉環。通過本地數據庫和輕量級網關設計，它在不依賴外部服務的情況下，提升了使用體驗和成本可控性。
