版本历史

zenstory 的版本历史功能为您的每一次创作提供完整的时光机。无论您是想查看修改记录、对比不同版本的内容差异，还是回滚到之前的某个版本，版本历史都能帮您轻松实现。

什么是版本历史？

版本历史是zenstory 自动为您的每个文件创建的修改记录系统。每次保存文件时，系统都会自动创建一个新版本，完整记录您的创作轨迹。

自动版本管理

您无需手动操作，系统会自动为以下情况创建版本：

• 创建 - 新建文件时
• 编辑 - 手动编辑并保存时
• AI 编辑 - AI 修改文件内容时
• 回滚 - 恢复到历史版本时
• 自动保存 - 系统自动保存时

每个版本都包含完整的文件内容快照，确保您可以随时回到任意历史节点。

查看版本历史

打开版本历史面板

要查看某个文件的版本历史：

1. 打开目标文件 - 在编辑器中打开您想查看的文件
2. 点击「历史」按钮 - 在编辑器底部状态栏找到「历史」（时钟图标）按钮
3. 浏览版本列表 - 版本历史面板将以弹窗形式打开

补充：顶部工具栏的「版本历史」按钮用于查看项目快照（全项目回滚），与本页介绍的单文件版本历史不同。

版本历史面板显示当前文件的所有历史版本，按时间倒序排列（最新的在最上方）。

版本列表说明

每个版本条目包含以下信息：

版本标识：

• 版本号 - 如 v1、v2、v3 等递增编号
• 版本类型标签 - 显示此次修改的类型
  • 创建 - 文件首次创建
  • 编辑 - 用户手动编辑
  • AI 编辑 - AI 助手修改内容（显示机器人图标）
  • 回滚 - 从其他版本恢复
  • 自动保存 - 系统自动保存

时间与统计：

• 修改时间 - 显示相对时间（如"2 小时前"、"3 天前"）
• 字数 - 该版本的字数统计
• 行数变化 - 显示新增和删除的行数（绿色 +X 行，红色 -X 行）

版本描述（可选）：

• 某些版本会自动生成简短的修改说明
• 例如："扩写了第三段对话内容"、"修正了角色名称"

最新版本标识：

• 最上方的版本会显示"最新"标签，表示当前正在编辑的版本

版本对比功能

版本对比功能让您可以清晰看到两个版本之间的具体差异，非常适合追踪内容变化和审核修改。

选择要对比的版本

对比操作步骤：

1. 点击选中第一个版本 - 点击版本条目即可选中（高亮显示）
2. 再点击选中第二个版本 - 系统最多允许同时选择两个版本
3. 点击"对比"按钮 - 工具栏会出现"对比"按钮

选择提示：

• 已选中的版本会显示蓝色边框和背景
• 选择第三个版本时，会自动替换最早选择的那个
• 顶部会显示"已选择 X 个版本"提示

查看对比结果

点击"对比"后，右侧会展开对比视图：

对比视图说明：

• 版本范围 - 顶部显示"版本 X → 版本 Y"
• 新增内容 - 以绿色背景显示，表示新增的文字
• 删除内容 - 以红色背景显示，表示删除的文字
• 未变内容 - 正常显示，作为上下文参考

关闭对比：

• 点击对比视图右上角的关闭按钮（X 图标）
• 可以继续选择其他版本进行对比

回滚到历史版本

回滚功能让您可以撤销修改，恢复到之前的任意版本。这是zenstory 的一大安全网，让您的创作无后顾之忧。

执行回滚操作

回滚步骤：

1. 找到目标版本 - 在版本列表中找到您想恢复的版本
2. 点击回滚按钮 - 每个历史版本右侧都有一个旋转箭头图标
3. 确认回滚 - 系统会弹出确认对话框，显示：

   "确定要回滚到版本 X 吗？当前内容会被保存为新版本。"

4. 完成回滚 - 确认后，文件内容会恢复到选定版本

重要说明：

• 最新版本（第一项）没有回滚按钮，因为它就是当前版本
• 回滚不会覆盖或丢失任何历史记录
• 回滚操作本身也会创建一个新版本（类型为"回滚"）

回滚的安全机制

zenstory 的回滚是非破坏性操作：

✓ 当前状态自动保存 - 回滚前，系统会先将当前内容保存为新版本 ✓ 历史完整保留 - 所有历史版本都不会被删除或覆盖 ✓ 可随时再次回滚 - 您可以从"回滚版本"再次回滚到其他版本

示例场景：

假设您的版本历史如下：

• v5（最新） - AI 扩写了第三章
• v4 - 修改了角色对话
• v3 - 添加了场景描写
• v2 - 创建文件

如果您从 v5 回滚到 v3，版本历史会变成：

• v6（最新，回滚版本） - 恢复到 v3 的内容
• v5 - AI 扩写了第三章
• v4 - 修改了角色对话
• v3 - 添加了场景描写
• v2 - 创建文件

您可以随时从 v6 再回滚到 v5 或 v4，不会丢失任何内容。

查看版本内容

除了对比和回滚，您还可以查看任意历史版本的完整内容。

查看历史版本内容

操作步骤：

1. 找到目标版本 - 在版本列表中定位想查看的版本
2. 点击文档图标 - 版本条目右侧的文档图标按钮
3. 浏览内容 - 完整的版本内容会显示出来

使用场景：

• 想回忆之前删除的某个段落
• 确认某个版本的具体内容再决定是否回滚
• 查找曾经写过的某句话或某个设定

版本历史最佳实践

何时应该查看版本历史

日常使用：

• 回忆之前的创作思路
• 查找被删除的内容片段
• 对比不同版本的写作风格

与 AI 协作时：

• 审核 AI 的修改内容（AI 编辑版本会特别标注）
• 如果不满意 AI 的修改，可以回滚到修改前的版本
• 对比 AI 修改前后的差异，学习改进写作

创作探索：

• 尝试不同的写作方向，保留所有探索记录
• 在重大修改前创建"安全点"（虽然自动保存会记录，但可以添加描述标注）
• 从旧版本提取灵感，融入当前版本

版本管理小技巧

1. 善用版本对比 - 在接受 AI 大幅度修改前，先对比查看具体变化

2. 放心大胆创作 - 版本历史是您的安全网，不用担心改错

3. 定期清理描述 - 虽然系统会自动生成描述，但您可以为重要版本添加自定义描述（如果系统支持）

4. 理解版本类型 - 留意版本标签，区分哪些是您的手动编辑，哪些是 AI 的修改

5. 回滚不是终点 - 回滚后仍可继续编辑，或再次回滚到其他版本

常见问题

Q: 版本历史有数量限制吗？

A: 系统会保存所有版本，没有硬性数量限制。版本采用差异存储技术，不会占用过多空间。

Q: 可以删除某个版本吗？

A: 目前不支持删除单个版本。版本历史是完整的时间线，保持完整性有助于追溯创作过程。

Q: 回滚后还能撤销回滚吗？

A: 可以！回滚前的版本（v5）仍然保存在历史记录中，您可以随时再次回滚回去。

Q: 版本对比支持多少个版本同时对比？

A: 目前支持选择两个版本进行对比。选择时会按版本号自动排序（旧版本 → 新版本）。

Q: 自动保存的版本会很多吗？

A: 系统会智能管理自动保存频率，避免创建过多冗余版本。您也可以在版本历史中选择是否显示自动保存版本。

Q: AI 编辑的版本有什么特别？

A: AI 编辑的版本会显示机器人图标和"AI 编辑"标签，方便您识别哪些是 AI 的修改。在审核 AI 工作时特别有用。

Q: 可以给版本添加自定义描述吗？

A: 部分界面支持编辑版本描述。为重要版本添加描述可以帮助您日后快速识别和定位。

键盘快捷键

版本历史面板支持以下快捷操作：

• Esc - 关闭版本历史面板
• 点击版本条目 - 选中/取消选中版本

下一步

现在您已经掌握了版本历史功能的使用方法，可以：

• 了解文件管理 - 学习如何组织项目文件
• 与 AI 对话 - 探索 AI 如何帮助您修改内容
• 界面总览 - 回顾zenstory 的完整界面

祝您创作愉快，无后顾之忧！

Version History

zenstory's version history feature provides a complete time machine for your creative work. Whether you want to review modification records, compare content differences between versions, or roll back to a previous version, version history makes it all easy.

What is Version History?

Version history is an automatic modification tracking system that zenstory creates for each of your files. Every time you save a file, the system automatically creates a new version, completely recording your creative journey.

Automatic Version Management

You don't need to do anything manually—the system automatically creates versions for the following situations:

• Create - When creating a new file
• Edit - When manually editing and saving
• AI Edit - When AI modifies file content
• Rollback - When restoring to a historical version
• Auto-save - When the system automatically saves

Each version contains a complete snapshot of the file content, ensuring you can return to any historical point at any time.

Viewing Version History

Opening the Version History Panel

[Screenshot: Top toolbar, highlighting the "Version History" button location]

To view a file's version history:

1. Open the target file - Open the file you want to view in the editor
2. Click the version history button - Find the clock icon button in the top toolbar
3. Browse the version list - The version history panel will open as a modal

The version history panel displays all historical versions of the current file, arranged in reverse chronological order (newest at the top).

Version List Details

[Screenshot: Complete version history panel interface, highlighting various elements of the version list]

Each version entry contains the following information:

Version Identifier:

• Version number - Incremental numbers like v1, v2, v3, etc.
• Version type tag - Shows the type of this modification
  • Create - File first created
  • Edit - User manual edit
  • AI Edit - AI assistant modified content (displays robot icon)
  • Rollback - Restored from another version
  • Auto-save - System automatic save

Time and Statistics:

• Modification time - Displays relative time (e.g., "2 hours ago", "3 days ago")
• Word count - Word count for that version
• Line changes - Shows added and deleted lines (green +X lines, red -X lines)

Version Description (optional):

• Some versions automatically generate brief modification notes
• Examples: "Expanded the third paragraph of dialogue", "Corrected character name"

Latest Version Badge:

• The topmost version displays a "Latest" tag, indicating the currently edited version

Version Comparison Feature

The version comparison feature lets you clearly see specific differences between two versions, perfect for tracking content changes and reviewing modifications.

Selecting Versions to Compare

[Screenshot: Version list, highlighting selected version entries]

Comparison steps:

1. Click to select the first version - Click on a version entry to select it (highlighted)
2. Click to select a second version - The system allows selecting up to two versions simultaneously
3. Click the "Compare" button - A "Compare" button appears in the toolbar

Selection Tips:

• Selected versions display a blue border and background
• When selecting a third version, the earliest selected one is automatically replaced
• The top displays an "X versions selected" prompt

Viewing Comparison Results

[Screenshot: Version comparison interface, highlighting added and deleted content]

After clicking "Compare", the comparison view expands on the right:

Comparison View Description:

• Version range - Top displays "Version X → Version Y"
• Added content - Displayed with green background, indicating new text
• Deleted content - Displayed with red background, indicating removed text
• Unchanged content - Displayed normally as context reference

Closing Comparison:

• Click the close button (X icon) in the top right corner of the comparison view
• You can continue selecting other versions to compare

Rolling Back to Historical Versions

The rollback feature lets you undo changes and restore to any previous version. This is a major safety net in zenstory, giving you peace of mind while creating.

Performing a Rollback

[Screenshot: Rollback button on a version entry (rotating arrow icon)]

Rollback steps:

1. Find the target version - Locate the version you want to restore in the version list
2. Click the rollback button - Each historical version has a rotating arrow icon on the right
3. Confirm rollback - A confirmation dialog appears, displaying:

   "Are you sure you want to rollback to version X? Current content will be saved as a new version."

4. Complete rollback - After confirmation, the file content restores to the selected version

Important Notes:

• The latest version (first item) has no rollback button because it is the current version
• Rollback does not overwrite or lose any history
• The rollback operation itself also creates a new version (type: "Rollback")

Rollback Safety Mechanism

[Screenshot: Version list after rollback, showing the new "Rollback" version]

zenstory's rollback is a non-destructive operation:

• Current state auto-saved - Before rollback, the system saves current content as a new version
• History fully preserved - All historical versions remain, nothing deleted or overwritten
• Can rollback again anytime - You can rollback from a "rollback version" to other versions

Example Scenario:

Assume your version history is as follows:

• v5 (Latest) - AI expanded Chapter 3
• v4 - Modified character dialogue
• v3 - Added scene description
• v2 - Created file

If you rollback from v5 to v3, the version history becomes:

• v6 (Latest, rollback version) - Restored to v3 content
• v5 - AI expanded Chapter 3
• v4 - Modified character dialogue
• v3 - Added scene description
• v2 - Created file

You can rollback from v6 to v5 or v4 at any time without losing any content.

Viewing Version Content

Besides comparing and rolling back, you can also view the complete content of any historical version.

Viewing Historical Version Content

[Screenshot: "View Content" button on a version entry (document icon)]

Operation steps:

1. Find the target version - Locate the version you want to view in the version list
2. Click the document icon - The document icon button on the right side of the version entry
3. Browse content - The complete version content will be displayed

Use Cases:

• Want to recall a previously deleted paragraph
• Confirm specific content of a version before deciding to rollback
• Search for a sentence or setting you once wrote

Version History Best Practices

When to View Version History

Daily Use:

• Recall previous creative ideas
• Find deleted content fragments
• Compare writing styles across different versions

When Collaborating with AI:

• Review AI modifications (AI edit versions are specially marked)
• If unsatisfied with AI changes, rollback to the pre-modification version
• Compare differences before and after AI modifications to learn and improve writing

Creative Exploration:

• Try different writing directions while keeping all exploration records
• Create "safety points" before major changes (although auto-save records everything, you can add descriptions as markers)
• Extract inspiration from old versions to incorporate into current version

Version Management Tips

1. Use version comparison wisely - Before accepting major AI changes, compare to see specific differences

2. Create with confidence - Version history is your safety net, don't worry about making mistakes

3. Understand version types - Pay attention to version tags to distinguish between your manual edits and AI modifications

4. Rollback is not the end - After rolling back, you can continue editing or rollback to other versions again

FAQ

Q: Is there a limit on the number of versions?

A: The system saves all versions with no hard limit. Versions use differential storage technology and won't take up excessive space.

Q: Can I delete a specific version?

A: Currently, deleting individual versions is not supported. Version history is a complete timeline; maintaining integrity helps trace the creative process.

Q: Can I undo a rollback?

A: Yes! The pre-rollback version (v5) is still saved in the history, and you can rollback to it again at any time.

Q: How many versions can be compared simultaneously?

A: Currently, you can select two versions for comparison. When selecting, they are automatically sorted by version number (older version → newer version).

Q: Will there be too many auto-saved versions?

A: The system intelligently manages auto-save frequency to avoid creating too many redundant versions. You can also choose whether to display auto-saved versions in version history.

Q: What's special about AI edit versions?

A: AI edit versions display a robot icon and "AI Edit" tag, making it easy to identify which are AI modifications. Particularly useful when reviewing AI work.

Q: Can I add custom descriptions to versions?

A: Some interfaces support editing version descriptions. Adding descriptions to important versions can help you quickly identify and locate them later.

Keyboard Shortcuts

The version history panel supports the following shortcuts:

• Esc - Close the version history panel
• Click version entry - Select/deselect version

Next Steps

Now that you've mastered the version history feature, you can:

• Learn about file management - Learn how to organize project files
• Chat with AI - Explore how AI helps you modify content
• Interface overview - Review the complete zenstory interface

Happy creating, with no worries!