promptfoo：從 README 拆解使用路徑與限制
測試您的提示、代理和 RAG。 AI 紅隊/滲透測試/漏洞掃描。比較 GPT、Claude、Gemini、DeepSeek 等的效能。具有命令列和 CI/CD 整合的簡單聲明性配置。由 OpenAI 和 Anthropic 使用。
秒懂
- 它是什麼？
- Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 本文以 promptfoo/promptfoo 的 README、版本 0.122.2 與授權資料整理適用範圍。
- 適合誰用？
- 適合需要 promptfoo 所描述能力、且能依 README 準備環境與處理限制的使用者；不適合把宣傳文字當成相容性或效能保證的人。採用前先執行 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval，記錄輸入、輸出、日誌與版本 0.122.2 的差異，再依 MIT 檢查修改、部署與分發方式。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
Prompt、Agent 與 RAG 的評測面
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 Prompt、Agent 與 RAG 的評測面 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 1。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 1。
基線曾把「promptfoo/promptfoo 的 README 將專案描述為「Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning f」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 1。
promptfoo init 的最小案例
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 promptfoo init 的最小案例 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 2。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 2。
基線曾把「 your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claud」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 2。
API key 與模型比較
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 API key 與模型比較 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 3。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 3。
基線曾把「ming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple de」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 3。
Red teaming 和報告輸出
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 Red teaming 和報告輸出 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 4。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 4。
基線曾把「or AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and 」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 4。
CI/CD 中的宣告式設定
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 CI/CD 中的宣告式設定 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 5。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 5。
基線曾把「e, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration.」。本文只整理倉庫可直接核對的內容，不把 s」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 5。
MIT 授權與敏感資料
promptfoo 的 README 將這個專案放在 Test your prompts, agents, and RAGs. Red teaming/pentesting/vulnerability scanning for AI. Compare performance of GPT, Claude, Gemini, DeepSeek, and more. Simple declarative configs with command line and CI/CD integration. Used by OpenAI and Anthropic. 的脈絡裡。本節只採用 promptfoo/promptfoo 公開文件能直接支持的判斷，並把版本 0.122.2 當作追蹤點。它適合拿來理解 MIT 授權與敏感資料 涉及的工作邊界，但不能從專案名稱推導出 README 沒有承諾的效能、平台或服務等級。段落索引 6。
實際閱讀時，應把輸入、處理步驟、輸出物和錯誤行為分開記錄。promptfoo 的相關入口包括 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval。若命令需要環境變數、模型服務、網路、硬體或額外權限，文件未說明的部分就維持未說明，不用同類工具的經驗代填。這樣才能看出 promptfoo/promptfoo 是可直接使用的工具、需要整合的元件，還是仍要承擔較多維護工作的專案。段落索引 6。
基線曾把「clarative configs with command line and CI/CD integration.」。本文只整理倉庫可直接核對的內容，不把 star、Fork 或宣傳語當成品質證明。README 在「Promptfoo: 」列為背景。重寫後的重點是把它連回 promptfoo 自己的檔案與命令：先在隔離目錄執行專案入口，觀察終端輸出、生成檔、瀏覽器畫面或裝置反應，再與 README 的預期逐項比對。一次只改一個設定，失敗時保留完整錯誤訊息，避免把未驗證的推測寫成 promptfoo 的功能。段落索引 6。
編輯結論
適合需要 promptfoo 所描述能力、且能依 README 準備環境與處理限制的使用者；不適合把宣傳文字當成相容性或效能保證的人。採用前先執行 npm install -g promptfoo；promptfoo init --example getting-started；promptfoo eval，記錄輸入、輸出、日誌與版本 0.122.2 的差異，再依 MIT 檢查修改、部署與分發方式。
社群筆記