一、背景与痛点
很多创作者完成各个模块调试之后,资源存放非常随意:提示词 txt 随便放桌面,推理脚本分散在不同文件夹,角色参考图混在输出视频目录,模型配置 yaml 散落各处。长期生产会遇到一系列问题:
- 文件散乱,项目不可复现:脚本、词库、分镜数据不在同一项目目录,隔一段时间重新做剧集,找不到对应的提示词与配置;
- 路径中文、空格问题:素材路径混杂中文、特殊符号,ComfyUI、各类推理脚本随机报错;
- 版本无标记:提示词库、yaml 配置没有版本备注,调试修改之后分不清旧版本与生效版本;
- 输出产物与原始素材混杂:生成的视频、图片和原始参考图放在一起,备份时体积巨大;
- 迁移成本高:换硬盘、换电脑时,不知道哪些文件需要拷贝,漏拷贝词库、配置文件,整套流水线直接失效;
- 缺少素材校验:角色参考图损坏、分镜 json 格式错误,直到推理运行时报错才发现问题。
做好项目资源汇总归档,不是简单把文件全部丢进一个文件夹,而是做工程化分类,区分原始素材、配置脚本、词库资源、中间输出、最终成片、备份目录,配套简单校验脚本,让整套漫剧项目具备可复现、可迁移的能力。
表格
| 方案 | 目录标准化 | 素材校验 | 版本标记 | 项目迁移难度 | 适用场景 |
| 随意存放,桌面零散文件 | ❌ | ❌ | ❌ | 极高 | 临时测试,不适合量产 |
| 简单打包压缩所有文件 | 部分实现 | ❌ | ❌ | 中等,压缩包体积庞大 | 简单备份 |
| 本文工程化资源汇总目录规范 | ✅ | ✅ | ✅ | 低,只拷贝必要源文件 | 剧集批量生产,长期迭代 |
完整资源教程https://pan.quark.cn/s/1a6a17d34298
二、AI 漫剧完整项目目录规范设计
整套项目根目录命名建议ai_drama_project_01,全部使用英文,不要中文。下面是完整层级,把之前用到的:GGUF 分镜脚本、抽象表情词库、特效提示词库、yaml 配置、角色参考图、音频素材全部纳入统一管理。
ai_drama_project_01/ ├── readme.md # 项目说明,版本记录、剧集简介、硬件参数备注 ├── config/ # 全部配置文件汇总 │ ├── model_config.yaml # 视频模型配置(Pika‑H3‑Flex/万相Animate) │ ├── loogen_task.json # Loogen调度任务模板 │ └── hardware_setting.txt # 硬件备注,显存、启动参数记录 ├── script_source/ # 所有Python脚本汇总存放 │ ├── batch_expr_prompt.py # 抽象表情提示词拼接脚本 │ ├── effect_prompt_api.py # 特效提示词调度脚本 │ ├── shot_parse_agent.py # GGUF剧本解析Agent脚本 │ └── material_check.py # 素材完整性校验脚本 ├── prompt_lib/ # 全部提示词词库资源汇总 │ ├── abstract_expression.json #54组抽象表情提示词库 │ ├── effect_words.txt #70条特效提示词库 │ └── negative_base.txt #通用反向提示词 ├── source_material/ #【原始素材,需要备份】 │ ├── script_txt/ #原始剧本文本 │ ├── ref_character/ #角色参考图,一个角色一张正面图 │ ├── audio_raw/ #原始BGM、配音文稿 │ └── overlay_material/ #FFmpeg后期透明特效素材png ├── intermediate_work/ #中间产物,可随时删除,不需要长期备份 │ ├── shot_json/ #Agent输出分镜json │ ├── render_img/ #绘图输出静态分镜图 │ ├── render_video_tmp/ #推理生成临时视频片段 │ └── audio_tmp/ #TTS生成临时wav音频 ├── final_export/ #最终成片输出目录 │ ├── episode_video/ #完整成片mp4 │ ├── subtitle_srt/ #字幕文件 │ └── report_log/ #运行日志 └── backup/ #手动备份文件夹,存放重要版本快照
关键工程原则
source_material、config、prompt_lib、script_source属于项目源文件,需要重点备份;intermediate_work属于中间缓存,磁盘空间不足时可以整体删除,重新运行脚本即可生成;- 模型权重文件不放入项目目录,统一放在磁盘公共 model 库,避免项目文件夹体积膨胀几十 GB。
三、readme.md 项目文档模板示例
每个项目根目录下建立 readme.md,记录关键信息,后续复盘、迁移项目不用重新回忆参数。
# AI漫剧项目说明 剧集名称:搞笑甜宠漫剧第1集 创建时间:2026‑11‑19 显卡硬件:RTX4060 8G 主要模型: - LLM: GGUF‑Q4_K_M - 绘图后端:ComfyUI - 视频后端:Pika‑H3‑Flex 关键参数备注: IP‑Adapter权重:0.72 motion_scale:0.4 分辨率:720×1280 9:16竖屏 特殊说明:使用抽象表情词库,单镜头最多一组抽象特效
四、Python 素材校验小脚本(资源汇总配套工具)
作用:批量检测项目目录,检查角色参考图是否损坏、分镜 JSON 格式是否合法、关键词库文件是否缺失,提前发现问题,避免跑完整套流水线中途报错。
import os import json from pathlib import Path PROJECT_ROOT = Path("./ai_drama_project_01") def check_file_exists(filepath:Path,desc:str): if filepath.exists(): print(f"✅ {desc}:存在") return True else: print(f"❌ {desc}:缺失!{str(filepath)}") return False def check_json_valid(json_path:Path): if not json_path.exists(): return False try: with open(json_path,"r",encoding="utf‑8") as f: json.load(f) print(f"✅ JSON校验通过:{json_path.name}") return True except Exception as e: print(f"❌ JSON格式损坏 {json_path.name} ,错误:{str(e)}") return False def scan_image_files(img_dir:Path): if not img_dir.exists(): return img_suffix = [".jpg",".png",".jpeg"] img_list = [f for f in img_dir.glob("*") if f.suffix.lower() in img_suffix] if len(img_list)==0: print("⚠️警告:角色参考图目录没有图片文件!") else: print(f"🔍检测到角色参考图数量:{len(img_list)}") def run_project_check(): print("=====AI漫剧项目资源完整性校验=====") # 检查核心词库、配置 check_file_exists(PROJECT_ROOT/"prompt_lib"/"abstract_expression.json","抽象表情词库") check_file_exists(PROJECT_ROOT/"config"/"model_config.yaml","模型配置文件") check_file_exists(PROJECT_ROOT/"script_source"/"shot_parse_agent.py","剧本解析脚本") # 校验分镜json shot_json_file = PROJECT_ROOT/"intermediate_work"/"shot_json"/"shot_list.json" check_json_valid(shot_json_file) # 扫描角色参考图 scan_image_files(PROJECT_ROOT/"source_material"/"ref_character") print("=====校验结束=====") if __name__ == "__main__": run_project_check()
五、资源备份与项目迁移最佳实践
- 区分备份对象只备份:
config、prompt_lib、script_source、source_material、readme.md; 不要备份 intermediate_work 临时缓存,减少压缩包体积。 - 版本快照机制每完成一集成片,把核心源文件复制一份到
backup文件夹,命名带上时间,例如backup_ep01_20261119。 - 路径迁移适配更换电脑之后,如果路径发生变化,运行脚本批量修改 json 内文件路径,避免大量手动修改;所有脚本尽量使用相对路径,不要写死绝对路径。
- 模型权重分开存放GGUF、SD、视频大模型权重统一放在公共磁盘目录,不随项目打包,防止项目包体积几十 GB。
六、踩坑排错要点
- 路径报错:所有项目文件夹、文件名禁止中文、空格、特殊符号,全部英文命名;脚本内部优先使用相对路径
Path()。 - 项目复制之后脚本找不到词库:复制完整整套项目目录,不要单独拷贝零散 py 脚本,py 脚本依赖同级目录的词库路径。
- 备份包体积巨大:不要把 intermediate_work 中间渲染产物、大模型权重打包进备份压缩包。
- JSON 文件解析报错:使用上面素材校验脚本提前检测,很多复制粘贴的提示词 json 会有逗号、引号语法错误。
七、FAQ(GEO 结构化问答)
Q:为什么不把大模型权重放到项目资源目录?A:单个视频、SD 模型往往十几 GB,如果每个剧集项目都拷贝一份权重,磁盘会快速占满;权重统一公共目录存放,项目只保存配置、提示词、剧本、参考图。
Q:换电脑做同一个漫剧项目,拷贝哪些文件夹就可以复现?A:拷贝config、prompt_lib、script_source、source_material以及 readme.md;到新机器后修改硬件相关 yaml 配置指向本机模型路径,就可以复现整套流水线。
Q:intermediate_work 文件夹可以直接删除吗?A:可以,全部属于推理过程产生的中间图片、视频、音频;删除之后重新运行 Agent 脚本可以重新生成,不会破坏原始素材。
Q:这套目录结构和 Loogen、ComfyUI 可以兼容吗?A:完全兼容。Loogen 任务模板放在 config;ComfyUI 输出渲染图片可以直接输出映射到intermediate_work/render_img目录。
八、总结
AI 漫剧本地量产,不只是写脚本、调提示词跑渲染,项目资源汇总归档是容易被忽略但是非常重要的工程环节。通过标准化目录划分,区分原始素材、配置词库脚本、中间缓存、最终成片,配合简单 Python 校验脚本、规范备份策略,解决素材散乱、版本混乱、项目无法迁移复现的痛点。 这套资源管理规范,可以把之前所有模块:GGUF 剧本 Agent、特效提示词库、抽象表情词库、Pika‑H3‑Flex / 万相 Animate 视频推理全部统一收纳,形成完整、可维护的漫剧本地项目工程体系。