我构建了Ponytrail：一个AI编程代理编辑的本地审计追踪工具

Ponytrail是一款创新的本地审计追踪工具，专为使用AI编程代理（如Claude、Copilot和Codex）的开发者设计。它通过记录每次文件变更的原因、时间戳和代理操作细节，构建出一个完整的本地历史树，让开发者可以清晰地追踪“为什么”文件被修改，并在必要时回滚到之前的任意快照。

该工具的核心功能围绕快照管理展开。当开发者运行命令时，Ponytrail会在项目根目录下的.pony-trail/文件夹中生成快照。快照包含变更前后的文件状态、操作摘要、检查结果以及回滚所需的信息。通过npx ponytrail history命令，可以展示快照树；添加--details参数则显示更丰富的信息，包括操作、摘要、检查和回滚细节。此外，还支持按会话过滤和JSON格式输出，方便机器处理。

回滚功能是Ponytrail的另一大亮点。开发者可以使用npx ponytrail revert --dry-run预览计划中的文件操作，然后通过npx ponytrail revert实际执行回滚。在非交互式环境中，工具会打印计划并取消操作，避免对项目造成意外修改。回滚时，会从快照的“前状态”恢复文件，如果文件在快照前不存在，则会被删除。

Ponytrail的安装十分简单，只需运行npx ponytrail skills install pony-trail或使用Bun执行bunx ponytrail skills install pony-trail。安装器会在写入代理技能文件前记录本地快照，确保安装过程可追溯。该项目是开源的，使用TypeScript编写（占90.7%），并包含Shell和Python组件，目前已在GitHub上获得104颗星。

对于依赖AI代理进行代码修改的开发者而言，Ponytrail提供了一种轻量级但强大的方法，来保持对项目变更的控制和可见性。它解决了代理编辑可能带来的“黑盒”问题，让每次修改都有据可查。随着AI代理在开发流程中的普及，这类审计工具的价值将愈发凸显。