前言¶
在 DeepSeek Harness（DSH）中开发或使用智能体时，随时了解当前使用的模型供应商剩余额度是常见需求。对于 DeepSeek、Moonshot、OpenRouter 和阿里云费用中心，有公开接口可以获取真值。然而，阿里云 / 千问 Token Plan 有额度却没有公开的额度接口；只能走控制台数据网关（Cookie 会话）。本插件把那套契约内置了，顺手也把有官方接口的几家按真值接上。
是什么¶
这是一个 Web UI 插件，用于在输入框工具行显示当前模型供应商的剩余额度。插件由 xinghe-1018 维护，主要解决“在 DSH 中查看当前模型供应商还剩多少额度”的问题，特别是补齐了阿里云 / 千问 Token Plan 这类只有控制台数据网关（Cookie 会话）且没有公开 API 的厂商的缺口。
核心功能¶
-
输入框工具行显示额度徽标并跟随模型供应商切换
徽标是个小胶囊，跟随当前模型的供应商切换。有官方接口的显示百分比和余量条，没有官方接口的显示「实测」。 -
支持多家厂商的官方接口获取真值
支持 DeepSeek、Moonshot、OpenRouter、阿里云费用中心官方接口获取真值。 -
支持千问 Token Plan 控制台数据网关
支持 Token Plan 控制台数据网关（Cookie 会话）。 -
零配置自动识别在用路由
插件按可信度排序识别在用路由，自动补齐数据源。用户无需写sources，也不用手填providers。 -
不折算 Credits、不估算余量
不折算 Credits、不估算余量，不按历史推算剩余。 -
附 token_plan_quota 模型工具
提供了模型工具token_plan_quota。
安装与启用¶
使用以下命令安装：
dsh plugin --profile web add github:xinghe-1018/dsh-token-plan-quota
安装后，重启一次 dsh web 以使更改生效。
配置¶
插件支持以下配置项（默认值在代码中）：
{
"autoDetect": true,
"refreshMinutes": 10,
"pollSeconds": 10,
"panelScope": "current",
"debug": false
}
autoDetect：默认为true，按宿主在用路由自动补齐数据源。设为false时以用户写的sources为唯一事实。panelScope：默认为"current"，只列当前模型供应商的卡；设为"all"可查看所有。refreshMinutes和pollSeconds：控制数据刷新频率。
界面与用法¶
- 额度徽标：输入框工具行里的徽标是个小胶囊，跟随当前模型的供应商切换。Tooltip 中包含名字、速度和天数等信息。
- 明细面板：显示官方余量卡（有官方分母才画条、才给百分比）和本地实测账本。面板可以拖成悬浮小窗（拖标题栏，双击复位）。
- 模型工具：使用
token_plan_quota模型工具可以查询额度。
适用场景与注意¶
- 适合需要实时查看各厂商剩余额度、且不希望手动配置过多参数的用户。
- 插件以当前 dsh 进程权限运行，安装前应检查源码（许可证信息未在资料中明确出现）。
- 对于没有官方额度接口的供应商（如 MiniMax、普通 Key），插件只显示本实例的实测用量。
- 插件不做会产生计费的探活；只用只读端点。
权限¶
插件运行时需要访问以下网络端点：
- https://api.deepseek.com
- https://api.moonshot.cn
- https://api.moonshot.ai
- https://openrouter.ai
- https://business.aliyuncs.com
- https://cs-data.qianwenai.com
- https://platform-home.qianwenai.com
- https://cdn.jsdelivr.net
总结¶
dsh-token-plan-quota 解决了在 DSH 中查看当前模型供应商剩余额度的问题，特别是补齐了阿里云 / 千问 Token Plan 这类只有控制台数据网关（Cookie 会话）且没有公开 API 的厂商的缺口。零配置自动识别和只读端点的设计，使其在不折算 Credits、不做计费探活的前提下，提供真值或明确的实测数据。
- 插件目录：https://www.skillhub.cn/plugins/xinghe-1018/dsh-token-plan-quota
- GitHub 仓库：https://github.com/xinghe-1018/dsh-token-plan-quota
