变更与回滚

AgentHub 没有「直接覆盖」这个选项。任何写操作都要先变成一份计划。

一次变更的完整生命周期

1. 生成计划

计划里逐条列出操作类型与目标路径：

• create — 新建文件或目录
• update — 覆盖内容（附 diff）
• delete — 删除
• link — 建立链接
• warn — 不建议执行，但不阻止

可以只勾选其中几条执行，未勾选的直接丢弃。

2. 执行写入

确认后按顺序执行，每一步都是原子替换：先写临时文件，再 rename，避免中途失败留下半截文件。

写入前会把原内容存进备份批次，批次号形如 cs-20261102-7f3a。

3. 回滚

变更历史里每个批次都能整体或单条回滚：

• 覆盖类回滚：把备份内容写回原路径。
• 删除类回滚：从备份恢复。
• 链接类回滚：按原指向重建链接，不留断链。

什么时候会拒绝执行

• 目标落在只读区。
• 目标路径被排除列表命中。
• 计划生成后目标文件被外部改动，内容指纹对不上。

第三种最常见：外部工具在你审阅计划时改了同一个文件，AgentHub 会拒绝执行并提示重新生成计划，而不是硬写。

与外部改动的关系

桌面端会监听 agent 目录、中央仓库与配置。检测到外部改动时只提示、不自动重扫，避免打断你正在做的事。确认后再手动触发扫描。

状态栏常驻一个批次胶囊：有计划时显示「计划 · N 个操作 · 未应用」，否则显示最近批次，点一下直接跳到变更历史并高亮。