如何將 Heptabase 資料一鍵匯入 Flexnote

更換筆記工具時，真正的成本往往不在學習新介面，而在歷史資料能否完整遷移。 若使用者已在 Heptabase 中積累大量卡片、白板、PDF 高亮、日記與標籤，並用於文獻整理或長期研究，從空白工作區重新開始通常並不可行。

Flexnote 現已支援直接讀取本機 Heptabase 資料（hepta.db 或 Backup），並按空間完成一鍵匯入。 使用者可為每個 Heptabase 空間建立對應的 Flexnote 工作空間，也可將所選內容寫入當前工作空間；再次匯入時可選擇跳過或覆蓋。 匯入過程僅讀取源資料，不會修改、刪除或移動原有 Heptabase 檔案。

支援匯入的內容範圍

本功能並非僅複製正文文本。Flexnote 會掃描本機 Heptabase 資料，並按內容型別進行結構化轉換。當前主要支援以下內容：

匯入前須知：主要轉換規則

需基於本機資料庫，而非僅依賴匯出 JSON

當前版本支援從本機 hepta.db 或 Backup 目錄匯入。若僅持有 all-data.json 等匯出檔案、且缺少對應資料庫，則暫無法完整還原白板結構與附件路徑。 桌面端將盡可能自動檢測本機 Heptabase；若未能識別，亦可手動選擇 Backup 目錄。

白板按結構轉換，而非截圖遷移

白板上的卡片例項、分組（Section）、文本元素、媒體、PDF、腦圖節點與連線均按型別轉換。 連線將盡可能保留路徑型別、箭頭、顏色，以及連線上的富文本標籤。 由於 Heptabase 與 Flexnote 的畫布模型並不完全一致，對於複雜巢狀分組、特定顏色語義或特殊節點，建議匯入後抽檢常用白板。

PDF 高亮與筆記高亮分別對映

PDF 中的文本高亮與區域高亮將匯入至 PDF 閱讀器，顏色與位置儘可能對齊原文；卡片正文中的高亮標記將轉換為 Flexnote 的筆記高亮，並保留關聯筆記。匯入完成後，建議核對若干含高亮的 PDF 與筆記，確認顯示效果與跳轉是否符合預期。

卡片高度沿用 Heptabase 記錄尺寸

兩款產品在內容邊距與預設字號上存在差異。為降低白板上卡片重疊的風險， 匯入時將沿用 Heptabase 記錄的卡片高度，並關閉自動高度。 匯入完成後，使用者仍可在 Flexnote 中手動調整，或重新開啟高度自適應。

操作步驟

第一步：開啟匯入入口並檢測本機 Heptabase

在 Flexnote 側欄開啟匯入視窗，選擇「Heptabase」。 桌面端將嘗試讀取本機資料；檢測成功後會顯示版本號，以及各空間的筆記、白板、日記與標籤數量。 若未能自動識別，可點選「選擇 Backup」指定目錄，或執行「重新檢測」。

第二步：選擇空間與寫入目標

勾選待匯入的 Heptabase 空間，並選擇寫入目標：

• 為每個空間新建工作空間：最接近原有空間結構，適用於完整遷移。若免費版僅支援單個工作空間，需升級後再按空間分別匯入。
• 匯入到當前工作空間：將所選空間內容寫入當前已開啟的工作空間，適用於單課題遷移或小規模驗證。

第三步：開始匯入並核驗結果

點選開始匯入後將顯示進度。完成後會彙總新建的筆記、日記、白板、PDF、高亮、腦圖、屬性、檢視與附件數量。 建議隨後核驗：常用白板、含雙鏈或 mention 的筆記、含高亮的 PDF，以及帶標籤的日記。

二次匯入與去重策略

預設情況下不會重複建立已匯入物件。Flexnote 會記錄源物件與目標物件的對應關係。再次匯入同一批內容時，可選擇：

• 跳過已有：保留使用者已在 Flexnote 中修改過的版本，僅補充尚未匯入的內容，適用於日常增量遷移。
• 覆蓋更新：以 Heptabase 當前內容更新已有項，並同步白板上的新增內容。使用前請確認 Flexnote 中不存在僅存在於本地、且需保留的重要修改。

建議的遷移流程

1. 備份 Heptabase 資料（或確認 Backup 可用），並備份 Flexnote 資料；
2. 優先選擇同時包含筆記、白板與 PDF 的較小空間進行試匯入；
3. 核驗白板佈局、連線標籤、PDF 高亮顏色，以及卡片 mention / 雙鏈；
4. 確認無誤後，再匯入其餘空間；
5. 後續增量匯入優先使用「跳過已有」；確需以 Heptabase 為準同步時，再選擇「覆蓋更新」。

匯入功能旨在降低資料遷移成本，並不要求使用者立即中斷既有工作方式。 使用者可先遷移正在推進的課題白板，在 Flexnote 中繼續使用本地優先白板、多媒體標註與一次性買斷方案； 亦可在完成完整遷移後，將 Heptabase 作為只讀歸檔保留一段時間。 建議先以真實業務資料的小規模樣本完成驗證，再決定後續遷移範圍。