apfel: 在 Apple Silicon Mac 上零成本调用本地 Apple Intelligence

什么是 apfel？

apfel界面

apfel 是一款专为搭载 Apple Silicon（M 系列芯片）的 Mac 用户设计的开源工具，旨在通过命令行（CLI）或本地服务器直接调用 macOS 内置的 Apple Intelligence (Apple Foundation Model)。

📄 原文链接: https://github.com/Arthur-Ficial/apfel

核心价值

该工具打破了 Apple Intelligence 仅能通过 Siri 或系统功能调用的限制，让开发者能够以「零成本、零配置、完全本地化」的方式利用 Mac 自带的大语言模型（LLM）。

✅ 零成本：不依赖云端 API，无订阅费
✅ 零配置：开箱即用，无需复杂设置
✅ 本地化：全本地推理，保护隐私

主要功能

🖥️ 多样化交互方式

单次命令调用：快速执行单个任务
交互式聊天（--chat）：连续对话模式
流式输出（--stream）：实时显示生成内容

🔧 UNIX 集成

支持管道操作（Pipe），可轻松处理文件内容（-f）或将结果传递给 jq 等工具处理。

🌐 OpenAI 兼容服务器

提供本地 HTTP 服务器（--serve），支持 OpenAI 标准 API 接口。用户可直接在 Python SDK 或现有 AI 工具中将 Base URL 替换为 localhost 调用，无需 API Key。

🛠️ MCP 工具支持

内置 Model Context Protocol (MCP)，支持挂载外部工具（如计算器、脚本等），实现模型自动调用函数。

💬 上下文管理

提供多种策略（如滑动窗口、自动总结旧对话）来管理 4096 标记（Tokens）的上下文窗口。

技术要求与限制

环境要求

项目	要求
芯片	Apple Silicon (M1/M2/M3/M4 系列)
系统	macOS 26 (Tahoe) 或更高版本
功能	开启 Apple Intelligence

性能特点

本地推理：不依赖网络连接
无计费：无 Token 消耗或订阅费用
响应快：利用 Apple Silicon 神经引擎

当前限制

仅支持 Apple 官方提供的基础模型
不支持多模态（图像/视觉）
不支持向量嵌入（Embeddings）

应用场景

apfel 非常适合开发者的日常工作流：

场景	示例
Shell 助手	`demo/cmd` - 用自然语言生成命令
代码审查	解释 `git diff` 输出
日志分析	分析本地日志文件
隐私优先	处理敏感数据，不上传云端

快速开始

# 安装（通过 Homebrew 或其他方式）
brew install apfel

# 单次调用
apfel "解释什么是递归"

# 交互式聊天
apfel --chat

# 启动服务器
apfel --serve --port 8000

# 处理文件
apfel -f code.py "这段代码有什么问题？"

总结

apfel 为 Apple Silicon Mac 用户提供了一个免费、私密、高效的本地 LLM 解决方案。对于注重隐私、希望降低 AI 工具成本的开发者来说，这是一个值得尝试的工具。

💡 适用人群: Apple Silicon Mac 用户、隐私敏感开发者、希望零成本使用 LLM 的技术人员