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。