Copilot Usage Analyzer

這是一個用於分析 GitHub Copilot 聊天記錄並估算成本的命令列工具。它會讀取本地的 Copilot Session Logs (.jsonl)，統計 Token 使用量，並根據模型定價表計算預估費用。

特色

• 自動偵測路徑：預設讀取使用者家目錄下的 Copilot 記錄檔 (~/.copilot/session-state)。
• 支援多種模型計價：包含 GPT-5, GPT-4, Claude 等模型的預估價格。
• 靈活統計：支援按日、月、小時進行統計。
• 排名與過濾：可根據成本排序，並限制顯示筆數。
• JSON 輸出：支援 JSON 格式輸出，方便與其他工具整合。
• 跨平臺支援：支援 Windows, macOS, Linux。

安裝

npm install -g @willh/cpusage

或者直接使用 npx 執行：

npx @willh/cpusage

使用方法

基本使用

直接執行命令，程式會自動尋找預設路徑下的記錄檔，並按日期降冪排序顯示：

cpusage

命令列參數

| 參數 | 說明 | | --- | --- | | -h, --help | 顯示說明訊息 | | --rank | 依預估成本降冪排序（預設顯示前 10 筆） | | --limit <n> | 限制顯示筆數（預設：若使用 --rank 為 10，否則顯示全部） | | --unit <unit> | 統計單位：day (預設), month, hour | | --verbose | 顯示詳細分析資訊（記錄檔路徑與數量） | | --list-price | 顯示目前的模型定價表 | | --json | 以 JSON 格式輸出結果（不包含統計標頭） |

範例

顯示成本最高的前 5 天：

cpusage --rank --limit 5

按月統計並輸出 JSON：

cpusage --unit month --json

查看目前的定價表：

cpusage --list-price

指定記錄檔路徑

如果你的記錄檔存放在其他位置，可以透過設定 SESSION_DIR 環境變數來指定：

Windows (PowerShell):

$env:SESSION_DIR="C:\path\to\your\logs"
cpusage

Linux / macOS:

SESSION_DIR=/path/to/your/logs cpusage

開發與建置

本專案使用 TypeScript 開發並使用 Bun 進行建置。

前置需求

• Bun (最新版本)

安裝依賴

bun install

執行開發模式

bun run start

建置專案

編譯 TypeScript 原始碼至 dist/ 目錄：

bun run build

CI/CD

本專案包含 GitHub Actions Workflow，每次 Push 或 Pull Request 會自動執行建置測試。

授權

MIT