mcode-monitor

mcode-monitor は、MiniMax Code 向けのローカル使用量監視パネルで、Mini App 形式で提供されます。公式 Mini App リポジトリには本プロジェクトが収録されており、本リポジトリは開発メインバージョンです。更新は公式リポジトリにも同期してコミットされます。 主な用途は MiniMax Code のトークン消費量の確認です。インストール後、MiniMax Code の Mini App 入口から「Token 使用量ダッシュボード」を開くと、いつでも使用量データを確認できます。 機能面： - KPI 概要：トークン消費量、入力/出力/キャッシュ読み取り、キャッシュヒット率、リクエスト回数、平均出力速度 - トークン消費量の時系列：時間範囲に応じて自動でバケット分割し、キャッシュと入力を積み上げ棒グラフで表示し、出力曲線と組み合わせて表示 - モデル/セッション絞り込み：複数選択ドロップダウン。セッションは実際のセッションファイルに基づき、すべてのグラフとテーブルにリアルタイムで反映 - モデル別分割：ワンクリックで各モデルの出力曲線に切り替え可能 - モデル比較：入力総量の棒グラフに、呼び出し回数と出力速度の二重曲線を組み合わせて表示 - トークン速度：直近 60 回のリクエストにおける毎回の tok/s 折れ線 - 直近の呼び出し詳細と集計：時刻、モデル、セッション、トークン数、所要時間、速度 - 絞り込み条件、時間範囲、更新間隔、テーマは記憶されます - ライト/ダークのデュアルテーマ、システムに追従 - 時間範囲：直近 1 時間、24 時間（デフォルト）、7 日間、30 日間、すべて - 自動更新：5 秒、10 秒、30 秒、手動 インストールにはローカルマシンに 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 には影響しません。パッケージ内には英語と中国語の説明ドキュメントが同梱されています。 指標の定義：トークン消費量は入力＋キャッシュ読み取り＋出力です。キャッシュヒット率はプロンプト内で直接キャッシュにヒットした割合です。出力速度は出力トークン数を所要時間で割った加重平均です。課金と利用枠については、MiniMax Code 製品内の使用量ページの表示が基準となります。 プロジェクトの説明によると、コードとドキュメントは MiniMax Code（AI プログラミングアシスタント）によって生成・反復され、作者は要件定義、方向性の決定、検収を担当しています。着想の源は zcode-monitor プロジェクトです。サードパーティコンポーネントとして ECharts（Apache License 2.0）を使用しており、オフラインで利用できるようローカライズしてバンドルされています。プロジェクトは MIT ライセンスを採用しています。