必须用/version命令插入版本块才能启用Hermes Agent v0.5.0+的原生版本对比、回溯与跨块引用功能；手动输入标题无效，系统自动绑定version_id、计算diff、支持拖拽/命令行引用及版本面板切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Hermes Agent v0.5.0+中用原生高级块实现笔记版本对比、回溯与跨块引用，而不是靠手动复制文件或外部Git管理——系统已内置版本块与引用块联动能力，但必须按特定结构触发。
启用笔记版本块并生成首个快照
打开目标笔记，在任意位置输入/version后按空格，选择「插入版本块」→系统自动插入带时间戳的版本容器，顶部显示created: 2026-06-29T13:28:00Z和唯一version_id: v_7a3f9b2e。
这一步不能用纯文本手写，必须通过命令插入——否则后续引用块无法识别该节点为有效版本源。手写的## v1.0标题不会被纳入版本索引。
编辑完成后保存，Hermes会自动将当前内容存为该版本块的初始快照，无需额外操作。
对同一笔记创建新版本并触发差异比对
在原版本块下方再插入一个/version块，系统默认填充based_on: v_7a3f9b2e字段。
修改正文任意一处（哪怕只加一个标点），保存后Hermes自动计算diff并渲染右侧差异视图：新增文字绿色高亮，删除文字红色横线标注，移动段落带箭头指示。
【based_on字段不可手动修改】若误删或改错，会导致后续所有子版本丢失继承链，无法回溯原始变更路径。
在其他笔记中引用特定版本内容
方法一：拖拽引用
鼠标选中某版本块内任意一段文字→按住左键不放→拖入另一篇笔记的编辑区→松开后自动生成带ref_version: v_7a3f9b2e属性的引用块，hover可预览原文上下文。
方法二：命令行插入
在目标位置输入/ref→按Tab补全→输入v_7a3f9b2e#L12-15（表示引用该版本第12至15行）→回车即插入精准行级引用。
注意：引用块仅绑定到具体version_id，不随主笔记最新版自动更新——这是刻意设计，确保文献溯源稳定。
批量查看与切换历史版本
第一步：在笔记顶部点击「版本面板」按钮（图标为两个重叠方框）→展开侧边栏显示所有version_id列表，按时间倒序排列。
第二步：点击任一版本条目→正文区域立即切换为该版本快照，且所有引用块同步更新为指向此版本的上下文。
第三步：若需将当前视图保存为新版本，点击面板右上角「另存为版本」→系统自动填充based_on为当前激活的version_id。
切换过程不修改原始文件，所有版本数据物理隔离存储于.hermes/versions/目录下，切换瞬时完成。
