每一个更改，皆在轨迹中。Ponytrail 是一个小型 CLI 和捆绑的代理技能，用于记录文件更改的原因，显示这些更改为本地历史树，并从先前的快照中恢复文件。它将轨迹保存在项目内的 .pony-trail/ 文件夹中。将该文件夹视为本地运行时状态；应避免纳入 git 中。 安装该技能 将捆绑的 pony-trail 技能安装到本地代理工具中： npx ponytrail skills install pony-trail 使用 Bun： bunx ponytrail skills install pony-trail 安装程序在写入代理技能文件之前记录本地技能安装快照，以便稍后在 ponytrail 历史中找到安装记录 --details。 查看历史 显示快照树： npx ponytrail history 包括操作、摘要、检查、结果和回滚详细信息： npx ponytrail history --details 效果预览： 快照历史 * ponytrail-skills * skill-install-20260622064256Z-99fa03fd (前/后) 操作：安装技能 摘要：为 claude、copilot、codex 安装 pony-trail 技能 检查：ponytrail skills install pony-trail --home . --agents claude, copilot, codex 结果：claude:installed, copilot:installed, codex:installed 回滚：删除或重新安装受影响的代理技能文件夹，然后记录另一个快照。 过滤到一个会话或打印机器可读输出： npx ponytrail history --session < session-id > npx ponytrail history --json 快照从以下位置读取： .pony-trail/ snapshots.jsonl sessions/<session-id>/tree.md 恢复快照 预览计划的文件操作： npx ponytrail revert < snapshot-id > --dry-run 应用恢复： npx ponytrail revert < snapshot-id > Ponytrail 打印计划的文件操作，并在更改文件之前请求批准。在非交互式环境中，它打印计划并在不改变项目的情况下取消操作。恢复从快照的前状态还原文件。如果快照之前文件不存在，Ponytrail 会在恢复过程中删除它。 本地开发 bun install bun run build bun test bun run check