# ADR-0002:磁盘目录用 UUID(storage_key)映射 - **状态**:Accepted ## 背景 中文文件名、重名项目在文件系统层面易出乱码与冲突。 ## 决策 磁盘文件夹名使用 `storage_key`(UUID,36 字符),数据库 `projects.storage_key` 保存映射;对外展示名 `projects.name` 与磁盘名解耦。 ## 后果 - 展示名可随时改,磁盘标识不变。 - 资源路径以 uuid 为根,天然隔离且无中文。 ## 关联 DV-0002。