DuRT 3.0.0 升级指南：数据库重构与旧版数据迁移

WARNING

升级前必读（严重警告）：
DuRT 3.0.0 对底层数据持久化架构（GRDB SQLite 引擎）与工作流调度核心进行了革命性的大版本重构。新版与 2.x 及更早版本的数据库结构完全不兼容。
如果您曾经安装并运行过 DuRT 旧版本，切勿直接覆盖安装！ 否则将可能导致应用启动时数据库崩溃（Crash）、会话无法读取或功能状态异常。请务必按照下文步骤进行资源迁移与干净卸载。

---

1. 迁移判断：我是否需要转移资源？

DuRT 的工作空间（Workspace）决定了您历史音频、字幕和转录文档的存放位置：

工作空间类型	存储位置特点	是否需要手动迁移？	处理建议
自定义工作空间	用户在设置中自定义绑定的外部文件夹（如个人文稿、外置硬盘等）	无需转移 ✅	您的音频、字幕和文档均保存在您指定的文件夹中，升级或卸载旧版完全不受影响。新版安装后重新绑定该文件夹即可。
默认工作空间 (Default)	系统沙盒内的默认应用目录（~/Library/...）	必须立即转移 ⚠️	卸载旧版或清理沙盒缓存时，默认工作空间内的内容可能丢失。升级卸载前必须手动导出或移出重要文档、字幕和音频！

---

2. 默认工作空间资源转移操作指引

如果您此前一直使用的是默认工作空间，请在卸载旧版本前完成以下操作：

1. 打开当前旧版 DuRT。
2. 导出关键字幕与文稿：
   • 进入历史会话或编辑器，将需要留存的重点转录记录导出为 .srt、.vtt、.json 或 .txt 文档，保存到您 Mac 的 “下载 (Downloads)” 或 “文稿 (Documents)” 目录。
3. 定位并备份默认工作区本地文件夹：
   • 打开 Finder（访达），按下快捷键 Command ⌘ + Shift ⇧ + G；
   • 输入路径（沙盒目录）：

     ~/Library/Containers/com.dudufuture.durt/Data/Library/workspace

   • 若能看到其中的音频、导出的字幕或临时工程文件，请直接将整个 workspace 文件夹复制备份到您的桌面或外部安全路径中。

---

3. 彻底卸载旧版本（关键步骤）

在安装全新的 DuRT 3.0.0 之前，请务必执行“干净卸载”，清除旧版冲突的 SQLite 数据库文件：

步骤 A：退出并删除旧版 App

1. 确保旧版本 DuRT 已完全退出（检查菜单栏和 Dock 栏图标是否已关闭）。
2. 打开访达中的 “应用程序 (Applications)” 目录。
3. 将旧版 DuRT.app 拖入废纸篓，并右键点击废纸篓选择 “清空废纸篓”。

步骤 B：清理旧版数据库与沙盒缓存

打开终端（Terminal）或在访达中进入沙盒目录，清理旧版冲突的 SQLite 数据库：

# 清理旧版沙盒数据库目录（此操作不会影响已导出到个人文稿的独立文件）
rm -rf ~/Library/Containers/com.dudufuture.durt/Data/Library/database

或者，如果您想进行最彻底的“净室重新安装”，可直接删除旧版应用容器（请确保已完成前述数据备份）：

rm -rf ~/Library/Containers/com.dudufuture.durt

---

4. 安装并开启 DuRT 3.0.0 全新体验

完成上述清理后：

1. 前往 Mac App Store 搜索 DuRT 或通过官网链接下载安装全新的 DuRT 3.0.0 正式版。
2. 首次启动时，DuRT 3.0.0 会自动创建全新的高性能 GRDB 数据库池与全新工作流引擎。
3. 进入 设置 (Settings) → 工作空间 (Workspace)：
   • 如使用自定义工作空间，点击 “＋ 添加” 重新关联您之前备份或指定的文件夹即可；
   • 如使用 Pro 会员，在设置中点击 “恢复购买” 即可同步您的订阅或买断权益。

遇到任何升级或数据问题，欢迎随时联系官方技术支持邮箱：dufuture@outlook.com。