文档历史
改了几版以后，想看看上周是怎么写的，或者想退回去：Marlin 每次保存都会悄悄留一份，随时能对比、还原。不需要 Git，也不用你做任何设置。
什么时候留一份
- 每次保存：存下保存后的内容
- 第一次保存时：连保存之前的原文也留一份，这样总能回到你动手之前
- 还原之前：先把当时的内容存一份，还原错了还能回来
- 外部的 AI 助手写入之前：见 MCP
打开文档历史
任选一种：
- 右键标签 →「文档历史…」
- ☰ →「文档历史…」
- 历史版本，新的在上。每条写着时间、是怎么留下的（保存、保存前的原文、还原之前、写入之前）和字数
- 从上一版到这一版之间有 AI 改过的内容时，标「✦ AI 改过」；是外部的 AI 助手改的，写着它的名字，比如「✦ Claude Code 改过」
- 左边是选中的那一版，右边是现在的内容，不一样的地方标了颜色。和现在完全一样时，上面写「和现在一样」
- 还原到这一版
点左边的列表换一版看，也可以用 ↑ ↓。
还原
选好一版，点「还原到这一版」：
- 现在的内容先在历史里存一份（「还原之前」）
- 文档进入编辑态，内容换成那一版
- 这时还没保存，看一看没问题再 Ctrl+S
改主意了，按 Ctrl+Z 一步就回到还原前的样子。
留多少、存在哪
- 每篇文档最多留 50 份，超过 30 天的自动删掉，但最近 5 份不管多久都留着
- 超过 2 MB 的大文档只留最近 10 份
- 历史存在 Marlin 自己的数据文件夹里（安装版在
%APPDATA%\dev.marlin-md.marlin\history，便携版在程序旁边的data\history），不会在文档旁边多出文件，也不会被 Git 提交上去 - 在 Marlin 的文件树里改名、移动文档，历史跟着走。在资源管理器里改名的，Marlin 认不出是同一篇，历史留在旧名字下
注意 文档历史只在保存时留。还没保存过的修改，靠的是另一样东西：Marlin 每 30 秒把没保存的修改另存一份，意外关掉后下次打开会提示恢复，见 编辑基础。