SAM：macOS 本地 AI 助手

项目简介

SAM（Synthetic Autonomic Mind）是一款原生 macOS AI 助手，面向非开发者用户设计。它强调「数据留在你的 Mac 上」：可使用 MLX 或 llama.cpp 运行本地模型，也可以按需切换到云端服务商，由你自行选择。作者最初是为妻子打造，希望助手能处理文档、调研购物、生成图片并记住聊过的内容。

主要功能

文档与研究

• 上传 PDF、Word、Excel、文本文件并就其内容提问
• 结合 Google、Bing、Amazon、Yelp、TripAdvisor 的实时数据做在线调研
• 用 Shared Topics 把相关对话串联起来
• 按语义而非仅关键词搜索历史记录

写作与沟通

• 起草邮件、文章或报告，给出改写建议
• 头脑风暴、整理思路、多语言翻译

创意与设计

• 通过 ALICE 根据文字描述生成图像
• 从 CivitAI 与 HuggingFace 浏览和下载模型
• 应用 LoRA 适配特定画风，用自己的文档与对话训练自定义模型

组织与效率

• 用语音指令管理文件与文件夹
• 制定项目计划与任务清单，按项目文件夹组织工作
• 通过 SAM-Web 在 iPad 或手机上访问 SAM

数学与计算

• 计算房贷、小费、复利、ROI，换算温度、长度、重量、体积、速度等单位
• 由 Python 实际计算得出结果，而非让 AI 估算

语音控制

• 「Hey SAM」唤醒词，支持免手操作
• 语音识别与文字转语音，配合本地模型可离线使用

人格设定

可选择友好、专业、创意等说话风格，也可以自定义。

安装与使用

推荐使用 Homebrew 安装：

brew tap SyntheticAutonomicMind/homebrew-SAM
brew install --cask sam

也可以从 GitHub Releases 下载后拖入 Applications 文件夹。

首次使用：

1. 启动 SAM，按 , 打开设置
2. 进入 AI Providers 标签页，点击 Add Provider
3. 选择云端服务商并填入 API Key，或在 SAM 内下载本地模型
4. 按 N 新建对话开始输入，说「Hey SAM」即可免手操作

支持的提供方包括 OpenAI、GitHub Copilot、DeepSeek、Google Gemini、MiniMax、OpenRouter、Ollama Cloud、Z.AI，以及本地 MLX、本地/远程 llama.cpp 和任意 OpenAI 兼容 API，并可在对话中途切换。

注意事项

• 使用 SAM 需要 macOS 14.0（Sonoma）或更高版本、至少 4GB 内存（建议 8GB 以上）、3GB 可用磁盘空间
• 运行本地模型建议 16GB 以上内存、20GB 以上可用磁盘空间，Apple Silicon 机型体验更佳
• 对话保存在 ~/Library/Application Support/SAM/，API Key 存放在 macOS Keychain，无遥测与追踪
• 使用云端服务商时，仅发送你提交的消息给对应服务商
• 项目采用 GPL-3.0-only 许可证

---

本作品整理自 GitHub 开源项目 SyntheticAutonomicMind/SAM，原作者 @SyntheticAutonomicMind，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。