DeepSeek Harness (DSH) 采用插件化架构。在使用 MiniMax Token Plan 订阅时，查看剩余额度通常需要打开浏览器控制台或跳转到 MiniMax 官网。dsh-minimax-usage 插件通过读取官方的 Token Plan 用量接口，将剩余额度直接显示在 Web UI 的模型选择器旁，方便在对话过程中快速确认状态。
基本信息¶
- 名称：dsh-minimax-usage
- 类型：客户端插件
- 维护者：pan17
- 许可证：MIT
- 作用：在 DSH Web UI 中内联显示 MiniMax Token Plan 的 5 小时和 7 天剩余进度条及详情。
安装与启用¶
推荐使用 npm 安装。安装命令如下：
npx @deepseek-ai/dsh plugin --profile web add dsh-minimax-usage
安装后需要重启 DSH。
注意：npm 上 dsh 这个名字早在 2016 年就被一个不相关的 JS shell 包占用了，该包没有暴露 CLI bin，会报 could not determine executable to run。DSH 的 CLI 在 scoped 包 @deepseek-ai/dsh 下，必须使用完整名称。
如果遇到 pnpm 提示不允许跑构建脚本（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），需要在 profile 的 pnpm-workspace.yaml 中添加以下配置，然后重跑安装命令：
allowBuilds:
dsh-minimax-usage: true
功能说明¶
1. 内联用量条与悬停详情¶
插件会在对话框的模型选择器左侧显示一个紧凑的用量条，包含 5 小时和 7 天两条剩余进度。鼠标悬停或使用键盘聚焦该区域，可以查看国内站/国际站、套餐名、窗口进度和重置倒计时。
2. 按 Provider 显示¶
只有当当前选择的 provider 为 minimax-cn 或 minimax Token Plan 时，用量条才会显示。如果选择了其他 provider（即使模型名中包含 MiniMax），该区域也会保持隐藏。
3. 交互操作¶
- 点击刷新：点击用量条可强制刷新数据，不会改变当前的模型选择或触发发送操作。
- 密钥来源：插件优先读取 DSH 上下文中的凭据，其次读取进程环境变量。国际站使用
MINIMAX_API_KEY，国内站使用MINIMAX_CN_API_KEY。
4. 自动刷新机制¶
插件的刷新逻辑如下：
* 运行时刷新：只有实际运行中的 Agent 使用 minimax 或 minimax-cn Token Plan provider 时，才会每 30 秒强制拉取一次官方用量。
* 空闲刷新：当 Agent 回到空闲状态且本轮使用过 MiniMax 后，会先等待 15 秒执行一次空闲刷新。之后心跳间隔从 2 分钟起每次翻倍（2m, 4m, 8m…），上限为 24 小时。再次使用 MiniMax 并空闲后，心跳重置回 2 分钟。
* 重置刷新：每轮快照会在 5 小时窗口的重置时刻 + 30 秒后触发一次“重置后刷新”，以第一时间拉取翻页后的额度。
* 缓存读取：用量条本身每 15 秒只读 Host 缓存，点击则强制刷新。
使用示例¶
- 在 DSH 的 设置 → 模型 中，填写 MiniMax 的 Token Plan 订阅 Key（注意：不能使用普通的按量付费 API Key）。
- 在对话框中选择 MiniMax Token Plan 模型。
- 模型选择器左侧会出现用量条，悬停查看详情，点击刷新。
注意事项¶
- Key 类型区分：订阅 Key 与普通开放平台 API Key 不能混用。如果用量接口拒绝普通 Key，页面会提示改用订阅 Key。
- 数据展示：插件原样展示官方剩余额度，不进行本地“修正”扣费。
remains_time的语义以 MiniMax 控制台为准。 - 零额度处理：
*_quota = 0的模型会显示为“未包含”，而不是 0%。 - 生态背景：DSH 的插件目录（如 SkillHub）是独立站点，与 DeepSeek 或幻方无官方从属关系。
