This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# ADR-0002：磁盘目录用 UUID（storage_key）映射
- **状态**：Accepted
## 背景
中文文件名、重名项目在文件系统层面易出乱码与冲突。
## 决策
磁盘文件夹名使用 `storage_key`（UUID，36 字符），数据库 `projects.storage_key` 保存映射；对外展示名 `projects.name` 与磁盘名解耦。
## 后果
- 展示名可随时改，磁盘标识不变。
- 资源路径以 uuid 为根，天然隔离且无中文。
## 关联
DV-0002。