apfel
免費的 AI 已內建於你的 Mac。CLI 工具、OpenAI 相容伺服器，以及互動式聊天——全部透過 Apple Intelligence 在裝置端執行。無需 API 金鑰、無需雲端、無需下載。
apfel 是什麼？
免費的 AI 已內建於你的 Mac。CLI 工具、OpenAI 相容伺服器，以及互動式聊天——全部透過 Apple Intelligence 在裝置端執行。無需 API 金鑰、無需雲端、無需下載。
apfel 概覽
這是什麼
apfel 是一個命令列工具，能透過 Apple Intelligence 啟用 Apple Silicon Mac 內建的大型語言模型（Apple FoundationModels）。它完全在裝置端運作，不需要 API 金鑰、雲端連線或額外下載。apfel 提供三種模式：UNIX 管道友善工具、OpenAI 相容的本地伺服器，以及互動式聊天 REPL。
主要功能
- UNIX 工具模式：可透過引數或管道輸入接受提示，支援附加檔案（文字、PDF、圖片）、JSON 輸出、結束代碼，以及符合 JSON Schema 的引導生成。
- OpenAI 相容伺服器：執行於
http://localhost:11434/v1，支援聊天完成（串流與非串流）、Responses API、模型列表與健康端點。 - 互動式聊天 REPL：
apfel --chat可快速測試提示或與 MCP 伺服器互動。 - 工具呼叫：在所有情境（UNIX 工具、伺服器、聊天）中皆可運作，並支援 Model Context Protocol（MCP）伺服器（本機腳本與遠端 Streamable HTTP）。
- 示範腳本：內建可執行的 shell 腳本（如
cmd、oneliner），封裝 apfel 以執行常見任務；透過apfel demos提取。 - 符合 Schema 的 JSON 輸出：使用
--schema強制模型輸出符合指定 JSON Schema。 - Token 計數：
--count-tokens可預先估算提示的 token 預算。
使用情境
- 腳本與自動化：將資料透過管道傳入 apfel 進行摘要、翻譯、程式碼生成或差異審查。
- 本地 AI 後端：以本地 OpenAI 相容伺服器取代雲端 API，供使用 OpenAI SDK 的應用程式使用。
- 互動式探索：使用
apfel --chat測試提示或 MCP 工具。 - 檔案分析：附加 PDF、圖片或文字檔案，進行裝置端 OCR、文字萃取與內容理解。
- 程式碼生成：
apfel --code僅輸出程式碼不含說明文字，適合直接導向檔案或剪貼簿。
快速開始
透過 Homebrew 安裝： bash brew install apfel 或從原始碼建置（需 macOS 26.4 SDK / Swift 6.3）： bash git clone https://github.com/Arthur-Ficial/apfel.git && cd apfel && make install 快速入門： bash apfel 'Hello, Mac!' apfel --serve curl http://localhost:11434/v1/chat/completions -H 'Content-Type: application/json' -d '{}'
授權與價格
授權：MIT。價格：開放原始碼（免費）。
內容整理自該專案公開的 README 與儲存庫資訊。
