AI-fix：失败命令只需一个词就能修复

AI-fix 是一款创新的命令行工具，旨在彻底改变开发者处理终端错误的方式。当你在终端中执行命令并遭遇失败时，只需输入 ai-fix，工具便会自动接管整个修复流程：重新运行失败命令以捕获标准输出和错误，将错误信息连同系统上下文发送给 AI 模型，接收结构化的修复命令，然后应用修复并验证成功。整个过程无需离开终端，无需手动搜索 Stack Overflow 或文档。

该工具的核心工作原理分为四个步骤：捕获、发送、获取和应用。首先，AI-fix 会重新执行失败的命令，捕获其标准输出和标准错误输出。接着，它将错误信息与系统上下文（包括操作系统类型、Python 或 Node.js 的版本、项目配置文件列表如 package.json 或 pyproject.toml 等）一起发送给 AI 模型。默认使用的模型是 Anthropic 的 Claude Haiku——这是目前最快且最便宜的模型之一，用户也可以选择 OpenAI 的 GPT-4o-mini 作为备选。AI 模型分析后返回一组结构化的修复命令，并附带置信度评分。最后，AI-fix 会运行这些修复命令，然后重新执行原始命令以确认问题已解决。

AI-fix 能够处理多种常见的终端错误场景。例如，当 Python 提示模块缺失时（如 ModuleNotFoundError: No module named 'uvicorn'），AI-fix 会识别出问题并建议安装相应包（pip install uvicorn）。对于 npm 构建失败（如 tsc: command not found），它会推荐安装 TypeScript 编译器（npm install --save-dev typescript）。此外，它还能处理权限拒绝（chmod +x deploy.sh）、端口已被占用（使用 lsof 和 kill 释放端口）、Git 推送被拒绝（执行 git pull --rebase 后再推送）、Docker 守护进程未运行（启动 Docker）等多种情况。每个修复命令都会显示置信度等级：绿色表示高置信度，适用于常见错误；黄色表示中等置信度，可能需要根据具体环境调整；红色表示低置信度，建议用户仔细审查后再应用。

在成本方面，AI-fix 的设计极为经济。使用默认的 Claude Haiku 模型，每次修复的成本大约为 0.0003 美元，这意味着运行 3000 次修复才花费 1 美元。工具还提供了多种使用模式：可以直接修复上次失败的命令，也可以指定要运行的命令并自动修复（如 ai-fix npm run build）。通过 --dry-run 选项可以预览修复内容而不实际执行，使用 -y 可以跳过确认步骤实现完全自动化。此外，-v 选项可以显示完整的错误输出，便于调试。

隐私是 AI-fix 的重点考量之一。该工具仅发送必要的信息：失败的命令本身、错误输出（截断至 3000 字符）、操作系统信息、语言版本，以及项目文件名的列表（例如 package.json、pyproject.toml 等）。它从不发送文件内容、环境变量、API 密钥或当前目录之外的路径信息。所有传输均通过 API 进行，不存储任何用户数据。

AI-fix 支持多种 Unix shell 的历史记录读取，包括 zsh（~/.zsh_history）、bash（~/.bash_history）以及 fish（~/.local/share/fish/fish_history）。安装过程非常简单：通过 pip install ai-fix 安装，然后设置 ANTHROPIC_API_KEY 或 OPENAI_API_KEY 环境变量即可。项目使用 Python 3.11 或更高版本，并以 MIT 许可证开源发布。

对于开发者来说，AI-fix 最大的价值在于消除了调试过程中的上下文切换成本。当深入构建流程时，切换到浏览器搜索错误信息、阅读多篇 Stack Overflow 回答再返回终端，往往会耗费数分钟并打断思路。AI-fix 让一切保持在终端内，只需一个词，问题即可解决。