第 2 周 · D14🔒 锁定约 4 小时
checkpoint 与 rewind:文件快照、对话回退,以及两者为什么必须独立
改坏了要能退回来:实现基于内容哈希的文件快照,把它与会话事件日志组成两条独立的时间线,支持只回滚文件、只回滚对话或两者一起,并处理仓库里本来就有未提交改动的情况,第二周复盘。
今日目标
- 能实现一套内容寻址的文件快照,并说清它与 git 提交的分工
- 能把文件回滚与对话回退做成两条独立可选的恢复路径
- 能处理未提交改动、外部改动与快照体积三类真实问题
昨天做的是动手之前的那道闸,今天做动手之后的那条退路。读完回到页面顶部把三条目标勾掉。
小白版讲解
存档与回滚:改坏了能退回昨天那一版
昨天那道闸挡住的是「方向错了」;今天要处理的是方向对了、计划批了、他也照着做了,但结果不对。这时候你要的不是解释,是一句「退回去」。
规矩很简单:动手之前先存一版,为的是让「重来一次」的成本降到一次按键。
而这里最容易走偏的一步是:别用 git 提交去存这一版。 替用户 git commit 一次「改动前的状态」看起来很省事,代价是他的提交历史里从此躺着一堆不是他写的提交,而那些是他要花时间 rebase 掉的。Agent 的存档是 Agent 自己的账本,不该混进用户的历史。 两者的分工一句话说清:
| 谁的账本 | 记什么 | 谁来决定 | |
|---|---|---|---|
| git 提交 | 用户的 | 「这是我认可的一个版本」 | 用户 |
| 快照 | mca 自己的 | 「这是我动手前后的样子」 | 程序,自动 |
于是今天的三段:怎么存(只存该存的,而且别存重)、怎么退(文件和对话是两条线,回哪条你得说出来)、怎么别把用户的东西弄丢(回滚是唯一会主动覆盖用户文件的动作,所以它前面必须有一道检查)。
面试题库
Agent 的文件快照怎么设计?为什么不直接用 git 提交?How would you design an agent's file snapshots, and why not just make git commits?
国内高频海外高频基础#snapshots#content-addressing🔒 解锁本章后查看答题要点。
文件回滚和对话回退为什么要分开?只回一边会发生什么?Why must file rollback and conversation rewind be separate? What happens when you rewind only one of them?
国内高频海外高频进阶#rewind#two-timelines🔒 解锁本章后查看答题要点。
回滚前发现工作区有未提交改动,或者文件被外部改过,你怎么处理?Before a rewind you find uncommitted changes in the workspace, or a file that was modified externally. How do you handle it?
国内高频海外高频深入#workspace-safety#dirty-state🔒 解锁本章后查看答题要点。
