# Aperture 一款遵循先规划后应用工作流的 AI 代码编辑器：规划变更、暂存差异，并在应用前进行检查。 - Findings24: - 网站: - 价格: Freemium - 分类: AI编程助手, AI开发者工具 ## 什么是 Aperture？ Aperture 是一款围绕“先规划后应用”工作流构建的 AI 代码编辑器。Composer 会读取代码库、提出计划，并等待用户启动构建。用户可以在进行任何编辑之前，通过改写、重新排序、删除或添加步骤来调整计划。 编辑器以暂存差异的形式提供建议变更，而不是直接写入文件。用户可以逐个文件保留或跳过变更；每次运行都会将计划、构建操作、测试运行和自动修复集中在一起。Aperture 会在应用暂存变更前进行检查，包括解析变更、解析导入、运行轻量级类型检查、渲染页面和执行测试。 代码库还包含一个可重放的 harbor-api 演示项目。启用重放模式后，可以查看记录的代理运行过程，而无需调用模型或使用 API 密钥。文档所述的本地设置要求 Node 22.6 或更高版本。 ## Aperture 能做什么？ ### 先规划，再构建 Composer 会读取代码，并在开始实现前展示建议的变更计划。用户可以先改写、重新排序、删除或添加步骤。 ### 暂存差异，而非立即编辑 变更会以暂存差异的形式呈现，用户可以逐个文件保留或跳过，因此在用户应用之前不会触及项目文件。 ### 应用前验证 每项暂存变更都会在应用前检查解析错误、未解析的导入、轻量级类型检查失败、页面渲染问题和测试失败。 ### 运行卡片与后台工作 运行卡片会汇总计划、构建操作、测试运行和自动修复，后台任务则会与当前工作一同显示。 ### 并排比较变更 可以使用文档所述的 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