前言¶

在 DeepSeek Harness（DSH）里走 ecnuchat 路由调用华东师范大学 Open API（chat.ecnu.edu.cn）时，额度是每周窗口、有上限的。常见做法是另开浏览器标签页登录 用量控制台，或在终端里自己 curl 额度接口——和写代码、调模型的主界面是分开的。下面介绍社区插件 dsh-ecnu-quota（维护者 Taulee，分类：客户端）：把额度做成 DSH 网页界面侧边栏底部的常驻卡片，点开可看明细；只读展示，不消耗额度，不上传任何数据。

这是什么¶

dsh-ecnu-quota 是 DSH 的 Web 客户端插件（当前 package 版本 0.1.2，MIT 许可）。宿主侧提供一条同源只读路由，用本机配置的 ECNU Open API 密钥向官方额度接口发 GET 请求；浏览器侧渲染侧边栏卡片与详情面板。完整密钥只在 DSH 宿主进程与 ECNU 之间流转，面板最多显示密钥末 4 位与来源层级。

目录页：skillhub.cn/plugins/Taulee/dsh-ecnu-quota。源码与问题反馈：github.com/Taulee/dsh-ecnu-quota。

核心功能¶

侧边栏卡片¶

侧边栏展开时，底部有一行「周额度」摘要：剩余量、总量、剩余百分比和进度条。剩余低于 20% 时进度条变为警示色；剩余为 0 时仍保留一丝细条，避免视觉上完全空白。

侧边栏折叠时，卡片收成圆环按钮，环上亮起比例对应剩余额度；悬停显示与展开时相同的一行摘要（含更新时间），点击打开明细面板。

额度明细面板¶

点卡片进入面板，自上而下包括：

• 剩余 credits（剩余 / 总量）
• 占本轮总额度的百分比
• 本轮已用百分比与进度条
• 距离重置的倒计时（不足一天会显示为小时、分钟）
• 密钥来源、刷新状态、缓存提示等小字信息

右上角提供「用量控制台」（新标签打开 ECNU 控制台）、「更新于」时间、「刷新」与关闭。界面语言跟随 DSH，提供简体中文与英文文案。

刷新与缓存¶

客户端每 5 分钟自动拉取一次；窗口重新获得焦点时，若数据超过 1 分钟会顺带更新。面板「刷新」按钮跳过缓存立即请求一次。宿主侧默认对上游结果缓存 15 秒（cacheMs），多标签页时减少重复打上游；面板上的「缓存」表示当前展示可能来自缓存，非实时值。

异常提示¶

密钥未配置、401/403、429 限流、超时、网络不可用、上游 5xx、响应无法解析、凭据读取失败、密钥有效但无额度窗口等情况，卡片或面板会给出对应文案，而不是空白占位。

安装与启用¶

需要 DSH 桌面版、终端，以及一枚与 ecnuchat 路由共用的 ECNU Open API 密钥（环境变量名 ECNUCHAT_API_KEY）。插件以当前 DSH 进程权限运行，安装前可在 GitHub 查看源码与 MIT 许可。

1. 在终端执行安装（默认装进 desktop profile）：

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

命令会把包写入 ~/.dsh/profiles/desktop，并在 profile 的 bundles 中登记 dsh-ecnu-quota。若目标不是桌面版，将 --profile 改为 web 或 tui。

2. 完全退出并重新启动 DeepSeek Harness。修改 bundles 后必须冷启动；仅刷新页面无法加载新插件。

3. 重启后侧边栏底部出现 ECNU Chat 额度卡片即表示安装成功。若完全没有卡片，且访问 /plugins/dsh-ecnu-quota/quota 返回 404，需核对 package.json 的 dependencies 与 bundles 是否含 dsh-ecnu-quota、node_modules/dsh-ecnu-quota 是否存在且非断链，并确认已完全重启。

密钥配置¶

插件按顺序读取第一个命中的 ECNUCHAT_API_KEY：

1. 启动 DSH 时的环境变量 ECNUCHAT_API_KEY
2. DSH 凭据存储（面板「密钥来源」会标明实际层级）
3. 项目目录下的 .env
4. DSH 主目录下的 .env

密钥在 用量控制台 生成。未配置时卡片显示「未配置 ECNU 密钥」；配好后点「刷新」或等待自动刷新即可恢复。

说明：本插件只认 ECNUCHAT_API_KEY；chatecnu / CHATECNU_API_KEY 属于另一套凭据，不在范围内。

典型用法¶

日常开发无需额外命令：配好密钥并安装插件后，在 DSH 网页界面侧边栏即可扫一眼本周剩余额度；需要核对重置时间或来源时点开面板。要立即对齐控制台数据，点面板「刷新」。需要改密钥或额度策略时，用面板上的「用量控制台」跳转官方站点。

上游目前通常只返回一个 fixed_168h 每周窗口且无资源包列表，界面按单窗口呈现；若将来上游返回多窗口，卡片会逐行列出。

可选配置¶

默认值一般够用。若要调整，在对应 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

客户端 5 分钟刷新间隔为固定行为，不受 cacheMs 影响。改 lib/ 下前端逻辑后刷新页面即可；改 bundle 或宿主侧仍须重启 DSH。

适用场景与注意¶

适合谁：已在 DSH 中配置 ECNU Chat（ecnuchat）且希望在本机开发界面内只读查看周额度，减少反复打开控制台或手写请求的场景。

运行与安全：请求由 DSH 宿主直连 quotaUrl，浏览器只读同源路由；插件不会签到、领取或消耗额度。显示结果仅供参考，以官方用量控制台为准。

生态说明：DSH 采用「一切皆插件」的扩展方式；社区目录站点与 DeepSeek / 幻方无官方从属关系。本插件为社区实现，与华东师范大学、Qoder、DeepSeek 官方均无关联；额度接口策略变更时插件可能需跟进更新。

界面布局对齐社区插件 dsh-qoder-connect 的卡片与面板设计，与 Qoder 官方无关。

结尾¶

dsh-ecnu-quota 把 chat.ecnu.edu.cn Open API 的周额度嵌进 DSH 侧边栏：常驻卡片、明细面板、定时与焦点刷新，并对常见错误给出可读提示。安装命令见上文；更多截图与故障排查表见 GitHub README。

• 目录页：https://www.skillhub.cn/plugins/Taulee/dsh-ecnu-quota
• 仓库：https://github.com/Taulee/dsh-ecnu-quota