文件检查点与回滚

每当 Agent 执行破坏性命令（文件编辑、Shell 命令）时，Myrm 会自动创建 Shadow Git 快照。你可以查看变更、选择性恢复文件，Agent 会自动适应你的回滚操作。

工作流程

自动快照

在任何破坏性操作前，系统透明地使用隔离的 Shadow Git 仓库快照所有跟踪文件——完全独立于项目的 .git。

可视化时间线

打开历史面板查看所有快照的时间线。每张卡片显示哪些文件被更改，并附带行级统计（+X/-Y 行）。

选择性恢复

选择特定文件回滚，同时保留其他更改。也可以全量恢复并通过确认对话框二次确认。

Agent 自动感知

恢复文件后，Agent 在下一轮对话时自动检测到回滚操作并重新读取受影响的文件——无需手动干预。

当命令涉及文件系统之外的不可逆副作用时，Myrm 自动标记：

类别	示例	警告
数据库	`psql`、`mysql`、`redis-cli`、`mongo`	数据库变更无法通过文件回滚撤销
网络	`curl -d`、`http POST`、`wget --post`	HTTP 写操作已发送到远程服务器
容器/云	`docker rm`、`kubectl delete`、`terraform apply`	基础设施变更在外部持久存在

恢复包含这些操作的快照时，UI 显示清晰警告：

“文件将被恢复，但此命令期间的数据库/网络/容器操作无法撤销。“

文件检查点开箱即用：

Shadow Git 使用共享裸仓库和按项目分支：

服务器在任务中途崩溃时：

这在架构上优于手动检查点回调（某些竞品的做法），因为状态在每个图节点转换时自动捕获，而非仅在手动标注点保存。

文件检查点只是 Myrm 完整中断恢复体系的一层：

层级	保护对象	恢复机制
图状态	整个 Agent 执行状态	LangGraph SQLite 检查点 + 增量 dill 序列化
子任务	关机时的子 Agent 工作	SIGTERM 自动保存检查点 + 无缝恢复
对话分叉	对话探索分支	从任意检查点分叉 + 完整父级血统追踪
目标管理	因预算/用户暂停的长期目标	恢复时重置计数器，保留所有历史进展
文件快照	工作区文件修改	Shadow Git 选择性恢复 + Agent 自动感知
流恢复	LLM 流式传输网络中断	4 种策略：单次/续传/截断/溢出降级

无论何种中断——进程崩溃、网络中断、用户暂停或预算用尽——Myrm 都能从精确断点恢复，零数据丢失。