上手
安装 Spirit Agent，接上一家提供商，完成一次带审批的小改。
这一页带你从全新安装走到一次有用的改动。后面的提供商和宿主文档都挂在这条路径上；没有它，那些页面无处附着。
1. 安装 Desktop 或 CLI
先选一个宿主。它们共用本机守护进程，之后随时可以再装另一个。
到下载页取对应平台的安装包并打开。
- macOS：
.dmg（Intel 或 Apple 芯片） - Windows：
.exe安装包（x64 或 ARM64） - Linux：
.AppImage（x64 或 ARM64）
细节见 安装 Desktop。
2. 打开工作区
Agent 在工作区根目录里读文件、改文件。打开你要改的那个项目。
在侧栏点 打开工作区目录，选一个文件夹。最近用过的工作区会留在列表里。
3. 接上第一家提供商
你需要一把已有提供商的 API Key。Spirit 把它写入操作系统钥匙串（服务名 SpiritAgent）。
- 打开 设置 → 模型。
- 选一家提供商，按连接向导走完。
- 粘贴 Key。区域、站点、套餐端点等字段只在该家需要时出现。
- 把一个对话模型设为当前模型。
4. 让 Agent 做一次小改，然后审批
第一次请留在 Agent 模式和 默认 审批。让它读一个你熟悉的文件，再做一处一眼能看出来的修改。
例如：
读取 README.md，并在文件顶部添加一行项目简介。不要改动其他内容。Agent 会读文件、提出编辑，然后等待。在提示里批准文件改动（以及任何 shell 命令）。结束后打开文件确认。
整条回路就是：安装 → 工作区 → 一家提供商 → 读 → 改 → 审批。文档里其余内容都挂在这条路径上。
接下来
- 需要另一个宿主或固定版本时，看 安装 Desktop 和 安装 CLI
- 换一家或导入不到模型时，看 提供商 核对该家的站点、套餐或云字段