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