用途：在 Obsidian 中检查、对比和恢复笔记的历史版本，适用于找回被覆盖或误删的笔记、查看两个版本之间的差异、在破坏性编辑前审计单个文件的历史。若只是编辑当前笔记、搜索当前库内容或从系统级备份恢复，应改用其他技能或系统工具。
主要能力：Obsidian 维护两套并行版本存储——File Recovery 本地快照（在设置中启用）与 Sync 服务端版本（需 Obsidian Sync 订阅）。diff 命令统一列出两套存储中的全部可用版本（最新为 1），可用 filter=local|sync 限定来源。
使用方式：需 Obsidian 桌面版 v1.12.4+ 并启用 CLI，且 Obsidian 正在运行；本地历史需启用 File Recovery，sync:* 命令需有效的 Obsidian Sync 订阅。常用命令：obsidian diff 列出当前文件全部版本；obsidian diff file=Recipe from=1 对比最新版本与当前状态；obsidian diff file=Recipe from=2 to=1 对比两个指定版本；obsidian history file=Recipe 查看本地历史条目；obsidian history:list 列出所有有本地历史的文件；obsidian history:read file=Recipe version=3 读取指定版本；obsidian history:restore file=Recipe version=3 恢复并覆盖当前内容；obsidian sync:history、sync:read、sync:restore、sync:open、sync:deleted 用于同步版本。
适用场景：撤销错误编辑、恢复被覆盖或删除的笔记、审计代理对文件的改动、在破坏性编辑前先记录版本号以便一键还原。
限制：恢复操作会覆盖当前内容；本地历史依赖 File Recovery 设置，同步历史依赖 Obsidian Sync 订阅；需桌面端与 CLI 环境，Obsidian 必须处于运行状态。其他细节暂未提供。