企业官网建设流程全解析

RepoPrompt CE 是一款免费的开源 macOS 原生上下文工程应用（context engineering），它帮助 AI 编程助手在动手改代码前先"读懂"你的代码库——从文件、CodeMap、仓库结构和 Git diff 中组装出可审查的上下文，并通过内置的 MCP server 与 CLI 把上下文交给各类 AI Agent。无论你是想快速体验它的 AI 上下文组装能力，还是想参与开发，这篇 RepoPrompt CE 安装指南都能帮你在几分钟内跑起来。

安装前准备：确认系统要求

在开始之前，先确认你的 Mac 满足以下条件：

• macOS 26 或更高版本
• 完整版 Xcode 26（仅 Command Line Tools 不够，项目使用了@Entry、#Preview等 Swift 宏，其插件只随Xcode.app提供）
• Python 3（本地启动器和安装器依赖它）
• 源码构建时先运行工具链自检：

./Scripts/doctor.sh

该脚本会检查 Swift/Xcode、签名身份、SDK、SwiftUI 探针等，Scripts/doctor.sh 也是make doctor背后的入口。

方式一：Homebrew 一键安装（最快路径）

推荐大多数用户走这条路线——安装的是签名并经过公证（notarized）的正式版本，无需打开 Xcode：

brew tap repoprompt/repoprompt-ce brew install --cask repoprompt-ce

执行完成后，应用会被安装到/Applications/RepoPrompt CE.app，直接从 Launchpad 或 Spotlight 打开即可。此方式直接消费官方发布的更新包，不从源码构建，是当前最省心的 RepoPrompt CE macOS 安装方式。

方式二：双击启动器，本地调试构建

如果你想参与开发或快速评估源码，仓库根目录提供了一个双击即可运行的调试启动器：

1. 克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/re/repoprompt-ce

2. 在 Finder 中双击 Launch RepoPrompt CE.command
3. 启动器会通过协同开发守护进程（conductor daemon）完成构建、打开调试版 App，并保留一个小终端窗口供你操作

启动后终端提供 4 个快捷操作：

💡没有 Apple Development 签名身份？在终端中显式使用 ad-hoc 签名即可：

ALLOW_ADHOC_SIGNING=1 ./conductor app relaunch

注意：ad-hoc 调试版使用内存态安全存储，保存的 API Key 不会跨次启动保留。

安装本地生产构建（/Applications 稳定版）

想要一个安装到/Applications的 release 模式应用（而非调试版），双击根目录的 Install RepoPrompt CE Local Production.command 即可：

• 需要 Python 3 和完整 Xcode
• 使用仅本机信任的自签名证书，macOS 可能会弹出证书批准提示
• 该应用仅限本机使用，未经公证，不要复制到其他 Mac

常用构建命令速查

项目根目录的 Makefile 提供了完整的开发命令，最常用的几个：

在 Xcode 中开发 RepoPrompt CE

Xcode 用户只需一条命令生成开发工作区：

make xcode

生成后，在 Xcode 26.3 中注意选择正确的 Scheme：

• RepoPrompt CE App：打包调试版 App
• RepoPrompt CE MCP：运行协同的 MCP 可执行文件
• RepoPrompt CE Tests：运行测试（委托给 conductor 的沙箱测试环境）

工作区是"一次性"的生成物，位于.build/xcode，不要手动编辑或提交它。详见 docs/architecture/xcode-workspace.md。

常见问题排查

构建失败或提示 SDK 不足？先跑make doctor，它会在 Scripts/doctor.sh 中逐项检查 SDK 版本（要求 macOS 26 SDK）与 Swift 宏插件可用性，并给出具体的修复建议。

终端提示找不到 Python 3？启动器不提供无 Python 的回退方案（生命周期操作必须校验精确的调试可执行路径），安装 Python 3 后重新打开启动器即可。

签名告警怎么办？若没有Apple Development:身份，调试构建可用ALLOW_ADHOC_SIGNING=1；需要持久化 Keychain 存储时，显式指定稳定身份：

SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ./conductor app relaunch

如何连接 MCP CLI 调试？

make install-debug-cli # 安装 /usr/local/bin/rpce-cli-debug rpce-cli-debug -e 'windows'

进一步阅读

• 项目概览与特性说明：README.md
• 贡献流程与校验要求：CONTRIBUTING.md、AGENTS.md
• MCP 工具进度机制：docs/mcp-progress.md
• 版本与构建标识：version.env

到这里，RepoPrompt CE 的三种安装路径——Homebrew 一键安装、本地调试构建、本地生产安装——你已经全部掌握。普通用户选 Homebrew，开发者选双击启动器，5 分钟即可开启你的 AI 上下文工程之旅 🚀