用途
AI Badger 是一个本地优先的仓库上下文桥接工具，主要服务于代码审查、设计问题解答以及编码代理工作流。它帮助用户利用已有的 AI 聊天工具（如 Claude、ChatGPT、Grok 等）对代码变更获得“第二意见”。其核心目标是本地准备聚焦的上下文，让用户完全控制分享给 AI 的内容，避免因反复提交整个仓库而浪费 token。
主要能力
- 本地处理：所有上下文准备均在本地完成，没有自动上传、无需 API 密钥、无遥测数据。
- 通用兼容：适用于任何 AI 聊天界面或本地模型。
- 用户控制共享：不会自动上传任何内容，用户完全掌控每次粘贴和写入。
- 节省 token 与成本：只发送相关上下文，而非反复将整个仓库喂给云端模型。
- 精准轻量：使用 Go 语言构建，快速且开销极小。
- 专用模式：内置
review和design模式，对应常见工作流。 - Git 变更独立审查：支持通过 CLI 或 VS Code 扩展对 Git 变更进行独立审查。
- Map → Extract 流程：用于更深入的仓库或设计问题。
使用方式
安装
- Homebrew（推荐）：通过 Homebrew 安装。
- 快速 Curl 安装：使用 Curl 脚本安装。
- 其他方式：Windows 安装、源码构建等请参见 docs/install.md。
- VS Code 配套扩展：同时提供官方 VS Code 伴侣扩展（GitHub 链接）。
独立审查 Git 变更
- VS Code：使用可选的配套扩展，打开源代码管理，选择 "AI Badger: Copy All Changes for Review"，然后将请求粘贴到 AI 聊天中。这种直接审查无需 CLI。
- CLI：在项目根目录运行
badger review，复制准备好的审查请求，粘贴到 AI 聊天中。
针对更深层的仓库或设计问题（Map → Extract）
- 在项目根目录运行
badger。交互会话默认以 Design 焦点启动。 - 输入你的目标（或将编辑器留空并按回车以探索项目）。
- 复制 Prompt 1 → 粘贴到 AI 聊天中。
- 当 AI 要求文件时，复制其回复 → 粘贴回 Badger。
- 复制 Prompt 2 → 粘贴回 AI。
- 将 AI 的回复粘贴到 Badger 中 → 审查并应用更改。
专用模式
badger code：明确以 Code 焦点启动。badger design：明确以 Design 焦点启动，编辑器为空。
完整用法请参见 docs/usage.md。更多资源包括：使用示例与演练、浏览器交接指南、配置（用户限制与外部上下文）、API 参考（用于编辑器和脚本的非交互式命令）、代理集成（为编码代理提供紧凑的仓库定位），以及限制与支持的项目、隐私与安全等文档。
适用场景
- 需要借助已有 AI 聊天工具对代码变更进行独立审查。
- 希望围绕代码仓库或设计问题进行深入问答。
- 在编码代理工作流中提供紧凑的仓库方向信息。
- 希望减少 token 消耗、避免上传整个仓库的开发者。
限制
具体功能限制和所支持的项目类型暂未在提供资料中详细列出，需参考仓库中的“限制与支持的项目”文档。
