内容
# Merlin AI — 您的私人 AI 栈，适用于 macOS
您的私人 AI。在您的 Mac 上。永远。
Merlin AI 在 Apple Silicon 上安装了一个完全私有的本地 AI 栈，这样普通的 Mac 用户可以在设置完成后无需云账户、订阅或终端专业知识即可聊天、自动化和管理状态。
[](#)
[](LICENSE)
[](#requirements)
## 什么是 Merlin？
- 一个一键安装程序，用于在您的 Mac 上安装私人 AI。
- 一个本地助手，默认使用您拥有的硬件。
- 一个控制屏幕，显示正在运行的内容、什么是私有的以及接下来要做什么。
## 包含内容
| 包含的应用 | 普通英文用途 |
|---|---|
| Merlin Dashboard | 显示您的私人 AI 是否正在运行以及从哪里开始。 |
| Open WebUI | Merlin 背后的当前本地聊天工作空间。 |
| Ollama | 在 Apple Silicon 上运行本地 AI 模型。 |
| LiteLLM | 路由模型请求时优先考虑本地请求。 |
| Qdrant | 存储本地搜索/内存数据以用于检索功能。 |
| n8n | 可选的本地自动化工作流。 |
| OpenHands | 可选的本地编码/任务代理。 |
| Perplexica | 可选的私人搜索工作空间。 |
| SearXNG | 可选的私人搜索元搜索引擎。 |
| MCP | 本地模型/上下文路由支持。 |
## 要求
- 配备 Apple Silicon 的 Mac：M1、M2、M3 或 M4。
- macOS 13 或更新版本。
- 已安装并运行 Docker Desktop。
- 推荐 16 GB RAM。8 GB 可使用低/核心路径。
- 推荐 50 GB 可用磁盘空间。
## 安装
```bash
git clone https://github.com/TheYfactora12/Secure-Local--AI-Merlin.git
cd Secure-Local--AI-Merlin
bash install.sh
```
## 安装后
Merlin 在本地仪表板中打开：
```text
http://localhost:8888
```
## 前 5 分钟
安装后从此处开始：
1. 在 `http://localhost:8888` 打开 **Merlin Dashboard**。
2. 等待预热卡片完成检查本地服务。
3. 点击 **开始聊天** 以打开本地聊天工作空间。
4. 如果 Merlin 保持预热状态，请点击 **查看详情** 并打开 **系统** 标签页。
5. 如果系统显示某个服务需要关注，请运行：
```bash
cd ~/merlin-ai && bash scripts/doctor.sh
tail -n 120 /tmp/merlin-ai-install.log
```
第一个屏幕有三个任务：
- **开始聊天** 打开本地聊天工作空间。
- **自动化** 打开可选的本地工作流。
- **检查系统 / 查看详情** 显示服务状态和恢复指南。
Merlin 默认是私有的。除非您明确添加并启用云提供商，否则不会有任何数据离开此 Mac。
## 卸载
```bash
bash pkg/scripts/uninstall.sh
```
要完全清除，包括用户确认删除的本地 Merlin 数据：
```bash
bash pkg/scripts/uninstall.sh --purge-all
```
要进行最彻底的删除路径，Merlin 会在 `~/.merlin/install-manifest.json` 记录本地安装清单。未来，UI 应该将此作为普通英文选项公开。从终端，预先查看依赖项删除：
```bash
bash pkg/scripts/uninstall.sh --dry-run --purge-dependencies
```
实际依赖项删除需要明确的共享工具确认，因为 Docker Desktop、Ollama 和 Homebrew 可能被其他应用程序使用。
卸载是产品信任功能。用户必须能够有意地删除 Merlin 及其下载的组件。
## v1.0 焦点
Merlin AI v1.0 只有五个任务：
1. 一键安装所有内容。
2. 通知用户安装成功。
3. 默认情况下保持所有内容私有。
4. 在出现问题时恢复正常。
5. 清洁卸载。
房间、语音、Home Assistant、Linux、Windows、专业合规模式、先进代理和原生自动化运行时工作是未来的路线图项目，除非它们直接支持这五个任务。
## 有用的命令
```bash
bash scripts/status.sh
bash scripts/doctor.sh
bash scripts/update.sh --dry-run --profile core
bash scripts/upgrade.sh --dry-run --profile core
bash scripts/upgrade.sh --profile core
bash tests/installer-branding-smoke.sh
bash tests/pkg-readiness-smoke.sh
bash tests/uninstall-smoke.sh
```
## 安全更新
使用 `scripts/upgrade.sh` 进行回滚感知更新。它在拉取更新之前备份本地配置、Merlin 安装清单和当前镜像摘要。重启后，它会检查本地核心服务。如果健康检查失败，它会回滚到以前的 git 版本并保留已保存的 compose 配置。
`scripts/update.sh` 仍然可用以保持兼容性，并委派给相同的回滚感知升级路径。
Merlin 更新不会静默拉取 AI 模型。本地模型下载仍然是用户的明确选择。
## 发布状态
Merlin AI 正在准备进行受控的本地测试。在记录了干净的安装、 onboarding、隐私、恢复和卸载证据之前，它不是公开测试版或公开发布。
- 证据运行手册：[`docs/operations/TRUSTED_LOCAL_BETA_EVIDENCE.md`](docs/operations/TRUSTED_LOCAL_BETA_EVIDENCE.md)
- 当前路线图：[`docs/MERLIN_IMPLEMENTATION_ROADMAP.md`](docs/MERLIN_IMPLEMENTATION_ROADMAP.md)
- 产品北极星：[`docs/product/PRODUCT_NORTH_STAR.md`](docs/product/PRODUCT_NORTH_STAR.md)
- 故障学习循环：[`docs/operations/FAILURE_LEARNING_LOOP.md`](docs/operations/FAILURE_LEARNING_LOOP.md)
## 贡献
在打开 PR 之前，请将更改保持在 v1.0 焦点内或明确标记为未来。不要在没有关注测试的情况下添加云默认值、遥测、隐藏模型下载、浏览器执行控件或安装程序行为更改。
MCP 市场