单文件版本大师

要解决什么问题

很多「版本管理」习惯是整仓快照或依赖 Git，但当你只想追踪某一个文档从草稿到定稿的演变、或需要在对话里快速「存一版 / 回滚 / 对比」时，全仓库方案往往过重，历史也不按文件拆开看。

Version-Master 是单文件粒度的版本技能：每个路径各自维护版本链，保存的是真实文件内容（文本与二进制均可完整恢复），并在内容未变时自动跳过，避免堆出无意义的重复版本。

技能如何工作

加载技能后，通过 scripts/version_tool.py 完成常见操作：

• 保存版本：指定工作区内的 file_path（相对路径），并附带可读的 message；AI 应根据上下文判断「保存哪个文件」，禁止不带路径做批量保存。
• 列出历史：按文件查看版本号、摘要与时间线；保存前可先 list，结合去重逻辑减少重复快照。
• 恢复与对比：恢复会覆盖当前文件，因此需用户确认并设置 confirm=True；恢复前会把当前内容备份到 .version_backup/。支持对同一文件的不同版本做 diff。
• 清理版本：删除旧快照同样属于破坏性操作，需明确确认。

存储上，各工作区共享一套版本目录；文件名中的 . 与路径分隔符会映射为安全键名，文本内容写入 JSON，二进制则落盘引用，必要时可从 v*.json 重建 index.json。

适用边界与注意点

• 路径必须在工作区边界内，服务端会拒绝 ../ 或越界绝对路径。
• 恢复与删除必须先展示风险并等待用户确认，不要静默覆盖或删数据。
• 适合「单文件迭代、可解释的版本说明」场景；若你要分支合并、跨文件发布流程，仍应使用 Git 等完整 VCS。