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 代理处理终端日志的效率。