核心用法
Minimax Usage Skill 是一款轻量级 Shell 脚本工具，专为监控 Minimax Coding Plan 的 API 用量设计。用户只需配置 MINIMAX_CODING_API_KEY 和 MINIMAX_GROUP_ID 两个环境变量，即可通过 ./minimax-usage.sh 一键获取实时用量数据。脚本调用 Minimax 官方平台接口 https://platform.minimax.io/v1/api/openplatform/coding_plan/remains，返回当前周期内已用提示词数、剩余额度及重置倒计时，并以颜色编码（绿/黄/红）直观展示风险等级。
显著优点
1. 零依赖设计：纯 Bash 实现，无需额外运行时或库
2. 即时反馈：API 响应直接解析，无缓存延迟
3. 智能预警：内置 60% 用量阈值提醒，预留安全缓冲
4. 周期透明：动态计算 5 小时滑动窗口的重置时间
5. 用量换算：明确提示 1 prompt ≈ 15 model calls 的换算关系，便于成本估算
潜在缺点与局限性
- 平台锁定：仅支持 Minimax Coding Plan，不支持标准 API Key 或其他厂商
- 手动配置：需用户自行从网页控制台提取 GroupId，无 OAuth 自动化流程
- 单账户监控：一次只能监控一个 GroupId，无多账户聚合视图
- 无历史数据：仅展示当前周期用量，不提供趋势分析或导出功能
- Header 硬编码：依赖固定 user-agent 和 referer，存在因平台反爬策略失效的风险
适合人群
- 使用 Minimax M2 系列模型进行代码生成或补全的开发者
- 需要严格控制 API 预算的中小团队或个人项目
- 将 Minimax Coding Plan 集成到 CI/CD 流水线的前置检查环节
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | `.env` 文件若未加入 `.gitignore` 可能意外提交 |
| 接口变更 | Minimax 官方调整 Header 校验规则会导致脚本失效 |
| 用量误判 | 5 小时滑动窗口机制可能导致"已重置"幻觉，建议结合业务日志交叉验证 |
| 计划混淆 | Coding Plan 与标准 API 的密钥体系互斥，误用会导致认证失败 |