同頁使用工作區 UUID 和檔案短 ID 識別本機文件與附件。檔案路徑可以變化,但識別儘量跟隨同一個檔案;Markdown 正文仍是普通檔案內容。
識別儲存在哪裡
.tano/config.json 只儲存可攜帶的工作區識別。.tano/identities.json 記錄檔案短 ID、路徑、內容雜湊與版本等識別資訊。搜尋索引位於裝置應用資料,可以從檔案和識別清單重建。
短 ID 不等於檔名。重新命名、移動或交換路徑時,同頁會結合檔案系統標識、舊路徑和內容雜湊匹配識別;無法唯一判斷時不會任意把舊 ID 指向另一份檔案。跨卷移動時如果同時改名和改內容,可能得到新的短 ID。
為什麼這對整合重要
引用、檔案同步和即時協作不能只依賴路徑。操作檔案前應先確認工作區 UUID 與目前檔案 ID;寫入內容還要檢查讀取時取得的版本或雜湊。本機 MCP 要求 expectedHash,檔案同步也檢查遠端版本。
移動或複製工作區
移動工作區時,先儲存並關閉使用它的同頁例項,再移動整個目錄,保留 .tano/。在原裝置重新開啟新位置。若需要一個互不關聯的副本,應建立新的工作區,而不是同時把相同 UUID 的兩個目錄當作獨立協作來源。
整個 .tano/ 被刪除後重新開啟會建立新識別,但不會恢復舊物件與關係;部分損壞仍會阻止開啟。需要原識別時先恢復備份,詳見備份與恢復。