Mac 上跑本地 AI:一步步搭建离线模型助手
教你用 Mac 本地的 AI 模型和 Swift 搭建一个离线图片分析工具,无需网络,免费运行。
很多 AI 功能都要联网、付费,但如果你用的是较新的 Mac,一个强大的语言模型其实已经躺在你的硬盘里了。Apple 的 Foundation Models 框架就是用来调用这个本地模型的——它完全在 Mac 上运行,不联网、不收费,你的数据也不会离开电脑。
准备工作
- 一台搭载 Apple Silicon(M1 或更新)的 Mac,系统版本为 macOS 15.0+。
- 确保 Apple Intelligence 功能已开启(系统设置 > Apple Intelligence & Siri)。
- 安装 Xcode(从 Mac App Store 免费下载),用于编译 Swift 代码。
- 安装 Node.js(建议 LTS 版本),用于运行网页前端。
安装步骤
- 打开终端,运行
git clone https://github.com/03balogun/vision-bridge.git下载项目源码。 - 进入项目目录:
cd vision-bridge。 - 安装前端依赖:
npm install。 - 用 Xcode 打开
VisionBridgeCompanion/VisionBridgeCompanion.xcodeproj,选择你的 Mac 作为运行目标,然后点击运行按钮(▶️)。这会在后台启动一个本地服务器。 - 回到终端,运行
npm run dev启动网页界面。浏览器会自动打开http://localhost:5173。
验证是否成功
- 网页上会显示一个上传图片的区域。点击或拖拽一张图片上去。
- 稍等几秒,下方会显示 JSON 格式的分析结果,包括文字识别、摘要、标签等。
- 如果看到错误提示,检查 Mac 是否满足硬件和系统要求,以及 Apple Intelligence 是否开启。
下一步可以做什么
- 修改前端的
src/App.jsx调整界面样式或添加新功能。 - 在 Swift 代码
Companion.swift中修改提示词(prompt),让模型输出不同格式的结果。 - 尝试将同样的模式应用到其他本地功能,比如语音识别或图像分类。
内容来源
freeCodeCamp
发布时间
2026-07-22 01:30