METR 研究發現開發者認為 AI 讓自己快了 20%。實際量測:慢了 19%。我想要自己使用情況的資料,於是做了一個在本機執行的效能工具。

aide 儀表板總覽

這是什麼

aide 會把 Claude Code 與 Codex 的工作階段日誌(JSONL)匯入 SQLite,呈現各專案的狀況:成本、token 使用量、工作階段模式、效能趨勢、審查佇列,以及重複出現的工作流程摩擦。

它也會把重複出現的發現轉成建議的專案知識。你要先審查並接受這些產出,它們才會成為未來人類或代理人工作的操作手冊或開場簡報。

零 LLM 呼叫。執行成本為零。所有資料都留在本機。

~/.claude/projects/**/*.jsonl → Claude parser → SQLite → aide
~/.codex/sessions/**/*.jsonl  → Codex parser  → SQLite → aide

問題所在

Claude Code 與 Codex 會產生詳盡的本機日誌:訊息、工具呼叫、token 計數、時間戳記、指令與中繼資料。檔案就放在 ~/.claude/projects/~/.codex/sessions/,卻沒人去看。

每個人對 AI 編程工具值不值得都有意見,卻沒人有資料。我隨著時間有變得更有效率嗎?哪些專案吃掉最多 token?工作階段反覆在哪裡出錯?更好的指示或操作手冊真的減少了摩擦嗎?

真正有用的視角是你所有工作階段的個人趨勢,再加上一個把重複錯誤轉成更好未來脈絡的回饋迴圈。單一份工作階段逐字記錄兩者都看不出來。

運作方式

資料流程

  1. 探索 - 找出已設定的 Claude 與 Codex JSONL 來源
  2. 解析 - 把各供應商特有的事件正規化成單一工作階段模型
  3. 工作區塊 - 以 30 分鐘的閒置間隔把每個工作階段切成連續的編程時段
  4. 匯入 - 以增量方式 upsert 進 SQLite,並追蹤檔案 mtime
  5. 審查迴圈 - 為可疑的工作階段排名、歸類重複成因,並提出可供審查的產出

成本估算

所有成本都以目前的 API 費率估算。訂閱制使用者(Pro/Max)可以切換開關,改看以 token 為基礎的指標而非金額。

主要功能

總覽儀表板

摘要卡片、效能指標(快取命中率、編輯比例、壓縮率、錯誤率)、趨勢圖表、每週工作區塊數。

含效能指標與趨勢圖表的總覽頁

效能

專案與供應商彙總會把最近 30 天與前一個 30 天相比:每個工作階段的平均成本、活躍時間、審查佇列比率、編輯歸屬,以及工具錯誤率。

行動摘要會把重複出現的調查訊號歸類,例如沒有編輯的工作、專案歸屬薄弱、缺少前綴規則,以及編輯歸屬缺口。每項行動都可以連回造成它的那些工作階段。

工作階段細節

深入任一工作階段:token 拆解、工具使用、經手檔案及其讀取/編輯/寫入次數、工作區塊時間軸、錯誤分類。

顯示 token、工具與檔案的工作階段細節

洞察

首次提示的成效、成本集中度、時間模式、模型使用、工具序列、思考區塊分析、權限摩擦,以及調查行動。

含首次提示分析與時間模式的洞察頁

更多

  • 工作階段驗屍 - aide autopsy <session-id> 會產生單一工作階段的診斷報告:成本拆解、脈絡視窗分析、壓縮偵測,以及專案指示的改進建議。
  • 產出審查 - 重複出現的發現會變成建議的語意產出。被接受的產出會餵進操作手冊與任務簡報。
  • 訂閱模式 - 讓 Pro/Max 訂閱者在 API 成本檢視與以 token 為基礎的指標之間切換。
  • CLI 統計 - aide stats 會直接在終端機印出快速摘要,不必打開網頁瀏覽器。

技術細節

工作區塊

JSONL 裡的一個「工作階段」不過是一個終端機視窗一直開著。從週一橫跨到週三、中間還睡了覺的工作階段會被讀成 48 小時,讓「時長」完全沒有意義。

訊息之間的間隔分布是雙峰的:大多數間隔在 5 分鐘以內(正在工作),另有一小群超過 30 分鐘(人不在)。以 30 分鐘為門檻可以乾淨地分開這兩個模式。

每個工作階段都會切成工作區塊,也就是連續的編程時段。「35 個工作階段共 119 個工作區塊」比「35 個工作階段」告訴你更多。

錯誤分類

工具錯誤會自動分類:測試(pytest、jest)、Lint(ruff、eslint)、建置(pip、npm)、Git、編輯不符、檔案存取。大部分「錯誤」其實是正常的迭代(編輯-測試-修正循環中的測試失敗)。儀表板會把迭代與真正的錯誤分開。

效能指標

  • 快取命中率 - 輸入脈絡中由快取提供的百分比(越高=重用越好)
  • 編輯比例 - 工具呼叫中屬於檔案編輯的百分比(越高=產能越高)
  • 壓縮率 - 觸及脈絡上限的工作階段百分比
  • 讀取與編輯之比 - 每次編輯對應的讀取次數(越低=找東西越少)
  • 迭代率 - 有檔案被編輯 3 次以上的工作階段
  • 審查率 - 近期工作階段中值得人工審查的百分比
  • 編輯歸屬 - 編輯/寫入呼叫中能對應到檔案路徑的百分比

AI 編程日誌是一座金礦。 每一次工具呼叫、token 計數、時間戳記與指令形態都在裡面。難的是決定哪些指標真的重要。

工作區塊改變了一切。 原始的工作階段時長讓每張圖表都失真。以閒置間隔切分後,資料才誠實。資料清理比花俏的視覺化更重要。

零 LLM 呼叫是正確的限制。 每個指標都是啟發式的。沒有 API 呼叫,沒有邊際成本。想重新匯入與重建幾次都可以。

技術堆疊

  • Python 3.12+,搭配 Click CLI
  • Flask + Jinja2 樣板
  • Chart.js(CDN)製作互動圖表
  • Tailwind CSS(CDN)負責樣式
  • SQLite(標準函式庫)作為儲存
  • uv 負責套件管理