随机路径
用途
默认路径插件，从随机文件 ID 稳定生成 32 位文件名。
builtin.random-path · path
配置
下表默认值仅用于生成初始草稿，保存时不补值；“必填”表示提交时必须存在，清空后须重新填写。
| 字段 | 含义 | 必填 | 默认值 | 约束 |
|---|---|---|---|---|
directoryDepth | 分片目录层数 | 是 | 2 | 0, 1, 2 |
无请求参数。
使用示例
创建实例并关联上传配置。以文件 ID 12345678-1234-1234-1234-123456789abc 和 PNG 为例，公开路径为 12345678123412341234123456789abc.png，存储路径为 12/34/12345678123412341234123456789abc.png。
json
{
"directoryDepth": 2
}行为与限制
按文件名每两位分一层目录，0 表示不分层；只影响存储路径，不改变公开链接。相同文件 ID 生成相同路径，不包含日期或原文件名。支持 JPEG、PNG、WebP、SVG、GIF、AVIF、TIFF；上传是否允许该格式还受上传配置限制。
重新导入已有图片时，若要保留平铺公开链接，将导入的「公开路径去除层数」设为原分片层数。例如 ab/cd/abcdef.jpg 去除两层得到 abcdef.jpg，实际存储路径保持不变。