三分钟上手

Get started

不用先去各家云控制台注册。本机装好、起环境、对接应用；上线时再迁到真实云。

1. 下载安装

1. 打开 下载页（GitHub Releases）
2. 下载最新的 macOS 安装包（.dmg 或 .zip）
3. 把 XBuckle 放进「应用程序」
4. 打开应用

不需要安装 Node，不需要在终端里敲命令，也不需要先注册云服务。

若系统提示无法验证开发者：系统设置 → 隐私与安全性 → 仍要打开。正式签名版本一般不会遇到。

2. 本机启动仿真环境

1. 新建项目（或打开已有项目文件）
2. 勾选你需要的服务，例如登录、数据库、缓存
3. 启动服务

每个项目会保存自己的端口。若和别的程序冲突，在项目菜单或设置里改端口，也可以一键「建议空闲端口」。

3. 对接应用（人或 Agent）

1. 打开 Connect
2. 复制整页说明
3. 自己改配置，或交给 AI 助手自动配置
4. 用官方 SDK 访问说明里的本机地址

应用连的是当前这个项目的地址。功能跑通后，上线时把端点与密钥换成云上的即可（平滑迁移）。

接下来

你想…	去这里
熟悉桌面里有哪些页面	桌面应用
日常怎么用	使用说明
让 AI 助手自动配置	给 AI 用
上线前检查	Connect / Ship

给贡献者

只有你在改 XBuckle 源码 时，才需要：

git clone https://github.com/21stware/xbuckle.git
cd xbuckle && npm install
npm run electron:dev

日常当用户使用，请始终走上面的「下载安装」。