AI 内容创作 / 系统课时
项目目录与命名规范
项目目录与命名规范
本课将建立一套可追踪的项目目录、素材编号、版本号和交付命名规则。完成后,脚本、分镜、生成素材、音频、剪辑工程与成片能够按阶段归档,团队成员不再依赖口头说明判断哪个文件才是最新版本。
学习目标
- 设计覆盖策划、生成、剪辑和交付阶段的目录结构。
- 使用稳定的文件名表达项目、镜头、版本与状态。
- 通过初始化脚本快速创建一致的项目骨架。
推荐目录
目录应同时满足两个目标:按制作阶段快速查找,按资产类型批量处理。下面的结构把不可修改的原始素材、可反复生成的中间素材和最终交付物分开,降低误删与覆盖风险。
projects/
└── city-night-001/
├── 00-brief/
├── 01-script/
├── 02-storyboard/
├── 03-assets/
│ ├── source/
│ ├── image/
│ ├── video/
│ └── audio/
├── 04-edit/
│ └── cache/
├── 05-review/
├── 06-delivery/
└── 99-archive/00-brief 保存需求与授权引用,受限合同放在单独授权位置;01-script、02-storyboard 对应脚本和镜头。03-assets/source 存放原片,其他资产子目录按媒体类型管理制作素材。04-edit 存放工程,可重建代理和缓存归入 04-edit/cache。05-review 存审片与反馈,06-delivery 只存核准交付的副本与交付清单。历史工程及决策归入 99-archive,并按保留规则处理。
命名与版本规则
文件名应从稳定信息到变化信息排列,建议使用“小写项目标识-资产类型-编号-版本-状态.扩展名”的结构。避免使用“最终版”“最新版”“改好了”等无法排序的词。
| 字段 | 示例 | 规则 |
|---|---|---|
| 项目标识 | city-night-001 |
小写字母、数字和短横线 |
| 资产类型 | shot、voice、music |
使用团队固定词表 |
| 编号 | s03-sh012 |
场次和镜头补零 |
| 版本 | v001 |
每次可见修改递增 |
| 状态 | wip、review、approved |
只使用约定状态 |
| 文件名 | city-night-001-shot-s03-sh012-v003-review.mp4 |
不含空格和特殊符号 |
修订采用递增版本号。对于已经产生链接、反馈或审阅回执的文件,在清单上更新审批状态;交付需要带 approved 时,复制已批准的同一版本到交付目录,并记录原版本、文件名、SHA-256 与批准人。镜头编号、生成提示、源素材和使用授权可用清单关联。
初始化并验证
下面脚本保存为 init_project.sh,从团队控制的工作目录运行。项目名限定小写 ASCII 字母、数字与单短横线分组。脚本先检查已存在的路径,拒绝符号链接或非目录冲突,再创建目录,重复执行不会覆盖素材。共享目录若允许不受信任的进程同时改路径,应先隔离工作目录。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
if (( $# > 1 )); then
printf '%s\n' '用法: bash init_project.sh [project-slug]' >&2
exit 2
fi
slug="${1-city-night-001}"
if [[ ! $slug =~ ^[a-z0-9]+(-[a-z0-9]+)*$ || ${#slug} -gt 64 ]]; then
printf '%s\n' '项目名格式无效' >&2
exit 2
fi
case "$slug" in
con|prn|aux|nul|com[1-9]|lpt[1-9])
printf '%s\n' '项目名与 Windows 保留名冲突' >&2
exit 2
;;
esac
root="projects/$slug"
dirs=(00-brief 01-script 02-storyboard 03-assets 03-assets/source
03-assets/image 03-assets/video 03-assets/audio 04-edit 04-edit/cache
05-review 06-delivery 99-archive)
paths=(projects "$root")
for name in "${dirs[@]}"; do
paths+=("$root/$name")
done
for path in "${paths[@]}"; do
if [[ -L $path || ( -e $path && ! -d $path ) ]]; then
printf '路径冲突: %s\n' "$path" >&2
exit 2
fi
done
mkdir -p "${paths[@]}"
printf '已准备: %s\n' "$root"bash init_project.sh city-night-001已准备: projects/city-night-001任选一个合成测试镜头,将脚本、分镜、生成片段、剪辑工程与审阅链接按镜头 ID 关联。模拟审批后复制成片到交付目录并核对校验值;归档前用另一目录还原一次工程,确认素材链接可恢复。
本课总结
- 目录按制作阶段分层,可以减少误删、覆盖和交付混乱。
- 文件名应包含稳定标识、资产类型、编号、版本和状态。
- 历史版本只归档不覆盖,交付目录只保留已验收文件。
下一课预告
下一阶段将把统一目录用于真实项目启动,并继续完善脚本、分镜、素材清单和制作计划之间的对应关系。