AI Distiller（aid）是一款面向 AI 辅助开发的开源工具，核心功能是“代码蒸馏”：从整个项目或指定模块中提取 AI 编写代码所需的最关键信息——公共 API、类型签名、类层次结构等，丢弃方法实现和非公开结构，从而将代码量压缩到原始的 5–20%（通常压缩 90–98%），使大型代码库能够放入 AI 模型的上下文窗口中。该工具通过 tree-sitter 解析多种语言，所有语法解析器已内置，无外部依赖。
主要能力：
- 智能过滤：可控制可见性（public/protected/internal/private）、内容（注释、文档字符串、实现、导入）等，默认仅输出公共 API 签名和基本文档。
- 依赖感知蒸馏：分析跨文件调用图，仅包含实际被调用的代码，适合深度代码分析。
- AI 提示词生成：可生成专门的分析提示词，配合蒸馏代码用于 AI 驱动的分析，例如逐文件深度分析或多文件文档生成工作流；提示词可输出到 .aid/ 目录，供 Claude、Gemini 等 AI 代理执行。
- 多种输出格式：text（默认，超紧凑）、Markdown、JSON 结构化、JSONL、XML。
- 智能摘要输出：蒸馏后显示压缩效率和速度，支持进度条、股票行情式、速度仪表盘、迷你火花线、CI 友好、JSON 等格式。
- 项目根目录自动检测：自动向上查找 .aidrc、go.mod、package.json、.git 等标记，将输出集中到 <项目根>/.aid/ 目录。
- 语言支持：完整支持 Python、Go、JavaScript、PHP、Ruby；Beta 支持 TypeScript、Java、C#、Rust、Kotlin、Swift、C++；未来计划支持 Zig、Scala、Clojure。
- 性能：在 AMD Ryzen 7945HX 上，使用 12 个并行 worker 时处理时间约 36–41ms，压缩率 65–72%；支持 -w 1 串行或自定义 worker 数。对于 50+ 文件的大型项目性能可能受限，C#、C++、TypeScript 的语言处理器存在根本性限制。
- MCP 服务器：提供 NPM 包 @janreges/ai-distiller-mcp，可无缝集成到 Claude、Cursor 等支持 MCP 的 AI 工具中。
使用方式：
- 安装：提供 macOS/Linux/WSL 一行安装命令和 Windows PowerShell 安装命令，安装器会自动检测操作系统和架构，下载预编译二进制并安装到 ~/.ai-distiller 等位置。
- 基本使用：通过命令行运行 aid，可指定项目路径、输出格式、过滤选项等。
- 与 AI 工具集成：安装 MCP 服务器后，可在 Claude Desktop 等工具中使用；也可将蒸馏结果直接提供给 AI 代理。
- 提示词工作流：使用 --ai-action 参数生成分析提示词，保存到 .aid/ 目录或通过 --stdout 输出。
适用场景：
- 大型项目开发：帮助 AI 工具正确理解项目中的现有 API 和架构，避免生成不兼容代码。
- 代码重构与分析：依赖感知蒸馏可用于影响分析、代码导航、遗留系统理解、API 分析等。
- 降低 AI 成本：将大型框架（如 Django 约 1000 万 token）压缩至 25.6 万 token，减少 API 调用费用，使整个框架能放入单次对话。
- 文档生成：结合提示词生成多文件文档工作流。
限制：
- 工具本身不执行分析，仅准备优化后的提示词供 AI 代理执行。
- 部分语言（C#、C++、TypeScript）的解析能力和复杂调用模式支持有限。
- 大型项目（50+ 文件）性能可能下降。
- 默认仅输出公共接口，可能忽略一些内部依赖细节，但可通过 CLI 选项配置。
