dsh-ai-quota

dsh-ai-quota

DeepSeek Harness 插件：查询你的 AI 订阅额度 / 余额 —— Codex、Kimi、GLM Coding Plan、DeepSeek、302.AI、OpenCode Go 六个 provider 一处可见。

English · 中文

预览

设置页：Codex / Kimi / GLM Coding Plan / OpenCode Go 的用量进度条、DeepSeek / 302.AI 的简洁余额，手动刷新 + 相对时间的更新时间；标题栏的齿轮按钮进入内嵌的可见性设置，每个 provider 一个开关。

功能

• 模型工具 query_ai_quota：任何 agent 会话里直接问「查一下我的 AI 额度」，返回人类可读摘要。
• 设置页：设置侧边栏新增「AI 额度」页，每个 provider 的用量进度条 / 余额 + 手动刷新。
• 每个 provider 可单独显示 / 隐藏：设置区标题栏的齿轮按钮点进去，就是嵌在同一个设置页里的第二层 —— 每个 provider 一个开关。没检测到 Key / 登录态的 provider 仍列出但开关不可用，并直接写上缺什么（哪个 Key / 哪次登录 / 哪个 CLI）；能拨动的就是检测到了，不再另标「已检测到」。检测到的一律默认开启，以后新配的 Key 会自动出现。开关对设置页列表和输入框额度行同时生效；偏好存在浏览器 localStorage，点一下即时生效，不走 host、不需要重启。query_ai_quota 工具不受影响，始终返回全部 provider。
• 输入框额度行：跟随当前 provider 路由（绝不看模型 ID —— 同一个模型可能由多个路由提供、额度彼此独立）的一行极简额度提示，新建页面与会话中都显示。
• 自动刷新：host 每 refreshIntervalMs（默认 2 分钟）全量查询一次并写缓存，前端与工具秒回；0 关闭。此外打开中的对话每 60 秒静默重读一次当前 provider 的额度（不会闪加载态），所以长时间不关的会话不会一直停在打开时的旧余额；标签页隐藏时跳过，重新可见时立即补一次。
• 统一格式：订阅制窗口 / 余额两种形态归一化，单个 provider 失败不影响其他。
• 跟随皮肤配色:所有读数颜色都是 CSS 变量 —— 加载初音皮肤(dsk-miku-skin)时,输入框额度行与用量条变为柔和的初音青绿;没有皮肤时仍是原有的翠绿/琥珀/红三档。进度条到琥珀/红档时,它自己的描边也跟着同色,整条进度条是一个状态;正常档位仍是安静的中性描边。
• 不泄露密钥：API key / token 永不进入工具输出、Remote 结果与日志。

安装

dsh plugin --profile web add github:Carrick-K7/dsh-ai-quota
# 或本地目录：dsh plugin --profile web add file:/path/to/dsh-ai-quota

包内 cordis.patch.yml（通过 package.json 的 dsh.bundle.patch 声明）会让 dsh plugin 自动把插件行追加到 dsh.profile.bundles。改完重启 dsh web 生效（需要 pnpm 在 PATH 上）。

配置（插件行 config，均可选）

输入框额度行的路由匹配

额度行读取当前所选模型的 provider 路由（如 opencode-go-carrick、kimi-coding、deepseek-official、openai-codex），绝不按模型 ID 匹配 —— OpenCode Go 路由下的 kimi-k3 属于 OpenCode Go 额度，而不是 Kimi 订阅。路由 id（或路由别名对应的 provider 显示名）包含 302、opencode、codex、kimi/moonshot、deepseek、zai/zhipu/bigmodel/glm 之一即被识别；其余路由不显示额度行，而不是显示另一个账号的余额。

额度行挂载期间每 60 秒重读一次该 provider（读 host 的暖缓存，不额外打上游接口）。若 host 快照本身已超过 10 分钟未更新（即 host 自动刷新被关闭或卡住），轮询会升级为真实查询，并限制为每个 provider 每 10 分钟最多一次。

密钥来源

• DeepSeek / 302.AI / OpenCode Go：优先走 DSH 凭据 seam 解析——apiKeyEnv 是凭据引用名（默认 DEEPSEEK_API_KEY / AI_302_API_KEY / OPENCODE_GO_API_KEY），因此配置在 DSH 的 key（如 $DSH_HOME/.credentials.yaml）优先；同名进程环境变量仅作兜底（非 DSH 独立部署）。OpenCode Go 额外回退 ~/.local/share/opencode/auth.json 的 opencode-go 条目。
• GLM Coding Plan：同样走 DSH 凭据 seam，默认引用名 ZAI_CODING_CN_API_KEY，找不到时依次尝试 ZAI_CODING_API_KEY、GLM_CODING_API_KEY，所以国内版 / 国际版的 key 名都能直接用；国际版账号把 glmBaseUrl 改成 https://api.z.ai。
• Codex / Kimi：无需 key，复用本地 CLI 登录态（codex 走 PATH 上的 CLI；Kimi 复用 Kimi Code CLI 的 OAuth 会话，过期自动续期，彻底失效时提示重新 kimi login）。

各 provider 数据来源

License

MIT