企业官网建设流程全解析

Ghost OS 是一款让 AI 智能体直接操作 macOS 电脑的开源工具，它的ghost setup命令一条即可自动完成三大 macOS 权限（辅助功能、屏幕录制、输入监控）的配置，外加 MCP 接入、配方安装与视觉模型下载。本文将带你完整走通 Ghost OS 安装与 ghost setup 全流程，把新手最容易卡住的权限问题一次性说清楚。

先认识 Ghost OS：AI 的"眼睛"和"双手"

大多数 AI 助手只能在聊天框里回答你，而 Ghost OS 通过读取 macOS 的辅助功能树（Accessibility Tree），让 AI 真正"看见"并操作你 Mac 上的任意应用——点击按钮、填写表单、发送邮件、下载文件，全程不需要截图识别像素。

它通过 MCP 协议接入 Claude Code、Cursor、VS Code 等任意 MCP 客户端，内置 29 个操作工具，并且能把学会的工作流保存为 JSON 配方反复复用。完整工具说明见 GHOST-MCP.md。

快速安装并运行 ghost setup 命令

安装只需一条 Homebrew 命令，然后运行ghost setup：

brew install ghostwright/ghost-os/ghost-os ghost setup

如果 Homebrew 在你的 macOS 测试版上失败，或想体验源码构建，也可以克隆仓库后编译：

git clone https://gitcode.com/gh_mirrors/gh/ghost-os cd ghost-os && swift build .build/debug/ghost setup

ghost setup是一个交互式向导，会逐步带你完成所有配置。下面这张动图展示了整个 setup 过程：

CLI 命令入口在 Sources/ghost/main.swift，setup会启动SetupWizard执行完整流程。

Ghost OS 三大 macOS 权限逐个说清楚

权限配置是整个 setup 的核心，也是最多人踩坑的地方。先记住一个关键点：权限是授予给你的终端应用（如 iTerm2、VS Code），而不是 ghost 程序本身。Ghost OS 会先自动检测你正在用哪个终端（Sources/ghost/SetupWizard.swift 支持 iTerm2、Terminal、VS Code、Cursor、Warp 等），再把正确的应用名告诉你去添加。

权限一：辅助功能（Accessibility）— 必需 ⚠️

这是唯一"卡住就玩不了"的权限。ghost setup 会自动为你打开系统设置的正确面板，你只需把你的终端应用加入列表。验证逻辑见 SetupWizard.swift 权限检查。

权限二：屏幕录制（Screen Recording）— 可选 📸

• 设置路径：系统设置 → 隐私与安全性 → 屏幕录制
• 作用：启用ghost_screenshot截图功能，方便视觉调试
• 是否必需：❌ 可选，跳过不影响核心操作

核心能力基于辅助功能树，屏幕录制只是锦上添花。向导会询问你是否现在配置，可以回答N跳过，之后再运行ghost setup补上。

权限三：输入监控（Input Monitoring）— 可选 🎓

• 设置路径：系统设置 → 隐私与安全性 → 输入监控
• 作用：解锁 Ghost OS 的自学习模式——ghost_learn_start会观察你手动完成任务的操作，自动合成可复用的配方
• 是否必需：❌ 可选，只用现成配方可跳过

注意：授予此权限后可能需要重启终端应用才能生效（SetupWizard.swift 输入监控检查）。

ghost setup 向导 8 步流程全解析

运行ghost setup后，SetupWizard.run() 会依次执行：

全部完成后会打印 "Ghost OS is ready!"，此时新开一个 Claude Code 会话，就可以直接说"帮我发一封 Gmail 邮件"了。

新手最易踩的 5 个坑与快速修复

1. 加错了应用— 权限必须加在终端应用上，不是 ghost。向导第 1 步已告诉你该加哪个，别加错。
2. 加了却没反应— 如果终端已在辅助功能列表中但授权未生效，把开关关掉再打开一次。
3. 输入监控不生效— 授予后需要重启终端应用再测试。
4. 视觉模型装不上— MLX 要求 Python 3.10+，老系统可执行brew install python@3.12后重跑ghost setup。
5. 模型格式不对— 若之前手动下载过 PyTorch 格式的 ShowUI-2B，向导会自动识别并重新下载 MLX safetensors 格式版本。

任何一步没通过，都不需要从头再来——直接再跑一次ghost setup，已完成的步骤会自动跳过。

装完必做：用 ghost doctor 体检确认

配置完成后（或使用时遇到怪问题时），运行诊断命令一键体检：

ghost doctor

它会检查三大权限、MCP 进程、配方数量、辅助功能树可读性、视觉模型等共 10 余项，并给出具体修复建议（实现见 Sources/ghost/Doctor.swift）。另有一条更轻量的ghost status可做快速健康检查。

下一步：体验自学习配方

三大权限配好后，试试让 AI 替你干活：

• "用 Gmail 给 sarah 发一封关于 Q4 报告的邮件"
• "从 arXiv 下载最新一篇 chain-of-thought 提示的论文"

配方的本质是透明的 JSON 文件，每一步运行前都可以审查；学一次，用无数次。下面是配方执行的实际效果：

至此，ghost setup的全部配置工作就完成了。把三大 macOS 权限一次配好，你的 AI 智能体就真正拥有了操作 Mac 的眼睛和双手 🎉