使用指南 · 實用指南
用核對清單複製選定的 Obsidian 筆記與附件
對於少量且已人工核實的檔案，使用只含明確資料庫內相對路徑的清單，先預覽每個目的位置，只複製到全新的資料夾，再以 SHA-256 驗證每個檔案，最後才把結果作為另一個資料庫開啟。
搬移整個 Obsidian 資料庫很容易，因為資料庫本身就是一般資料夾。只搬移少量筆記及其實際使用的附件則更困難：連結寫法不同，而且附件資料夾可設定，因此依檔名猜測並不安全。
本指南刻意限縮範圍。你必須人工確認直接關聯的本機檔案，列出精確的資料庫內相對路徑，預覽計畫，只複製到新的目的位置，並以 SHA-256 驗證清單中的每個檔案。它不會解析 Markdown，也不保證相依項目清單完整。
1. 僅用於你能人工盤點的小型檔案集
讓來源資料庫保持閒置。逐一檢查所選筆記中的每個嵌入檔案與本機連結。Obsidian 文件說明，附件是資料庫中的一般檔案，其位置可能受資料庫與資料夾設定影響。請解析磁碟上的實際檔案，不要依畫面顯示的連結文字猜測路徑。
這不是自動匯出器：它不會跟隨 Wiki 連結、遞迴處理已連結筆記、解碼所有 URL 形式或發現遺漏的資源。若需要自動完成相依關係，請使用仍在維護的外掛或專用匯出工具。
2. 建立明確清單與來源檔案盤點
在資料庫外建立 UTF-8 文字檔。每行寫一個精確相對路徑並使用正斜線，例如分別寫入 Notes/Project brief.md、Assets/diagram.png 與 Other/diagram.png。保留目錄可區分同名檔案。空白行、點路徑區段、目錄穿越、絕對路徑、反斜線，以及重複或忽略大小寫後等價的項目都會被拒絕。
記錄來源資料庫、新目的位置、清單 SHA-256 與檔案數量，並保留來源備份。此驗證比較內容雜湊，不保留存取時間、延伸屬性或所有檔案系統中繼資料。
3. 先執行零寫入計畫
點擊下方「下載複製指令碼（.py）」，或開啟 https://watchatease.com/news/tools/manifest-copy-1a2d9dca.py，將原始檔案另存為 manifest_copy.py。本流程在 Linux Python 3.12.14 上測試。在下載目錄執行 sha256sum manifest_copy.py，結果必須為 1a2d9dca3bc1e66feb55e3f639d9b32318084266ba76494f5a2f079b4a0773e2；不一致就停止。接著執行：python3 manifest_copy.py --source '/path/to/source-vault' --manifest '/path/to/paths.txt' --target '/path/to/new-vault'。將三個範例路徑換成自己的路徑。未加 --apply 時只輸出精確路徑、位元組數與雜湊，並標示 writesPerformed:false。
完整閱讀計畫並核對每個目的位置。工具會掃描整個來源目錄樹的符號連結，以及 NFC 正規化加大小寫折疊後的衝突，因此無關的符號連結，或 Assets/A.PNG 與 Assets/a.png 這類組合，也會阻止執行。不要繞過這項拒絕。
4. 只對全新目的位置套用一次
確認計畫正確後，加入 --apply 再次執行。目的位置必須不存在，其上層目錄必須已存在，而且不能位於來源資料庫內。獨佔建立會把已存在的目的檔案視為錯誤，而不是覆寫。程式只複製清單中的檔案。
開啟新資料庫前，先閱讀執行結果。應顯示 ok:true 與 allListedFilesVerified:true；清單中每個檔案應有 verified:true，且原始、已複製及複製後來源檔案的 SHA-256 一致。這只驗證已列出的位元組，不會檢查清單是否包含所有附件，也不證明 Obsidian 能正確顯示複製後的筆記。
5. 驗證後再開啟或刪除任何內容
把回條視為檔案系統檢查，而非 Obsidian 驗收。核對數量與路徑，獨立比較目的檔案雜湊，再把新資料夾作為獨立資料庫開啟並檢查筆記與附件。測試案例沒有驗證圖形介面呈現。
在新資料庫通過檢查並擁有自己的備份前，不要變更來源資料庫。若發現遺漏檔案，請修正人工清單並使用另一個尚不存在的新目的位置，不要合併進不完整目錄。
6. 把拒絕視為安全邊界
套用失敗後可能留下部分目的資料夾。保留錯誤、檢查原因，並選擇另一個不存在的目的位置。缺少檔案、目錄項目、目錄穿越、絕對路徑、重複項、符號連結、目的位置已存在，以及大小寫或 Unicode 衝突，都是刻意設定的拒絕條件。
26 個測試案例只在 Linux Python 3.12.14 上執行，並假設複製期間沒有並行變更。Windows 路徑行為、macOS 正規化、Obsidian 圖形介面呈現與同步客戶端均未測試。遇到這些情況或大量檔案時，請評估仍在維護的匯出工具或外掛，並備份兩個資料庫。
