# AI 连续剧制作手册

这是一个中文制作知识文档仓库，面向准备制作 AI 短剧、系列短片和同一角色连续剧的个人与小团队。

**从这里开始：[AI 连续剧制作流程与 ComfyUI 基础手册](AI连续剧制作流程与ComfyUI基础手册.md)。**

资料检索与链接核查日期：**2026-10-28 至 2026-10-29**；主手册整理完成日期：**2026-10-29**。工具版本、模型和在线文档会变化，复用工作流时应再次核对当前依赖。

## 内容

主手册覆盖系列设定、跨集状态、剧本与分镜、角色和场景资产、生成工作流、声音、逐镜质检、剪辑交付，以及 ComfyUI 的节点、模型、LoRA、采样参数、显存与故障排查。

| 文件 | 用途 |
|---|---|
| [主手册](AI连续剧制作流程与ComfyUI基础手册.md) | 完整流程、基础知识、操作清单与项目模板 |
| [系列案例与制作流程研究](research/series_workflow.md) | 网上 AI 系列案例、官方指南及可迁移的制作方法 |
| [ComfyUI 与 LoRA 基础研究](research/comfy_basics.md) | 技术概念、兼容性边界和官方资料依据 |
| [本地制作案例核对](research/local_case.md) | 已完成 H3 短剧的实际模型、参数、问题与处理记录 |
| [文档检查记录](文档检查记录.json) | 主手册结构、链接和内容检查结果 |

仓库管理的是上述文档与检查记录。模型权重、训练数据、视频素材和自动生成系统代码不属于本仓库的交付内容。

## 建议阅读顺序

1. 先看主手册第 **1、3、7、12** 节，了解从立项到第一集的完整路径。
2. 再看第 **8、9、10** 节，理解 ComfyUI、LoRA、参数与常见故障。
3. 准备制作多集时，重点看第 **4、6、11** 节，建立连续性、资产和版本记录。
4. 核查依据时，查第 **16** 节的来源清单及 `research/` 中的三份研究笔记。

## 如何理解资料边界

| 类别 | 含义 |
|---|---|
| 公开资料事实 | 来自出品方、官方技术文档或原论文；只陈述来源明确披露的信息 |
| 自拟制作 SOP | 根据制作需求归纳的推荐步骤、表格和验收方法，不能当作案例剧组公开的内部原版流程 |
| 本机实测 | 仅对应记录中的 H3 工程、模型组合、参数和成片；其他模型、硬件、跨集角色或更高分辨率需要另测 |

本地案例中的三部两分钟短剧是独立故事。它们可以说明制作与检查方法，不能单独证明同一人物跨多集已经稳定。

## 本机工程链接

主手册与研究笔记保留了 `F:/AI视频项目/...` 形式的本机工程链接。这些链接指向原制作电脑上的成片、工作流和审核记录，相关文件没有随文档仓库打包。

在其他电脑阅读或复用时，请将这类链接改为自己的项目路径；公开网页来源与仓库内部相对链接可分别按原地址和当前目录访问。

## 文本约定

- 文本文件使用 **UTF-8** 编码，换行采用 **LF**。
- `.gitattributes` 负责文本换行规范，不使用编码转换过滤器。
- `.gitignore` 排除媒体成片、模型权重、缓存、虚拟环境和密钥文件，保留 Markdown 与普通 JSON 检查记录。
- 当前未添加 `LICENSE` 文件。

## GitHub 与 Gitea 手动同步

当前采用手动同步，每次更新手册或相关文档时，同时更新以下两个私有仓库：

- [GitHub / suanyuit-cyber/ai-series-comfyui-handbook](https://github.com/suanyuit-cyber/ai-series-comfyui-handbook)
- [Gitea / qishizhe/ai-series-comfyui-handbook](https://git.lain.asia/qishizhe/ai-series-comfyui-handbook)

在本地 `main` 完成文档修改和检查后，提交并推送到 GitHub，再将同一版本的变更同步到 Gitea。Gitea 命令行没有可用凭据时，通过已登录的网页编辑或上传文件。

交付前核对两边文件列表与内容；可导出 Gitea 的 Git Bundle，与 GitHub 的 Git 文件树比较。两边保留各自的提交历史，提交 SHA 可以不同，最终文件树应一致。

自动同步目前未启用。此前准备的配置保存在本地 `draft/github-gitea-sync` 草稿分支，后续是否启用由用户另行决定。具体维护要求见 [AGENTS.md](AGENTS.md)。