版本控制指南

让每一次修改都有迹可循

了解 Koinote 如何保存历史版本、处理网页与 Agent 的并发修改，以及在误操作后恢复内容。

版本历史如何工作

网页编辑和 MCP 写入共用同一套 revision 与历史策略。历史版本用于回看和恢复；revision 校验则阻止旧内容静默覆盖新修改。

会员与保留上限

版本历史是终生会员权益。每篇文档可保留 1–100 个版本，账号内全部文档合计最多保留 100 个版本；超过上限时优先淘汰最旧记录。

核心能力

  • 节流保存 — 普通网页编辑按时间间隔生成快照，不会让每次自动保存都占一个版本。
  • 灵活上限 — 可以开启或关闭历史，并为每篇文档设置 1–100 个版本的保留上限。
  • 安全快照 — 即使关闭 MCP 完整历史，Agent 覆盖写入前仍保留最近一个可恢复状态。
  • 冲突检测 — 更新必须携带最新 revision；版本落后时写入失败，而不是覆盖新内容。
  • 可撤销恢复 — 恢复旧版本前会先保存当前状态，因此恢复操作本身仍可以回退。

在网页中查看和恢复

  1. 在编辑器工具栏打开“版本历史”，查看当前文档仍保留的版本。
  2. 每个版本会标明时间和来源，包括网页编辑、MCP Agent 或版本恢复。
  3. 确认恢复后，旧版本会成为当前内容；恢复前的状态也会保留为可回退版本。

MCP 写入的版本策略

  • 可以单独决定 Agent 写入是否保留完整历史。
  • 关闭完整历史不会取消安全快照，整篇覆盖仍至少保留最近一个恢复点。
  • 授权的读写 MCP 客户端可以读取并修改历史设置；只读令牌只能查看。

推荐设置

重要文档建议开启版本历史并保留 MCP 完整历史。若文档较多，请结合账号总计 100 个版本的共享上限设置单篇数量；Agent 整篇覆盖前仍应先读取最新 revision。