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 讓一切保持在終端內，只需一個詞，問題即可解決。