前言¶
在 DeepSeek Harness（DSH）里同时接 DeepSeek 官方、第三方订阅或本地 CLI 用量时，余额和窗口往往分散在各自控制台或命令行里。要判断「还能用多久、哪边先见底」，需要反复切换页面或手动查命令。下面介绍社区插件 dsh-quota-viewer：在 DSH Web 侧边栏底部集中展示多家提供方的额度与用量，并在本机保留约 90 天历史供趋势查看。
这是什么¶
dsh-quota-viewer 由维护者 black970 发布，分类为客户端插件，面向 web profile。它在侧边栏底部增加一行额度概览（侧边栏收成图标栏时变为底部悬浮卡片），点击可展开详情；面板打开时每 10 分钟自动刷新，也可手动点「更新」。插件以 MIT 许可证开源，当前 package 版本为 1.0.0。
核心功能¶
概览与详情¶
展开详情面板后，可按提供方分组查看：
- 已用 / 上限 / 剩余 / 百分比
- 日额度、到期时间
- 按当前速度估算的可用天数
- 上次更新时间（相对时间，如「3 分钟前」）
顶部一行汇总所有提供方状态；提供方之间可切换，并可为各家新增或保存各自的 token。每个提供方下方有天趋势图，数据来自本机历史，可切换天数。
支持的提供方¶
| 提供方 | 数据来源 | 前置条件 |
|---|---|---|
| DeepSeek 官方 | 开放平台余额（platform.deepseek.com 的余额接口） |
凭据服务里能解析到 DEEPSEEK_API_KEY |
| jojo code | 登录控制台后的订阅窗口（时长窗口 / 日额度 / 到期时间） | 面板内用控制台邮箱 + 密码登录一次，会话过期自动续期 |
| SCNet 超算 | 控制台 Token Plan 用量 | 扫码登录或账号密码登录；会话保活失败会在面板里提示 |
| 方舟 Coding Plan | 本机 arkcli usage plan --product coding-plan |
已安装 arkcli 且已登录火山账号（Coding Plan 没有仅凭 API Key 可调的用量接口） |
任何一家未配置好时，不会影响其他家：该行显示「未配置 / 暂不可用」及所需步骤，其余照常显示。
数据与隐私¶
- 宿主半只注册回环地址可用的 HTTP 路由（请求来源须为
127.0.0.1/::1，且 Host 头匹配本机），接口只返回总量与百分比，从不返回密钥 - 密钥解析走 DSH 凭据服务，按次请求解析；面板里保存的 token 存在本机
- 历史落在
~/.dsh/quota/history.db（SQLite）：同一提供方同一指标 10 分钟内只留一条采样，每个指标保留最近 90 天 - 插件无 npm 运行时依赖；出网请求仅发往上述服务的官方域名，无遥测
安装与启用¶
在 DSH 中为 web profile 安装插件：
dsh plugin --profile web add github:black970/dsh-quota-viewer
装完后重启或 reload DSH，侧边栏底部即出现额度行。
典型用法¶
- 展开 / 收起：点击侧边栏底部额度行，打开或关闭详情面板。
- DeepSeek 官方：在 DSH 凭据服务中配置可解析的
DEEPSEEK_API_KEY，无需在面板重复填密钥即可查余额（若面板支持 token 类提供方，也可在面板填入并保存，或切回凭据服务里的值）。 - jojo code：在面板登录区用控制台邮箱 + 密码登录；可勾选「设置长效登录」，token 失效时自动重登。
- SCNet：在面板用扫码或账号密码登录；保活失败时面板会提示。
- 方舟 Coding Plan：在本机安装并登录
arkcli后，插件通过arkcli usage plan --product coding-plan读取用量。 - 趋势图：在详情里按提供方与指标（余额 / 已用比例）查看本地历史，并切换展示天数。
适用场景与注意¶
适合经常在 DSH Web 里开发、且同时使用 DeepSeek 官方与 jojo、SCNet、方舟 Coding Plan 等用量窗口的开发者：一处看汇总与估算可用天数，减少切控制台的成本。
安装前请注意：DSH 插件在当前 dsh 进程权限下运行，会访问凭据服务、本机 SQLite 及部分提供方的登录会话；建议在安装前阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境与合规要求。社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-quota-viewer 把 DeepSeek 官方余额、jojo code、SCNet 与方舟 Coding Plan 的额度与用量收进 DSH 侧边栏，并用本机 90 天历史画趋势。需要时可从目录页或仓库安装：
- 目录页：https://www.skillhub.cn/plugins/black970/dsh-quota-viewer
- GitHub：https://github.com/black970/dsh-quota-viewer
