前言¶
在 DeepSeek Harness 里切换模型或路由时，限额和余额往往分散在各提供方控制台或 OAuth 页面里，Composer 本身不会统一展示。若你同时用 ChatGPT Codex、Grok、DeepSeek 官方 API 或智谱 GLM，需要在对话前反复确认「还能不能用、还剩多少」，打断节奏。下面介绍社区插件 dsh-edu（维护者 yueyexiayu，分类：联网工具），它把与当前会话模型对应的额度或余额显示在输入框下方，凭据只在 Host 侧通过 DSH credentials 读取，浏览器只请求 /api/dsh-edu，响应不含密钥。
这是什么¶
dsh-edu 是面向 DeepSeek Harness 官方桌面 的插件（依赖 connection.fetch）。在 Composer 停靠区展示当前模型路由对应的用量或余额，不另存 token，不支持的提供方不显示、也不请求其官方额度接口。项目说明中写明：当前深度适配个人使用，供思路借鉴，尽量不要直接照搬。
目录页：https://www.skillhub.cn/plugins/yueyexiayu/dsh-edu
源码：https://github.com/yueyexiayu/dsh-edu
当前 package 版本：0.1.2。
支持的提供方与显示内容¶
| 提供方 | 显示内容 |
|---|---|
| ChatGPT Codex | 5 小时 / 7 天限额 |
| Grok / SuperGrok | 周限额 |
| DeepSeek 官方 API | 账户余额 |
| 智谱 GLM（bigmodel / z.ai） | 现金余额；悬停可看生效的 Token 资源包 |
说明：官方 deepseek-account 登录账户余额仍由官方界面提供；本插件的 DeepSeek 余额针对 API Key 路由。插件不读取 ~/.grok/auth.json / ~/.codex/auth.json。
查询与显示逻辑（摘要）¶
会话模型优先使用官方 modelSelection.next 投影，再使用历史请求的模型；新会话在无选择且无历史时使用默认模型。投影不可用或读取失败时会明确报错，不会误查无关默认账号。客户端通过会话槽位的 useProjection 响应模型切换并清除旧读数。
成功结果按提供方和实际凭据缓存 3 分钟，换号、退出、续期或改凭据会使旧结果失效。智谱现金与资源包分别缓存；资源包查询失败时保留已确认现金，内联显示「资源包查询失败」，约 30 秒 后重试失败分项。前台轮询间隔 2 秒（不支持的提供方 30 秒），后台暂停；单次浏览器请求 20 秒 超时。未知用量不会显示为 0%，非法数值不会当成零。
安装与启用¶
安装方式来自仓库 README，不是 dsh plugin add 一类命令。
1、将插件目录复制到 $DSH_HOME/plugins/dsh-edu（默认 $DSH_HOME 为 ~/.dsh）。
2、在 $DSH_HOME/profiles/desktop/cordis.patch.yml 写入：
- insert:
- id: dsh-edu
name: ../../plugins/dsh-edu/lib/index.js
3、完全退出 DeepSeek Harness（macOS：⌘Q）再打开。仅刷新页面不会完整重载 Host 和 Client 插件。
凭据与路由¶
凭据沿用当前模型路由，通过官方 llm 元数据和 settings.describe() 读取：
- GPT / Grok：使用
llm-pi-ai/openai-codex/llm-pi-ai/xai的 OAuth 凭据；路由显式指定 API Key 时不展示其他 OAuth 账号限额。 - DeepSeek 官方 API：路由的
apiKeyEnv，默认DEEPSEEK_API_KEY。 - pi-ai 的 DeepSeek、智谱路由：依次使用显式
apiKeyEnv、该路由存储的 API Key、原生凭据引用（DEEPSEEK_API_KEY、ZAI_CODING_CN_API_KEY/ZAI_API_KEY）。显式引用缺失时显示错误，不会改用其他账号默认 Key。 - 自定义服务地址、覆盖认证请求头或无法确认凭据的旧路由会显示归属错误，不会用官方账号余额冒充该路由余额。
典型用法¶
安装并重启桌面后，在官方桌面打开任意会话：输入框下方会出现与 当前会话模型 对应的读数。切换模型或路由时，读数应随投影更新；若提供方不在支持列表中，该区域不显示、也不会发起额度请求。
智谱路由下，悬停可查看生效的 Token 资源包；若资源包查询失败，仍会显示已确认的现金，并提示资源包查询失败。
开发与本地验证（不读取真实凭据、不调用真实额度接口）：
for file in lib/*.js; do node --check "$file"; done
node --test
# 或 npm test
README 注明：0.1.2 的修复针对 DSH 0.2.1-alpha.1 的公开投影和会话槽位 API；桌面更新后仍需完全退出再打开，并在自己的账号上确认显示。
适用场景与注意¶
适合谁：在 DSH 官方桌面多模型、多路由并用，希望在 Composer 内一眼看到 Codex / Grok 限额或 DeepSeek / 智谱余额的开发者。
权限与安全：插件随当前 DSH 进程权限运行，Host 侧会读取本机已有凭据以查询官方接口。安装前应自行阅读 GitHub 源码 与仓库中的许可证信息（资料未单独列出许可证名称时以仓库为准）。
生态说明：DeepSeek Harness 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文安装步骤以仓库 README 为准。
结尾¶
dsh-edu 把 GPT/Grok 限额与 DeepSeek、智谱余额收敛到输入框下方，并与会话模型投影绑定，减少在控制台与 Composer 之间来回切换。需要细节或更新时，请查看 SkillHub 目录页 与 GitHub 仓库。
