Brytlog: 面向開發者的AI日誌工具

Brytlog 是一款開源的命令列工具，旨在解決開發者和 AI 代理在處理冗長原始日誌時的痛點。它透過包裝任何命令列程式，捕獲其標準輸出和錯誤輸出，並利用輕量級語言模型（例如 Gemini-3-flash）生成簡潔的摘要，從而顯著節省時間、降低令牌消耗。

在代理工作流中，Brytlog 充當一個廉價、快速的前處理器。以 Claude Opus 4.8 作為主代理為例，若執行 brytlog python run.py 而非直接的 python run.py，主代理將不再需要處理完整的原始輸出（這既慢又昂貴且導致上下文膨脹），而是獲得一個由更便宜的模型生成的簡明報告。作為安全措施，原始日誌仍會儲存，以便主代理或開發者必要時查閱（該功能可在配置中切換）。即使便宜的模型也不會獲得完整的原始轉儲，而只會接收到重要部分，從而進一步節省時間和費用。在非代理的開發者驅動型工作流中，Brytlog 同樣能為開發者節省分析原始輸出的時間，或避免手動將日誌複製貼上到編碼助手中。

Brytlog 的特點包括：免費、開源、平臺/語言/LLM 供應商無關、安裝配置極簡（只需自帶金鑰或本地執行）、無需修改現有程式碼（只需在 AGENTS.md 中新增幾行）、輕量（約 50KB，約 1400 行程式碼）、可定製、注重隱私（不收集任何資料，並將敏感資訊脫敏後再傳遞給 LLM）。

使用方式非常簡單：透過 pip install brytlog 安裝後，執行 brytlog --config 或直接使用 brytlog 字首執行命令即可啟動配置流程。配置時需要指定 LLM 提供商（如 Anthropic）、模型（如 claude-haiku-4-5）和 API 金鑰。支援 Google Gemini（需從 Google AI Studio 獲取金鑰）、自定義 OpenAI 相容端點（如 Ollama、vLLM），以及標準 Authorization: Bearer 頭部。

基本用法是在任意命令前加上 brytlog，例如 brytlog python run.py。也支援鏈式多條命令，只需將整條命令用引號括起。在代理工作流中，可將使用說明新增到 AGENTS.md 中，讓代理自動利用 Brytlog 進行命令執行。

Brytlog 的工作機制是：將給定命令作為子程序執行，預設情況下將 stdout 和 stderr 重定向離開終端，僅輸出簡潔的 AI 摘要。它能夠檢測三種場景：乾淨成功（直接輸出成功資訊）、成功但含警告（取樣並生成警告摘要）、以及崩潰（生成問題/修復報告）。CLI 標誌和環境變數提供了豐富的自定義選項，例如 --quiet 可抑制原始日誌的即時顯示（預設開啟），--no-quiet 則可顯示即時流。環境變數可以控制 API 金鑰、提供者、輸入最大令牌數（預設 4000）、系統提示詞、模型溫度等。配置檔案全域性儲存於 ~/.brytlog.json，日誌檔案本地儲存於 brytlog-reports/ 和 brytlog-raw/ 目錄。

總而言之，Brytlog 是一個輕量級、開源、跨平臺且與語言無關的解決方案，透過 AI 摘要技術顯著提升開發者和 AI 代理處理終端日誌的效率。