dsh-ecnu-quota
DSH Web GUI 的 ECNU (chat.ecnu.edu.cn) 配额显示：一个代理 ECNU 配额 API 的只读主机路由，以及一个侧边栏卡片和详情面板。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Taulee/dsh-ecnu-quota#039d4b7b54137e14bc36e9890674e5067c12a596Ecnu Quota 以 dsh-ecnu-quota 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 华东师范大学 Open API（chat.ecnu.edu.cn）的额度显示在 DeepSeek Harness（DSH）界面里：侧边栏底部一张常驻卡片，点开是额度明细面板。只读、不消耗额度、不上传任何数据。
需要 DSH 桌面版，以及一枚 ECNU Open API 密钥（见下一节）。
打开 DSH 设置里的插件市场，搜索 ecnu-quota。
点安装。市场会把包装进 ~/.dsh/profiles/desktop，并把 dsh-ecnu-quota 登记进 profile 的 bundles。
完全退出并重新启动 DeepSeek Harness（改 bundles 必须重启，见〈注意事项〉）。
侧边栏底部出现 ECNU Chat 卡片即安装成功。没出现就看〈故障排查〉。
插件发布在 npm（包名 dsh-ecnu-quota），源码在 github.com/Taulee/dsh-ecnu-quota。
插件读 ECNUCHAT_API_KEY，也就是 ecnuchat 模型路由用的那把 ECNU Open API 密钥。按下面的顺序找，用第一个找到的：
ECNUCHAT_API_KEY；.env；.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 credits85.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/ 下的改动才是刷新页面就能生效。cacheMs），面板上的「缓存」字样表示这次显示的是缓存结果。要立刻取最新值就点「刷新」。ECNUCHAT_API_KEY。 chatecnu / CHATECNU_API_KEY 属于另一套凭据，不在本插件范围内。fixed_168h 窗口且资源包列表为空，所以界面按「一个窗口、无资源包」呈现；上游将来吐出多个窗口时，卡片会逐行列出。卡片或面板上出现提示时，对照下表：
| 提示 | 含义 | 怎么办 |
|---|---|---|
| 未配置 ECNU 密钥 | 上面四个位置都没有找到密钥 | 配好 ECNUCHAT_API_KEY，点「刷新」 |
| 密钥被拒绝 | 上游返回 401 / 403 | 到控制台确认密钥仍然有效，或在 DSH 里更新它 |
| 请求过于频繁 | 上游返回 429 | 稍等几分钟再点「刷新」 |
| 请求超时 | 上游在 timeoutMs 内没回应 | 检查网络或代理，必要时调大 timeoutMs |
| 网络不可用 | 连不上上游 | 检查网络；校园网之外可能需要代理 |
| 上游服务异常 | 上游返回 5xx 或响应异常 | 多半是上游临时故障，稍后重试 |
| 响应无法解析 | 上游返回的内容不是预期格式 | 上游可能改了接口，需要等本插件跟进 |
| 读取密钥失败 | 凭据存储读取报错 | 检查 DSH 的凭据配置 |
| 该密钥暂无可用的额度窗口 | 密钥有效，但上游没给任何窗口 | 到控制台确认这个账号是否已开通额度 |
整个插件都没出现（侧边栏没有卡片、/plugins/dsh-ecnu-quota/quota 返回 404）——逐项确认：市场里显示已安装、~/.dsh/profiles/desktop/node_modules/dsh-ecnu-quota 真的存在（ls -l 看是不是断掉的软链接）、~/.dsh/profiles/desktop/package.json 的 bundles 里有 dsh-ecnu-quota、改完是否完全重启过应用。断链是常见死因：源的目录被删或搬走后，运行中的应用启动时加载不到宿主插件，路由就 404。
界面与交互设计对齐社区插件 dsh-qoder-connect（作者 corrinehu，MIT 许可），沿用它的卡片与面板布局、配色令牌与文案风格；本插件与 Qoder 官方无关，只是把同一套展示方式用在 ECNU 的额度接口上。
本项目按 MIT 许可发布，第三方出处与许可见 NOTICE.md。