ECNU 额度卡片 Taulee/dsh-ecnu-quota

dsh-ecnu-quota

把 华东师范大学 Open API（chat.ecnu.edu.cn）的额度显示在 DeepSeek Harness（DSH）界面里：侧边栏底部一张常驻卡片，点开是额度明细面板。只读、不消耗额度、不上传任何数据。

侧边栏底部卡片

详情面板

能做什么

- 侧边栏底部常驻卡片：一行周额度，给出剩余量、总量与剩余百分比；侧边栏折叠时收成一个圆环按钮，悬停显示同样信息。
- 额度明细面板：点卡片打开，给出剩余额度、占本轮总额度的百分比、本轮已用百分比与进度条、距离重置的倒计时，以及密钥来源与刷新状态。
- 自动刷新：每 5 分钟拉一次；窗口重新获得焦点时若数据超过 1 分钟就顺手更新。面板上的「刷新」按钮跳过缓存立即取一次。
- 异常有话说：密钥没配、被拒绝、限流、超时、网络不通、上游异常各自一句明确提示，不会只显示一个空白卡片。

安装

需要 DSH 桌面版、一个终端，以及一枚 ECNU Open API 密钥（见下一节）。

1. 直接用源码安装：

dsh plugin --profile desktop add github:Taulee/dsh-ecnu-quota

命令会把包装进 ~/.dsh/profiles/desktop，并把 dsh-ecnu-quota 登记进 profile 的 bundles；要装到别的 profile 就把 --profile 换成 web 或 tui。

2. 完全退出并重新启动 DeepSeek Harness（改 bundles 必须重启，见〈注意事项〉）。

3. 侧边栏底部出现 ECNU Chat 卡片即安装成功。没出现就看〈故障排查〉。

源码与反馈：github.com/Taulee/dsh-ecnu-quota。

需要什么密钥

插件读 ECNUCHAT_API_KEY，也就是 ecnuchat 模型路由用的那把 ECNU Open API 密钥。按下面的顺序找，用第一个找到的：

1. 启动 DeepSeek Harness 时的环境变量 ECNUCHAT_API_KEY；
2. DSH 的凭据存储（面板底部「密钥来源」会显示实际命中的是哪一层）；
3. 项目目录下的 .env；
4. DSH 主目录下的 .env。

在用量控制台（aiconsole.ecnu.edu.cn）生成密钥。面板上只会显示密钥来源和末 4 位（如 尾号 1a2b），完整密钥既不写入日志也不出现在任何响应里。来源那一栏原样给出命中位置（env 是环境变量、file 是凭据文件），对不上就说明找错了地方。

你没配过这把密钥的话，卡片会显示「未配置 ECNU 密钥」，配好后自动恢复。

界面说明

折叠时的圆环按钮：侧边栏收起后卡片变成一个小圆环，环上亮起的比例就是剩余额度。鼠标悬停能看到「周额度 17,193.59 / 20,000 credits (86% 剩余) · 已用 2,806.41 credits · 更新于 22:54」这样一行摘要，点它打开面板。

侧边栏卡片（侧边栏展开时）：每个额度窗口一行，给出窗口名（如「每周额度」）、剩余 / 总量、剩余百分比和一条进度条。额度低于 20% 时进度条转为警示色，剩余量为 0 时仍会留一丝细条而不是彻底空掉。

额度明细面板：自上而下是

- 剩余 17,193.59 / 20,000 credits
- 占本轮总额度 85.97%（17,193.59 / 20,000）
- 本轮已用 14.03%，下面跟一条进度条
- 重置 · 6 天后重置（不足一天会换成小时、分钟）
- 一行小字：chatecnu · 密钥来源 env · 尾号 1a2b · 每 5 分钟自动刷新 · 缓存

右上角有「用量控制台」（新标签页打开 ECNU 控制台）、「更新于 22:54」、「刷新」和关闭按钮。

侧边栏展开状态会被 DSH 记住：上次收起的话，刷新页面后看到的仍是圆环按钮，点一下侧边栏的展开按钮即可看到完整卡片。

配置

默认值一般不用改。需要改就在 profile 的 cordis.patch.yml 里给 ecnu-quota 那一行加 config，全部可省略：

- id: ecnu-quota
config:
apiKeyEnv: ECNUCHAT_API_KEY # 凭据引用名 quotaUrl: https://chat.ecnu.edu.cn/open/api/v1/quota consoleUrl: https://aiconsole.ecnu.edu.cn # 面板上「用量控制台」的链接 providerLabel: ECNU Chat # 卡片与面板上的显示名 route: /plugins/dsh-ecnu-quota/quota # 同源只读路由 cacheMs: 15000 # 上游结果缓存时长 timeoutMs: 15000 # 上游请求超时

| 配置项 | 默认值 | 说明 |
| apiKeyEnv | ECNUCHAT_API_KEY | 读取哪一条凭据。必须是合法的环境变量名（字母或下划线开头）。 |
| quotaUrl | https://chat.ecnu.edu.cn/open/api/v1/quota | 额度接口地址。 |
| consoleUrl | https://aiconsole.ecnu.edu.cn | 控制台链接；上游响应里带 ops_console_url 时以响应为准。 |
| providerLabel | ECNU Chat | 界面上的显示名，只影响观感。 |
| route | /plugins/dsh-ecnu-quota/quota | 浏览器读取额度用的同源路由，以 / 开头。 |
| cacheMs | 15000 | 缓存时长。多开标签页时靠它避免重复请求上游。 |
| timeoutMs | 15000 | 单次上游请求的截止时间。 |

客户端每 5 分钟刷新一次是固定值，不受 cacheMs 影响。

注意事项

- 改 bundles 必须重启应用。 DSH 的包解析不允许在运行中的进程里替换插件，只热更新是无效的；一定要完全退出再启动。装好之后，lib/ 下的改动才是刷新页面就能生效。
- 额度数据不是实时值。 客户端 5 分钟拉一次，宿主侧另有 15 秒缓存（cacheMs），面板上的「缓存」字样表示这次显示的是缓存结果。要立刻取最新值就点「刷新」。
- 本插件只读。 它只发一个带密钥的 GET 请求并展示结果，不会签到、不会领取、不会消耗任何额度。
- 只覆盖 ECNUCHAT_API_KEY。 chatecnu / CHATECNU_API_KEY 属于另一套凭据，不在本插件范围内。
- ECNU 目前只有一个每周窗口。 上游只返回一个 fixed_168h 窗口且资源包列表为空，所以界面按「一个窗口、无资源包」呈现；上游将来吐出多个窗口时，卡片会逐行列出。
- 密钥只在本机流转。 请求从 DSH 宿主进程直连 ECNU 接口，浏览器只读同源路由；完整密钥不写日志、不进响应，面板上最多露出末 4 位。
- 界面语言跟随 DSH，提供简体中文与英文两套文案。

故障排查

卡片或面板上出现提示时，对照下表：

| 提示 | 含义 | 怎么办 |
| 未配置 ECNU 密钥 | 上面四个位置都没有找到密钥 | 配好 ECNUCHAT_API_KEY，点「刷新」 |
| 密钥被拒绝 | 上游返回 401 / 403 | 到控制台确认密钥仍然有效，或在 DSH 里更新它 |
| 请求过于频繁 | 上游返回 429 | 稍等几分钟再点「刷新」 |
| 请求超时 | 上游在 timeoutMs 内没回应 | 检查网络或代理，必要时调大 timeoutMs |
| 网络不可用 | 连不上上游 | 检查网络；校园网之外可能需要代理 |
| 上游服务异常 | 上游返回 5xx 或响应异常 | 多半是上游临时故障，稍后重试 |
| 响应无法解析 | 上游返回的内容不是预期格式 | 上游可能改了接口，需要等本插件跟进 |
| 读取密钥失败 | 凭据存储读取报错 | 检查 DSH 的凭据配置 |
| 该密钥暂无可用的额度窗口 | 密钥有效，但上游没给任何窗口 | 到控制台确认这个账号是否已开通额度 |

整个插件都没出现（侧边栏没有卡片、/plugins/dsh-ecnu-quota/quota 返回 404）——逐项确认：~/.dsh/profiles/desktop/package.json 的 dependencies 和 bundles 里都有 dsh-ecnu-quota、~/.dsh/profiles/desktop/node_modules/dsh-ecnu-quota 真的存在（ls -l 看是不是断掉的软链接）、改完是否完全重启过应用。缺 bundles 条目和断链都是常见死因：前者让 loader 根本不加载插件，后者让运行中的应用启动时加载不到宿主插件——两种情况下路由都返回 404。

出处与许可

界面与交互设计对齐社区插件 dsh-qoder-connect（作者 corrinehu，MIT 许可），沿用它的卡片与面板布局、配色令牌与文案风格；本插件与 Qoder 官方无关，只是把同一套展示方式用在 ECNU 的额度接口上。

本项目按 MIT 许可发布，第三方出处与许可见 NOTICE.md。

免责声明

- 本插件是社区实现，与华东师范大学、Qoder、DeepSeek 官方均无关联。
- 额度接口来自 ECNU Open API，上游随时可能改动、限流或调整策略，届时本插件可能部分或全部失效，不保证兼容窗口。
- 显示结果仅供参考，请以官方用量控制台为准。