先规划，再构建
Composer 会读取代码，并在开始实现前展示建议的变更计划。用户可以先改写、重新排序、删除或添加步骤。
什么是 Aperture？
Aperture 是一款围绕“先规划后应用”工作流构建的 AI 代码编辑器。Composer 会读取代码库、提出计划，并等待用户启动构建。用户可以在进行任何编辑之前，通过改写、重新排序、删除或添加步骤来调整计划。
编辑器以暂存差异的形式提供建议变更，而不是直接写入文件。用户可以逐个文件保留或跳过变更；每次运行都会将计划、构建操作、测试运行和自动修复集中在一起。Aperture 会在应用暂存变更前进行检查，包括解析变更、解析导入、运行轻量级类型检查、渲染页面和执行测试。
代码库还包含一个可重放的 harbor-api 演示项目。启用重放模式后，可以查看记录的代理运行过程，而无需调用模型或使用 API 密钥。文档所述的本地设置要求 Node 22.6 或更高版本。
Aperture 能做什么？
暂存差异，而非立即编辑
变更会以暂存差异的形式呈现，用户可以逐个文件保留或跳过，因此在用户应用之前不会触及项目文件。
应用前验证
每项暂存变更都会在应用前检查解析错误、未解析的导入、轻量级类型检查失败、页面渲染问题和测试失败。
运行卡片与后台工作
运行卡片会汇总计划、构建操作、测试运行和自动修复，后台任务则会与当前工作一同显示。
并排比较变更
可以使用文档所述的 Ctrl/Cmd+J 快捷键，逐个文件比较两个包含暂存变更的运行。
可重放的演示模式
APERTURE_MODEL=replay 会在内置 harbor-api 演示项目中重放记录的代理运行，而无需调用模型或消耗 API 配额。
使用场景
“审查 AI 提出的代码变更”
让 Composer 规划一项变更，调整步骤，并在应用任何内容之前检查生成的差异。
“在演示项目中验证错误修复”
使用 harbor-api 演示项目及其记录的运行过程，查看建议的修复如何经过规划、暂存变更、渲染和测试。
“区分新回归问题与既有失败”
当项目中存在已知失败的测试时，利用测试结果上下文判断某项失败是否在暂存编辑之前就已存在。
“比较不同的代理运行”
保留多个暂存运行，并在选择要应用的变更集之前并排比较其中的文件。
常见问题
Aperture 会直接写入项目文件吗？
不会。建议的编辑会以暂存差异的形式呈现，可以逐个文件保留或跳过。用户应用所选编辑之前，文件不会发生变更。
Aperture 会在应用变更前检查哪些内容？
文档所述的检查包括解析、导入解析、轻量级类型检查、页面渲染和测试。
不使用 API 密钥也可以试用 Aperture 吗？
可以。代码库文档说明了 APERTURE_MODEL=replay，它会在内置 harbor-api 演示项目中重放记录的代理运行，而无需调用模型或使用 API 配额。
本地设置需要什么？
文档所述的设置要求 Node 22.6 或更高版本。代码库还提供 VITE_AUTH_ENABLED=false 选项，可跳过登录并使用本地进程内 PGlite 数据库。
快速信息
- 类别
- AI 开发者工具
- 主要工作流
- 规划、暂存差异、验证，然后应用
- 验证内容
- 解析、导入、轻量级类型检查、页面渲染和测试
- 本地要求
- Node 22.6 或更高版本
- 演示模式
- 内置 harbor-api 项目的记录运行
- 来源
- github.com/Hankaws/aperture