前言¶
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 用户提供了从使用统计到订阅管理的完整闭环。通过本地数据库和轻量级网关设计，它在不依赖外部服务的情况下，提升了使用体验和成本可控性。
