AI 内容创作 / 系统课时

项目目录与命名规范

项目目录与命名规范

本课将建立一套可追踪的项目目录、素材编号、版本号和交付命名规则。完成后,脚本、分镜、生成素材、音频、剪辑工程与成片能够按阶段归档,团队成员不再依赖口头说明判断哪个文件才是最新版本。

学习目标

  • 设计覆盖策划、生成、剪辑和交付阶段的目录结构。
  • 使用稳定的文件名表达项目、镜头、版本与状态。
  • 通过初始化脚本快速创建一致的项目骨架。

推荐目录

目录应同时满足两个目标:按制作阶段快速查找,按资产类型批量处理。下面的结构把不可修改的原始素材、可反复生成的中间素材和最终交付物分开,降低误删与覆盖风险。

text
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 字母、数字与单短横线分组。脚本先检查已存在的路径,拒绝符号链接或非目录冲突,再创建目录,重复执行不会覆盖素材。共享目录若允许不受信任的进程同时改路径,应先隔离工作目录。

bash
#!/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
bash init_project.sh city-night-001
text
已准备: projects/city-night-001

任选一个合成测试镜头,将脚本、分镜、生成片段、剪辑工程与审阅链接按镜头 ID 关联。模拟审批后复制成片到交付目录并核对校验值;归档前用另一目录还原一次工程,确认素材链接可恢复。

本课总结

  • 目录按制作阶段分层,可以减少误删、覆盖和交付混乱。
  • 文件名应包含稳定标识、资产类型、编号、版本和状态。
  • 历史版本只归档不覆盖,交付目录只保留已验收文件。

下一课预告

下一阶段将把统一目录用于真实项目启动,并继续完善脚本、分镜、素材清单和制作计划之间的对应关系。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

项目目录与命名规范

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通