前言¶
在 DeepSeek Harness（DSH）或中国科大「词元工坊」TokenWorks 中使用 USTC 网关时，额度信息通常散落在账户弹窗或官方入口里，需要切换到其他页面才能查看。频繁查看剩余额度会增加操作成本。本插件在左侧栏提供一个常驻卡片，实时展示 3h / 12h / 24h 三个窗口的已用与剩余、百分比和重置时间。
插件定位¶
插件名称为 awenforever/dsh-ustc-quota，由维护者 Awenforever 提供。它为 DeepSeek Harness 和中国科大词元工坊 TokenWorks 提供一个只读的额度展示组件，不拦截请求、不更换 Key、不修改 provider 配置，仅读取额度数据并在侧边栏渲染卡片。
核心功能¶
- 在侧边栏显示 3h / 12h / 24h 三列额度进度。
- 每列展示当前窗口剩余时间、已用额度、上限、百分比和下一次重置时刻。
- 已用额度用绿色条表示，剩余为浅灰槽；已用 ≥70% 变黄、≥90% 变红。
- 对话当前实际使用的 Key 会在 Key 行标记星号，切换对话或模型时即时更新。
- 侧边栏收起时卡片自动隐藏，展开后恢复。
- 单把 Key 查询失败只影响该行，保留 5 分钟内的旧数据并标记错误。
- 24h 额度可能来自 Key 级或用户级预算，单元格会标注数据来源。
安装与启用¶
安装前请确认环境版本：DeepSeek Harness Web / Desktop 需要至少 0.2.0-rc.2，TokenWorks 需要至少 0.2.x。
DeepSeek Harness（Web / Desktop）¶
- 在左侧栏打开「插件」→「安装插件」。
- 填入仓库地址（推荐固定版本）：
github:Awenforever/dsh-ustc-quota#v1.0.9
安装后 Host、插件清单和 Client slot 会即时生效。DSH 的 client-hmr 会把新 client 加载进旧页面，插件会自行刷新一次页面（每个版本一次）。首次安装 v1.0.9 可能需要一次页面重载或应用重启，之后更新会自动检测 Host 版本变化并 reload。
TokenWorks（词元工坊）¶
- 在左侧栏打开「插件」→ 点右上角「+ 添加插件」。
- 填入仓库地址（固定版本）：
github:Awenforever/dsh-ustc-quota#v1.0.9
安装/更新后插件会在旧页面自行刷新一次。v1.0.9 首次安装可能需要一次页面重载或应用重启来装入 watchdog，之后 Host 版本变化会自动 reload。用学校统一身份登录后，卡片会自动出现。
注意：TokenWorks 的插件页「官方」只列出发行版自带的插件，第三方插件（包括本插件）不会出现在「官方」里，而是出现在「已安装」区域。
配置¶
一般情况下不需要配置。插件会自动发现指向 USTC 网关的 @deepseek-ai/dsh-llm-pi-ai provider（DSH）或使用内置 tokenworksUsage 服务（TokenWorks）。
若自动发现失败或使用的适配器不是 @deepseek-ai/dsh-llm-pi-ai，可以在 profile 的 cordis.patch.yml 里覆盖插件配置：
- id: dsh-ustc-quota
name: dsh-ustc-quota
config:
baseURLs:
- https://api.llm.ustc.edu.cn
refreshIntervalMs: 10000
resettingRefreshIntervalMs: 8000
requestTimeoutMs: 8000
cacheTtlMs: 8000
errorCacheTtlMs: 20000
providers:
my-ustc-key:
apiKeyEnv: MY_USTC_API_KEY
label: my-key
providers 里的 apiKeyEnv 是凭据引用名（环境变量或 DSH credentials 中的名字），不是 Key 本身。baseURLs 支持 https://api.llm.ustc.edu.cn 或带 /v1 的形式，插件会归一到站点根。
安全说明¶
- Key 只在 Host 内使用：DSH 通过
credentials解析，TokenWorks 通过官方tokenworksUsage读取，不会把 Key 发到浏览器。 - 快照只包含 provider id、显示名、额度数值、重置时间、安全错误码。
- 不转发
key、key_alias、user_email、user_alias、platform_user_id、keys、teams。 - 在 Web host 上路由先过
ctx.connection.requestRejection；官方 Desktop / TokenWorks 窗口从dsh-app://加载，fetch 不一定携带浏览器 session，因此和 dsh-market 一样在 Desktop host 上跳过这道 fence（只读、无 Key 数据，路由仍只绑定本机 Web server）。
注意事项¶
- 本插件以当前 DSH/TokenWorks 进程权限运行，请安装前检查源码与许可证。
/key/info、/user/info是 USTC LiteLLM 的内部接口，字段变化时插件会显示安全错误但不会崩溃。- 12:00 / 00:00 边界上平台可能短暂返回旧用量，插件会把过期窗口标成「重置中」，8 秒后重查。
- 额度数值是平台额度单位（当前 3h/12h/24h 为 30/70/100），不是 DSH token 数，插件不擅自换算。
- 如果使用了自定义反代路径，请在
baseURLs里显式添加。
结语¶
本插件为 DSH 与 TokenWorks 用户提供了一个常驻的 USTC 额度卡片，减少了切换查看额度的操作成本。安装后卡片会出现在侧边栏底部，与「更新」或 Cordis 按钮分行显示，三列额度信息完整展示。
- 插件目录页：https://www.skillhub.cn/plugins/Awenforever/dsh-ustc-quota
- GitHub 仓库：https://github.com/Awenforever/dsh-ustc-quota
