我構建了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代理在開發流程中的普及，這類審計工具的價值將愈發凸顯。