可视化文件版本管理工具，专为创意工作流设计。以节点图的形式追踪工程文件的版本演进、分支与合并关系，支持 Blender、Photoshop、Maya、After Effects 等 20+ 种创意软件的文件格式。
- 文件 → 新建项目（Ctrl+N）
- 输入项目名称
- 选择项目根目录（通常为工程文件夹）
- 勾选需要追踪的文件格式（可多选）
- 确认后，程序会在根目录创建
.vmtree文件夹存储项目数据
- 文件 → 打开项目（Ctrl+O）浏览选择目录
- 文件 → 最近打开的项目 快速打开历史项目
- 直接在资源管理器中将目录拖入窗口
项目数据存储在
.vmtree/中，请勿手动修改或删除该文件夹。
节点 = 一个文件版本
边 = 版本之间的派生关系
| 类型 | 说明 | 徽标 |
|---|---|---|
| 文件节点 | 跟踪的工程文件 | 彩色左侧色条 |
| 合并节点 | 多个版本的合并结果 | 紫色 M 徽标 |
| 缺失节点 | 文件已被移动/删除/重命名 | 红色 |
[v1.blend] ← 根节点
↙ ↘
[v2.blend] [v2b.blend] ← 分支
↘ ↙
[merged.blend] ← 合并节点 (M)
↓
[final.blend]
方式一：工具栏 点击"添加根节点"按钮，选择一个文件即可创建独立根节点。
方式二：拖拽到节点 从文件管理面板拖拽文件到已有节点上，新节点将连接到该节点之后：
- 若目标节点无后续节点 → "追加到末尾"
- 若目标节点已有后续节点 → "从此分支"
方式三：拖拽到画布空白区 创建独立的根节点。
- 单击 节点切换选中状态（多选）
- 点击空白区 取消所有选中
- 双击节点 打开详情窗口，可编辑描述、管理预览文件
- 右键节点 → 编辑描述 快速修改描述文本
- 选中两个或更多节点（单击多选）
- 右键 → "合并选中节点"
- 从弹出窗口选择一个未追踪的文件作为合并结果
- 输入合并描述
右键节点 → "删除节点"，确认后节点及其连接线将被移除。
当文件被重命名或移动后，节点变为红色。双击节点打开详情，点击"重新定位"按钮，从当前未追踪文件中选择正确文件重新关联。
窗口下半部分为文件列表，显示项目目录下所有匹配格式的文件。
| 状态 | 图标 | 说明 |
|---|---|---|
| 已追踪 | 绿色圆点 | 已在版本图中 |
| 未追踪 | 灰色圆点 | 尚未加入版本图 |
- 双击文件 在资源管理器中打开所在文件夹
- 右键已追踪文件 → "在图中定位此节点"
- 拖拽文件到画布即可添加为节点
| 操作 | 快捷键 |
|---|---|
| 平移画布 | 鼠标中键拖拽 |
| 缩放 | Ctrl+滚轮 |
| 放大 | Ctrl+= |
| 缩小 | Ctrl+- |
| 适应窗口 | Ctrl+0 |
| 快捷键 | 功能 |
|---|---|
| Ctrl+N | 新建项目 |
| Ctrl+O | 打开项目 |
| Ctrl+Z | 撤销 |
| Ctrl+Q | 退出 |
| Ctrl+= / Ctrl+- | 缩放 |
| Ctrl+0 | 适应窗口 |
| 格式 | 软件 | 节点色 |
|---|---|---|
| .blend | Blender | 橙色 |
| .psd | Photoshop | 蓝色 |
| .ai | Illustrator | 橙黄 |
| .prproj | Premiere Pro | 紫色 |
| .aep | After Effects | 粉紫 |
| .c4d | Cinema 4D | 棕红 |
| .ma / .mb | Maya | 蓝灰 |
| .max | 3ds Max | 红棕 |
| .fbx / .obj | 通用 3D | 绿色 |
| .flp / .als | FL Studio / Ableton | 青绿 |
| .spp | Substance Painter | 粉紫 |
| .hip | Houdini | 青色 |
| .kra / .xcf | Krita / GIMP | 橙色 |
| .clip | Clip Studio | 淡黄 |
| .fcpxml | Final Cut Pro | 紫色 |
在节点详情窗口中，可为节点上传预览文件（图片、视频、音频、文本），支持格式：
- 图片: PNG, JPG, GIF, BMP, WebP
- 视频: MP4, MOV, AVI, WebM, MKV
- 音频: MP3, WAV, FLAC, OGG
- 文本: TXT, MD, PY, JSON, HTML, CSS, JS 等
你的项目目录/
├── 工程文件.blend
├── ...
└── .vmtree/ ← 项目数据（勿手动修改）
├── project.json ← 项目配置
├── nodes.json ← 节点数据
├── edges.json ← 连接线数据
└── previews/ ← 预览文件
└── {node_id}/
Q: 文件被重命名后节点变红了怎么办？ A: 打开项目后，缺失文件对应的节点会自动变红。双击节点，点击"重新定位"选择重命名后的文件即可。
Q: 如何迁移项目到其他目录？
A: 将整个项目文件夹（包含 .vmtree）复制到新位置即可。若路径变更导致节点变红，使用"重新定位"功能逐一修复。
Q: 可以多人协作吗？
A: .vmtree 文件夹可以通过其他网络工具共享，但需注意 nodes.json 和 edges.json 的合并冲突，联网功能会在未来添加。
Q: 预览文件占用空间大吗？
A: 预览文件存储在 .vmtree/previews/ 下，按节点 ID 组织。定期清理不需要的预览可节省空间。