dsh-hub-oauth-gateway

dsh plugin --profile web add dsh-hub-oauth-gateway

<!-- banner -->

<div align="center">

dsh-hub-oauth-gateway

v1.13.6 · 原名 dsh-usage-stats

面向 DeepSeek Harness Web 的本地优先用量中心。 Token、估算成本、账户余额、订阅配额、趋势、预测、提醒与导出——外加编码订阅 OAuth（Grok Build、Codex、Kimi Code、Claude Code）、可选回环 API 网关，以及可选的本机认证/用量监控。不要把 token 粘贴进聊天。




[English](README.md) · [中文版](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Português (BR)](README.pt-BR.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)

</div>

---

升级： 按 [docs/01-install.md](docs/01-install.md) 的版本化步骤操作。Hub 1.13.6 与 Subscription 0.8.6 共用已验证的 DSH 0.1.1-rc.2 契约，并精确固定 dsh-coding-oauth-core@0.1.2 与 undici@7.29.0。保留 profile、配置和凭据文件，在同一个 Web profile 中更新两个插件，再重启一次现有 DSH Web 进程。Core 仍是共享 npm 依赖，不是需要单独安装的 DSH 插件。已发布的 dsh-coding-oauth-core@0.1.2（含 helper 与 subpath exports）从 npm 消费；Hub 仍保留 vendor/dsh-coding-oauth-core 作为后续发版源。

---

项目更名

最初发布名为 dsh-usage-stats。自 1.1.0 起包名与仓库为 dsh-hub-oauth-gateway。请先移除旧 entry 再重新安装。本地数据文件与内部 Cordis 插件 id 不变，历史统计得以保留。

· 请用这个 · 仍然可用 / 不变

npm（推荐） · dsh plugin --profile web add dsh-hub-oauth-gateway · 旧 npm 包名不再更新

GitHub / 开发 · dsh-hub-oauth-gateway · —

Cordis 插件 id · usage-stats · 不变

SQLite 数据库 · ${DSH_HOME}/storages/usage-stats-v1.sqlite · 不变

CLI · dsh-hub-oauth · dsh-hub-grok-build（别名）。Subscription 拥有的 dsh-coding-oauth / dsh-grok-build 不属于本包

版本历史见 [CHANGELOG.md](CHANGELOG.md)。

特性

• Quick Peek + Full Dashboard —— 悬浮小窗（或侧栏按钮）；概览 / 趋势 / 账户 / 明细 / 本机页签；today / 7d / 30d / month；上一周期对比；手动刷新。
• 分栏设置 —— Settings → 用量中心：显示 / 订阅账号 / 网关 / 能力 / 供应商 / 费用。
• 预设与模块编排 —— Minimal、Quota、Cost、Analyst；自定义模块顺序；密度、动效、供应商别名与颜色。
• 活动热力图 —— 配置时区下 370 天日历 + streak。
• 本地历史 —— 按 (session, turn, step) 投影到 SQLite；后写覆盖，不累计放大。
• 成本估算 —— 用户维护的每百万 Token 价格与覆盖率；缺失价格绝不当作免费。
• 订阅费用账本 —— 本地订阅/充值；货币一致时可显示回本倍数。
• 趋势与预测 —— 小时/日/周/月桶；有界线性外推为独立序列。
• 账户与配额适配器 —— 余额、窗口、重置时间、陈旧/上次成功、软提醒（无硬阻断、不外发通知）。
• CSV / JSON 导出 —— 过滤、日序列或打包；可选会话脱敏；电子表格公式注入防护。
• 编码订阅 OAuth —— Grok Build、Codex、Kimi Code、Claude Code（设备码 / 浏览器 / PKCE 粘贴）；配置 oauthDevice.copilotClientId 后可选 GitHub Copilot LLM 路由；多账号存储（最多 8）与可选 codingOAuth.pool（off | priority | quota_aware）；Claude Code 导入走 Import Claude Code（macOS Keychain Claude Code-credentials 或文件回退；preview → commit；覆盖仍需确认）；模型标注 (OAuth)；单向 CLI 凭据拉取。
• 可选回环 API 网关 —— 默认关闭的 OpenAI/Anthropic 兼容服务，仅供本机工具。
• OpenCode Go — 在账户与模型下以独立供应商 coding-opencode-go 连接（与 DSH 原生 opencode-go 隔离）。外部工具使用 coding-opencode-go/<model-id>（过渡期仍接受 opencode-go/<model-id>）与对应协议，并发送稳定会话标识。本地网关密钥与上游凭据分开；缺少会话标识会明确失败。若旧版插件配置仍在原生槽，可在账户卡片迁移。
• 可选能力 —— Codex 搜索 / 图像 / 用量 / Fast 与 Grok Imagine 默认关闭，打开后立即生效。
• 可选本机监控 —— 只读 CLI 认证快照与跨工具 Token 扫描（从不读取对话内容）。
• 可选供应商状态页探测 —— 白名单公开 Statuspage GET（默认关；无凭据；与用量主路径隔离）。
• 中英文界面 —— 复用 DSH locale 服务。

产品调研：docs/research/usage-analytics-landscape.md。架构：[docs/02-architecture.md](docs/02-architecture.md)。

产品截图

在 DeepSeek Harness Web 安装本插件后截取（全新隔离 profile 下本地历史为空属正常）。

<p align="center">

<img src="docs/images/zh-CN/usage-center-hud.png" alt="DSH 壳层上的悬浮用量 HUD" width="760" />

<br />

<em>悬浮 HUD —— 今日指标与多账户配额芯片</em>

</p>

<p align="center">

<img src="docs/images/zh-CN/usage-center-peek.png" alt="用量中心速览浮层" width="760" />

<br />

<em>用量速览 —— 紧凑 2×2 KPI，一键进入完整仪表盘</em>

</p>

<p align="center">

<img src="docs/images/zh-CN/usage-center-dashboard.png" alt="用量中心完整仪表盘" width="760" />

<br />

<em>完整仪表盘 —— 时间范围、页签、刷新与 CSV / JSON 导出</em>

</p>

<p align="center">

<img src="docs/images/zh-CN/usage-center-settings.png" alt="设置 → 用量中心" width="760" />

<br />

<em>设置 → 用量中心 —— 显示 / 订阅账号 / 网关 / 能力 / 供应商 / 费用</em>

</p>

本插件解决的问题

你搜到 / 看到的 · 实际坏在哪 · 本插件怎么处理

用量 / 成本 / 配额散落在各 CLI 与供应商 · 没有统一的本地历史与带覆盖率的成本视图 · SQLite 投影 + 价格规则 + 账户适配器，集中在用量中心

想在 DSH 用 SuperGrok / ChatGPT Plus / Kimi Code / Claude Pro，又不想再买 API · 内置路由多为按量 API-key · 本地 OAuth 路由与现有 API-key 供应商共存

本轮运行失败 API key is invalid / AUTH · GUI 把所有 AUTH 都显示成这句；OAuth access token 会过期 · 编码 OAuth 路由主动刷新并对 AUTH 重试

想用 OpenAI/Anthropic 兼容工具对接订阅会话 · 没有安全的本机桥 · 可选回环网关（不是公网中继）

OpenCode Go: MissingSessionID · Missing stable conversation ID · DSH: use Accounts & Models; external tools: provide x-opencode-session. See [migration](docs/repair-candidate.md).

想要 Token Monitor 风格的 CLI 状态，又不想贴密钥 · 手工翻文件或粘贴到聊天 · 可选 localMonitor / localUsage，硬化白名单路径

快速开始

# 1. 安装当前 npm 发布版到 web profile
dsh plugin --profile web add dsh-hub-oauth-gateway

# 2. 自行选择时机重启常驻 DSH Web 进程
# 官方 `dsh web` 是启动 web profile 的 CLI 别名，不是服务单元名。
# 请使用这台机器实际配置的进程管理器重启现有进程。

然后打开 设置 → 用量中心。订阅账号 / 网关 / 能力按需登录或打开开关。完整安装选项（npx 安装器、GitHub tarball、代理）见 [docs/01-install.md](docs/01-install.md)。

目录

• [项目更名](#项目更名)
• [特性](#特性)
• [产品截图](#产品截图)
• [本插件解决的问题](#本插件解决的问题)
• [快速开始](#快速开始)
• [要求](#要求)
• [安装](#安装)
• [使用](#使用)
• [设置页](#设置页)
• [编码 OAuth](#编码-oauth)
• [本地 API 网关](#本地-api-网关)
• [可选能力](#可选能力)
• [运行配置](#运行配置)
• [凭据](#凭据)
• [数据与迁移](#数据与迁移)
• [隐私与安全](#隐私与安全)
• [架构](#架构)
• [文档](#文档)
• [贡献](#贡献)
• [许可证](#许可证)

要求

• DeepSeek Harness Web：已验证构建钉 @deepseek-ai/dsh 0.1.1-rc.2（精确 BOM）。安装范围（engines.dsh）覆盖 0.1.x–0.2.x，因此宿主如 0.2.1-rc.2 不会在安装时被拒；0.2.1-rc.2 / 0.1.5-rc.1 在 compatibility/dsh-bom.json 中仍为未验证候选，见 [docs/01-install.md](docs/01-install.md)。
• Node.js ^22.19.0 || >=24.0.0
• DSH Web

…(truncated)