minimax-usage

Minimax Usage Skill 是一款专为 Minimax Coding Plan 用户设计的轻量级用量监控工具，通过简洁的 Bash 脚本实现 API 配额实时追踪与预警管理。

核心用法方面，用户需在脚本同级目录创建 .env 文件配置 MINIMAX_CODING_API_KEY 和 MINIMAX_GROUP_ID，执行 ./minimax-usage.sh 即可获取当前配额状态。脚本通过 HTTPS 调用 Minimax 官方平台接口，返回包含已用提示数（默认上限 1500）、剩余额度、重置倒计时（5 小时窗口）及状态分级（绿/黄/红）的结构化信息，并自动计算百分比用量。

显著优点体现在极简的依赖设计：仅需系统标准工具 curl 和 jq，无复杂环境配置；输出直观友好，通过颜色编码和百分比清晰展示用量健康度；代码完全透明可直接审计，无黑盒操作；支持动态重置机制，5 小时前的用量自动释放；提供三级阈值预警（60%/75%/90%），帮助用户提前规划。

潜在局限包括功能单一性——仅支持 Coding Plan 监控，与 Minimax 标准 API 密钥体系不互通；需要用户手动管理 .env 文件，相对路径加载机制在多目录场景下可能引发配置混乱；依赖 jq 工具，在精简系统环境中需额外安装；缺乏历史数据持久化和趋势分析功能，仅支持当前状态快照。

适用群体主要为 Minimax Coding Plan 订阅开发者、需要严格管控 API 成本的技术团队，以及对命令行操作熟悉的运维人员。特别适合高频调用 MiniMax-M2 模型、需要设置用量阈值告警的场景。

使用风险涉及 API Key 以 Bearer Token 形式明文传输，需确保 .env 文件权限设置（建议 600）并避免提交至版本控制；脚本从相对路径加载配置，若文件位置不当可能导致配置失效；虽然使用 HTTPS 加密，但 API Key 一旦泄露可能导致配额被盗用；作为个人开发者（T3）作品，长期维护更新频率存在不确定性；此外，1 prompt 约等于 15 次模型调用的换算关系需用户准确理解，避免误判实际消耗。