同页使用工作区 UUID 和文件短 ID 识别本地文档与附件。文件路径可以变化,但身份尽量跟随同一个文件;Markdown 正文仍是普通文件内容。
身份保存在哪里
.tano/config.json 只保存可携带的工作区身份。.tano/identities.json 记录文件短 ID、路径、内容哈希与版本等身份信息。搜索索引位于设备应用数据,可以从文件和身份清单重建。
短 ID 不等于文件名。重命名、移动或交换路径时,同页会结合文件系统标识、旧路径和内容哈希匹配身份;无法唯一判断时不会任意把旧 ID 指向另一份文件。跨卷移动时如果同时改名和改内容,可能得到新的短 ID。
为什么这对集成重要
引用和未来协作不能只依赖路径。操作文件前应先确认工作区 UUID 与当前文件 ID;写入内容还要检查读取时取得的版本或哈希。本地 MCP 要求 expectedHash,文件同步也检查远端版本。
移动或复制工作区
移动工作区时,先保存并关闭使用它的同页实例,再移动整个目录,保留 .tano/。在原设备重新打开新位置。若需要一个互不关联的副本,应创建新的工作区,而不是同时把相同 UUID 的两个目录当作独立协作来源。
误删 .tano/ 后不要直接生成新身份覆盖旧关系。先查看备份与恢复。