这个项目能做什么

mcode-monitor 是一个面向 MiniMax Code 的本地用量监控面板，以 Mini App 形式提供。官方 Mini App 仓库已收录该项目，本仓库为开发主版本，更新会同步提交到官方仓库。 主要用途是查看 MiniMax Code 的 token 消耗情况。安装后可从 MiniMax Code 的 Mini App 入口打开「Token 用量看板」，随时查看用量数据。 功能方面： - KPI 总览：token 消耗、输入/输出/缓存读取、缓存命中率、请求次数、平均输出速度 - Token 消耗时序：按时间跨度自动分桶，缓存与输入堆叠柱状图配合输出曲线 - 模型/会话筛选：多选下拉，会话以真实会话文件为准，实时作用于全部图表与表格 - 按模型拆分：可一键切换为各模型的输出曲线 - 模型对比：输入总量柱状图，配合调用次数与输出速度双曲线 - Token 速度：最近 60 次请求的逐次 tok/s 折线 - 最近调用明细与汇总：时间、模型、会话、tokens、耗时、速度 - 筛选条件、时间范围、刷新间隔与主题会被记住 - 亮/暗双主题，跟随系统 - 时间范围：最近 1 小时、24 小时（默认）、7 天、30 天、全部 - 自动刷新：5s、10s、30s、手动 安装要求本机具备 Python 3.8+，无需通过 pip 安装任何依赖包。将仓库中的 miniapps/mcode-usage-monitor 文件夹放入 ~/.minimax/plugins/ 目录即可：Windows 对应 C:\Users\<用户名>\.minimax\plugins\mcode-usage-monitor，macOS/Linux 对应 ~/.minimax/plugins/mcode-usage-monitor。卸载时删除该文件夹即可。 数据读取方式为只读读取本地数据库，不影响正在使用的 MiniMax Code。包内附有英文与中文说明文档。 指标定义：Token 消耗为输入加缓存读取加输出；缓存命中率为 prompt 中直接命中缓存的比例；输出速度为输出 tokens 除以耗时的加权平均。计费与额度以 MiniMax Code 产品内的用量页展示为准。 项目说明中提到，代码与文档由 MiniMax Code（AI 编程助手）生成并迭代，作者负责需求定义、方向决策与验收。思路来源为 zcode-monitor 项目。第三方组件使用 ECharts（Apache License 2.0），已本地化打包以便离线使用。项目采用 MIT 许可证。