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 代理處理終端日誌的效率。