Initial AI manga platform

This commit is contained in:
www
2026-06-15 17:45:28 +08:00
commit 7a8191650f
267 changed files with 105987 additions and 0 deletions
+96
View File
@@ -0,0 +1,96 @@
# 00_上下文难点清单_已接入设计
## 1. 文档目的
本文件把前面讨论过的系统 A 关键难点全部列出来,并标明已经接入哪些文档和模块,避免后续开发时遗漏。
---
# 2. 已讨论难点总表
| 难点 | 风险 | 已接入设计位置 |
|---|---|---|
| AI 原创小说质量不稳定 | 剧情平淡、逻辑断裂、人物前后矛盾 | 13、12、09、10 |
| 上传小说版权风险 | 未授权改编、商业发布侵权 | 17、02、06 |
| 小说不能直接转漫剧 | 心理描写多、画面不可视化 | 13、14、09 |
| 角色一致性 | 变脸、换发型、换年龄、男女混脸 | 11、05、09、15 |
| 长篇剧情记忆 | 30-100 集后剧情忘记、伏笔丢失 | 12、05、09 |
| 分集节奏差 | 不像短视频、开头不抓人、结尾无钩子 | 13、14、10 |
| 分镜质量差 | 画面太抽象、单镜头动作太多、不可生成 | 14、13、10 |
| 画风漂移 | 第 1 集韩漫,第 2 集变写实 | 10、11、09 |
| 图片生成成本高 | 批量生成费用失控 | 16、15、09 |
| AI 视频成本高且不稳定 | 每镜头视频化成本高、动作不稳 | 14、16 |
| 配音字幕不同步 | 成品廉价、视频节奏差 | 14、09、20 |
| 批量生成失败恢复 | 中途失败导致项目废掉 | 15、05 |
| 人工审核缺失 | 崩图、违规内容、剧情错误直接交付 | 08、15、17 |
| 数据反馈缺失 | 不知道哪个题材/封面/剧情有效 | 18、05 |
| 与系统 B 重复开发 | 两套系统无法合并,成本高 | 22、04 |
| Provider 写死 | 模型变化后系统重构 | 09、04、21 |
| 最高模型成本 | 调试阶段费用暴涨 | 16、09、21 |
| Codex 一次性开发失控 | 生成大量半成品代码 | 21 |
| 长篇连载续写 | 角色成长线、伏笔、冲突线丢失 | 12 |
| 特效策略不清楚 | 不知道哪些用 FFmpeg、哪些用 AI 视频 | 14 |
| 封面标题弱 | 发布后点击率低 | 18、13 |
| 敏感内容审核 | 文本、图片、视频违规 | 17 |
| 音乐版权 | 商业交付 BGM 侵权 | 17、14 |
| 小说导入格式 | txt/docx/pdf/md 解析不稳 | 13、06 |
| 章节识别 | 章节标题混乱、广告水印 | 13、05 |
| 多角色场景 | 角色混乱,生成质量下降 | 11、14 |
| 打斗/复杂动作 | 连续动作不可控 | 14、13 |
| 全自动无人值守 | 质量和合规风险高 | 08、15、17 |
---
# 3. 本版新增重点
相比 V1,本版新增或强化:
```text
角色一致性专项设计
长篇连载记忆专项设计
小说上传解析质量标准
分镜镜头质量标准
视频合成和特效分级
批量生成和数据反馈
任务幂等和失败恢复
成本/额度/重试控制
版权授权和内容审核
系统 A/B 合并架构
Codex 分阶段开发规则
```
---
# 4. 第一阶段不追求的事情
为了减少返工,第一阶段明确不做:
```text
一键生成 100 集全自动发布
每个镜头都 AI 视频化
复杂多人打斗连续动画
自动保证爆款
自动绕过版权问题
全无人审核
多商户分销
小说收费阅读平台
IP 交易平台
```
这些后续可以做,但不能塞进第一阶段 MVP。
---
# 5. 正确开发原则
```text
先让 1 部小说生成 3 集可用漫剧
再让 1 部小说生成 10 集
再做 20-100 集长篇连载
先用图片 + FFmpeg 做视频
再只在爆点镜头接 AI 视频
先人工审核
再逐步提高自动化比例
先做 Provider mock
再接最高模型
```
@@ -0,0 +1,446 @@
# 01_系统A总需求文档_v2_生产级基线
# 系统 A:原创小说 / 上传小说 → 韩漫 / 漫剧生成系统
## 1. 项目定位
系统 A 是一套 AI 内容生产系统,目标是将:
```text
AI 原创小说
用户上传小说
后台导入授权小说
```
自动转换成:
```text
韩漫图集
漫画分镜
短视频漫剧
连载剧集
封面
标题
配音
字幕
BGM
发布素材包
```
系统 A 不只是“生成几张图”,而是一个从文本故事到视觉内容的完整生产流水线。
---
## 2. 两种核心输入模式
### 2.1 AI 原创小说模式
用户选择题材和要求,系统自动生成完整故事。
用户输入:
```text
题材
目标受众
主角设定
故事情绪
爽点类型
预计章节数
预计集数
画风
输出格式
```
系统输出:
```text
故事创意
故事大纲
故事圣经
角色圣经
章节正文
分集计划
单集脚本
分镜脚本
图片和视频
```
适合:
```text
批量测试题材
快速孵化原创 IP
规避使用他人小说的版权风险
做内容号初期素材
```
---
### 2.2 上传小说改编模式
用户上传自己拥有合法权利的小说。
支持输入:
```text
txt
docx
md
pdf
粘贴文本
章节压缩包,后续
后台批量导入,后续
```
系统处理:
```text
文件解析
文本清洗
章节识别
版权确认
故事结构分析
角色提取
章节改编
分集生成
分镜生成
漫剧生成
```
适合:
```text
小说作者改编自己的作品
工作室改编已授权小说
内部测试小说内容
公版作品二次创作,需用户确认权利
```
---
## 3. 核心产品价值
```text
降低小说漫改成本
缩短从文本到视频的周期
保持角色和画风统一
支持连续剧集生产
支持封面标题生成
支持短视频平台内容测试
支持后续 IP 沉淀
支持批量内容生产
支持人机协同审核
```
---
## 4. 第一阶段主打题材
第一阶段选择容易视觉化、角色少、冲突强的题材:
```text
都市重生
复仇逆袭
霸总甜宠
真假千金
豪门虐恋
校园暗恋
赘婿打脸
神医下山
古风重生
修仙爽文
```
暂不主打:
```text
复杂机甲
大规模战争
超多角色权谋
硬科幻
复杂群像
连续多人打斗
超长设定流玄幻
```
---
## 5. 第一阶段 MVP 目标
MVP 不追求全自动百集,而是跑通两条闭环。
### 5.1 AI 原创小说闭环
```text
输入题材
→ 生成故事创意
→ 生成故事圣经
→ 生成角色圣经
→ 生成 3 集分集计划
→ 生成每集分镜
→ 生成每镜头图片
→ 自动配音字幕
→ 合成 3 个 MP4
```
### 5.2 上传小说闭环
```text
上传小说
→ 版权确认
→ 解析章节
→ 提取角色
→ 生成故事圣经
→ 生成 1-3 集分集计划
→ 生成分镜
→ 合成 MP4
```
---
## 6. 长期生产级目标
```text
支持 20-100 集连续剧集
支持长篇剧情记忆
支持角色跨集一致
支持批量队列生成
支持人工审核和返工
支持分集封面标题
支持平台数据反馈
支持多模型切换
支持成本统计和额度控制
支持系统 A 与系统 B 合并
```
---
## 7. 系统核心对象
```text
NovelProject:小说漫剧项目
NovelSource:小说来源
NovelChapter:章节
StoryBible:故事圣经
WorldBible:世界观圣经
CharacterBible:角色圣经
CharacterAsset:角色素材
Episode:分集
EpisodeScript:单集脚本
StoryboardShot:分镜镜头
ShotImage:镜头图片
AudioAsset:音频
SubtitleAsset:字幕
VideoAsset:视频
RenderTask:生成任务
PlotMemory:剧情记忆
CharacterMemory:角色记忆
ContinuityCheck:连续性检查
```
---
## 8. 故事圣经
故事圣经用于保持全项目一致性。
必须包含:
```text
故事一句话简介
题材
核心卖点
主线目标
核心冲突
主要人物
人物关系
世界规则
时间线
重要伏笔
禁用设定
结局方向
风格基调
```
---
## 9. 角色圣经
角色圣经用于保持角色稳定。
必须包含:
```text
姓名
角色定位
年龄段
身份
外貌
发型
服装规则
性格
说话风格
人物关系
人物弧光
参考图
锚点图
表情图
负面约束
出场记录
```
---
## 10. 长篇记忆
系统必须支持长篇连载记忆:
```text
每章摘要
每集摘要
已发生事件
未解决冲突
伏笔
人物关系变化
角色成长线
道具状态
场景状态
下一集衔接点
```
长篇记忆不是后期补丁,第一版数据库和流程就要预留。
---
## 11. 改编原则
小说改编为漫剧时,不是照抄原文,而是转为:
```text
画面
动作
台词
旁白
冲突
转折
钩子
镜头
特效
```
每集结构建议:
```text
0-3 秒:强冲突
3-15 秒:交代矛盾
15-40 秒:主角行动
40-55 秒:反击/转折
结尾:悬念钩子
```
---
## 12. 视频形态
第一阶段采用:
```text
韩漫图片
+ FFmpeg 运镜
+ 配音
+ 字幕
+ BGM
+ 闪白/震屏/转场
= 短视频漫剧
```
高级阶段:
```text
关键爆点镜头接 AI 图生视频
```
不建议第一版每个镜头都 AI 视频化。
---
## 13. 人工审核策略
系统 A 必须支持人机协同,不做完全无人值守。
需要审核:
```text
上传小说版权
故事圣经
角色锚点图
分集计划
关键分镜
图片质量
视频成品
内容合规
用户修改申请
```
---
## 14. 与系统 B 的关系
系统 A 独立开发,但与系统 B 共享:
```text
用户体系
订单体系
额度体系
素材系统
AI Provider
任务队列
视频合成
内容审核
后台框架
日志监控
部署运维
```
系统 A 独有:
```text
小说管理
故事圣经
角色圣经
分集计划
分镜脚本
长篇记忆
连载发布
剧情数据反馈
```
系统 B 独有:
```text
真人照片
人像档案
人生主题
写真模板
纪念视频模板
```
---
## 15. 成功标准
系统 A MVP 验收标准:
```text
能 AI 原创生成一篇短篇小说
能上传一篇小说并解析章节
能生成故事圣经和角色圣经
能生成 3 个主要角色图
能生成 3 集分集计划
能生成每集 10-20 个分镜
能生成分镜图片
能生成配音字幕
能合成 MP4
后台可查看任务并重试失败
用户可下载成品
```
+300
View File
@@ -0,0 +1,300 @@
# 02_业务流程_状态流转_权限设计
## 1. 用户完整流程
```text
游客访问首页
→ 查看案例
→ 登录注册
→ 创建项目
→ 选择输入模式
→ AI 原创小说 / 上传小说
→ 版权或原创声明
→ 文本生成 / 文本解析
→ 故事圣经生成
→ 用户确认故事圣经
→ 角色圣经生成
→ 角色参考图生成
→ 用户确认角色锚点
→ 分集计划生成
→ 用户确认分集
→ 单集脚本生成
→ 分镜生成
→ 用户确认分镜
→ 支付 / 冻结额度
→ 生成预览图
→ 用户确认预览
→ 正式生成图片
→ 图片质检
→ 音频生成
→ 字幕生成
→ 视频合成
→ 最终质检
→ 人工审核
→ 用户确认
→ 下载交付
→ 项目归档
```
---
## 2. AI 原创小说流程
```text
创建项目
→ 选择 AI 原创
→ 选择题材
→ 填写故事偏好
→ 生成故事创意
→ 生成故事大纲
→ 生成章节大纲
→ 生成正文
→ 自检
→ 故事圣经
```
自检包括:
```text
角色名是否一致
主线是否明确
冲突是否够强
是否适合视觉化
是否有敏感内容
是否有明显抄袭风险
```
---
## 3. 上传小说流程
```text
创建项目
→ 选择上传小说
→ 上传文件 / 粘贴文本
→ 选择来源类型
→ 勾选版权授权
→ 文本提取
→ 文本清洗
→ 章节识别
→ 角色提取
→ 故事分析
→ 生成故事圣经
```
来源类型:
```text
author_self:我是作者
licensed:我已获得授权
public_domain:公版文本
internal_test:仅内部测试
```
---
## 4. 项目主状态
```text
draft
source_selecting
novel_generating
novel_uploaded
copyright_pending
copyright_confirmed
text_parsing
text_parse_failed
story_analyzing
story_bible_generating
waiting_story_confirm
story_confirmed
character_extracting
character_generating
character_image_generating
waiting_character_confirm
character_confirmed
episode_planning
waiting_episode_confirm
episode_confirmed
script_generating
storyboard_generating
waiting_storyboard_confirm
storyboard_confirmed
payment_pending
payment_paid
preview_generating
waiting_preview_confirm
preview_confirmed
final_image_generating
image_qc
audio_generating
subtitle_generating
video_rendering
final_qc
manual_review
waiting_user_confirm
revision_requested
revising
completed
failed
cancelled
archived
```
---
## 5. 主流程状态流转
```text
draft
→ source_selecting
→ novel_generating / novel_uploaded
→ copyright_pending
→ copyright_confirmed
→ text_parsing
→ story_analyzing
→ story_bible_generating
→ waiting_story_confirm
→ story_confirmed
→ character_extracting
→ character_generating
→ character_image_generating
→ waiting_character_confirm
→ character_confirmed
→ episode_planning
→ waiting_episode_confirm
→ episode_confirmed
→ script_generating
→ storyboard_generating
→ waiting_storyboard_confirm
→ storyboard_confirmed
→ payment_pending
→ payment_paid
→ preview_generating
→ waiting_preview_confirm
→ preview_confirmed
→ final_image_generating
→ image_qc
→ audio_generating
→ subtitle_generating
→ video_rendering
→ final_qc
→ manual_review
→ waiting_user_confirm
→ completed
→ archived
```
---
## 6. 失败分支
```text
任意生成状态
→ failed
→ 后台重试 / 转人工 / 取消 / 退款或返还额度
```
任务失败不应该让整个项目不可恢复。
---
## 7. 修改分支
```text
waiting_story_confirm
→ 编辑故事圣经
→ story_bible_generating / waiting_story_confirm
waiting_character_confirm
→ 重生角色图 / 编辑角色
→ waiting_character_confirm
waiting_storyboard_confirm
→ 编辑分镜 / 重生分镜
→ waiting_storyboard_confirm
waiting_user_confirm
→ revision_requested
→ revising
→ final_image_generating / video_rendering / manual_review
→ waiting_user_confirm
```
---
## 8. 权限设计
### 游客
可访问:
```text
首页
案例
套餐
FAQ
登录注册
```
不可访问:
```text
创建项目
上传小说
生成小说
下载成品
```
### 登录用户
可访问:
```text
创建项目
上传小说
AI 原创小说
查看项目进度
下载自己的成品
申请修改
删除自己的项目
```
### 运营人员
可访问:
```text
项目查看
任务查看
内容审核
案例管理
模板管理
失败任务重试
```
### 管理员
可访问:
```text
所有功能
AI Provider 配置
成本配置
系统配置
权限配置
日志审计
```
---
## 9. 操作约束
```text
未确认版权,不能解析上传小说
未确认角色锚点,不能批量生成正式图
未确认分镜,不能正式生成
未支付或未冻结额度,不能正式生成
未通过审核,不能公开案例
失败任务未处理,不能标记完成
```
+363
View File
@@ -0,0 +1,363 @@
# 03_功能清单_页面清单
## 1. 用户端功能清单
```text
首页
案例列表
案例详情
登录注册
创建项目
输入模式选择
AI原创小说设置
上传小说
版权确认
文本解析结果
故事圣经确认
角色圣经确认
角色图确认
分集计划确认
单集脚本确认
分镜确认
支付/额度确认
预览确认
生成进度
成品确认
修改申请
我的项目
用户中心
```
---
## 2. 首页
模块:
```text
顶部 Banner
AI 原创小说入口
上传小说改编入口
热门漫剧案例
热门题材
生成流程说明
套餐说明
常见问题
开始制作按钮
```
按钮:
```text
AI 原创小说
上传小说
查看案例
选择题材
查看套餐
开始制作
```
---
## 3. AI 原创小说设置页
字段:
```text
题材
主角性别
主角身份
主角性格
女主/男主类型
反派类型
目标受众
爽点类型
情绪风格
故事长度
目标集数
每集时长
结局方向
禁用内容
```
按钮:
```text
生成故事创意
重新生成
编辑创意
确认创意
```
---
## 4. 上传小说页
支持:
```text
txt
docx
md
pdf
粘贴文本
```
字段:
```text
小说标题
作者名
来源类型
文本语言
是否连载中
是否需要改名
```
按钮:
```text
上传文件
粘贴文本
确认上传
进入版权确认
```
---
## 5. 版权确认页
选项:
```text
我是作者本人
我已获得改编授权
这是公版作品
仅用于内部测试
```
勾选:
```text
我确认拥有该文本合法使用权
我授权平台为本项目进行 AI 改编
我理解未经授权不得商业发布
```
---
## 6. 文本解析结果页
展示:
```text
总字数
章节数量
章节列表
疑似广告/水印
主要角色候选
场景候选
敏感风险
解析质量评分
```
操作:
```text
确认解析
重新解析
手动编辑章节
删除无关文本
返回重新上传
```
---
## 7. 故事圣经确认页
展示:
```text
故事标题
一句话卖点
主线
核心冲突
世界观
人物关系
爽点
伏笔
结局方向
禁用规则
```
操作:
```text
确认
编辑
重新生成
添加伏笔
修改基调
```
---
## 8. 角色圣经确认页
展示角色卡:
```text
姓名
角色定位
身份
年龄
外貌
发型
服装
性格
关系
说话风格
角色弧光
参考图
锚点图
```
操作:
```text
编辑角色
生成角色参考图
重生角色图
选择锚点图
设置主角
删除无关角色
确认角色库
```
---
## 9. 分集计划页
展示:
```text
第几集
标题
剧情摘要
开头钩子
中段冲突
结尾悬念
出场角色
关联章节
预计时长
```
操作:
```text
确认分集
编辑分集
重生单集
调整顺序
拆分/合并集数
```
---
## 10. 分镜确认页
展示每个镜头:
```text
镜头号
画面描述
人物
场景
动作
台词
旁白
镜头运动
特效
时长
Prompt
负面 Prompt
生成状态
```
操作:
```text
编辑镜头
新增镜头
删除镜头
调整顺序
重生 Prompt
生成预览图
确认分镜
```
---
## 11. 生成进度页
节点:
```text
故事分析
角色生成
分集生成
分镜生成
预览图
正式图片
图片质检
音频
字幕
视频合成
人工审核
完成
```
展示:
```text
当前阶段
进度百分比
完成任务数
失败任务数
预计剩余
失败原因
联系客服
```
---
## 12. 后台功能清单
```text
仪表盘
用户管理
项目管理
小说源管理
版权记录
故事圣经管理
角色库管理
角色素材管理
章节管理
分集管理
分镜管理
任务管理
素材管理
内容审核
案例管理
题材模板管理
风格模板管理
Prompt模板管理
视频模板管理
音乐管理
订单管理
额度管理
AI Provider管理
成本日志
系统配置
操作日志
```
+201
View File
@@ -0,0 +1,201 @@
# 04_技术架构设计_模块拆分
## 1. 推荐技术栈
```text
用户端:uni-app
后台端:Geeker-Admin
后端:Node.js + NestJS
数据库:MySQL 8
队列:Redis + BullMQ
对象存储:MinIO
视频合成:FFmpeg
AI辅助:Python Worker 可选
进程管理:PM2 / systemd
反向代理:Nginx
容器化:Docker 可选
```
---
## 2. 总体架构
```text
uni-app 用户端
NestJS API Gateway
业务服务层
AI 编排层 / 任务队列层
TextProvider / ImageProvider / VoiceProvider / VideoProvider / ModerationProvider
MySQL / Redis / MinIO / FFmpeg
Geeker-Admin 后台管理
```
---
## 3. 后端模块
```text
AuthModule
UserModule
ProjectModule
NovelModule
CopyrightModule
TextParseModule
StoryBibleModule
WorldBibleModule
CharacterModule
CharacterAssetModule
EpisodeModule
ScriptModule
StoryboardModule
PromptModule
AssetModule
TaskModule
ProviderModule
ImageModule
AudioModule
SubtitleModule
VideoModule
OrderModule
QuotaModule
ReviewModule
CaseModule
AnalyticsModule
SystemConfigModule
LogModule
```
---
## 4. 系统 A 独有模块
```text
NovelModule:小说生成/上传/解析
StoryBibleModule:故事圣经
WorldBibleModule:世界观规则
CharacterModule:角色圣经
EpisodeModule:分集计划
ScriptModule:单集脚本
StoryboardModule:分镜
PlotMemoryModule:长篇记忆
ContinuityModule:连续性检查
```
---
## 5. 与系统 B 共用模块
```text
AuthModule
UserModule
OrderModule
QuotaModule
AssetModule
TaskModule
ProviderModule
ImageModule
AudioModule
SubtitleModule
VideoModule
ReviewModule
CaseModule
AnalyticsModule
SystemConfigModule
LogModule
```
---
## 6. AI Provider 抽象
Provider 不允许写死模型。
```text
TextProvider
NovelProvider
ImageProvider
VideoProvider
VoiceProvider
ModerationProvider
QualityCheckProvider
FileParseProvider
EmbeddingProvider
```
每个 Provider 需要支持:
```text
mock模式
真实模式
fallback
限流
成本记录
失败重试
请求日志
```
---
## 7. Worker 队列
```text
novel_queue
parse_queue
story_queue
character_queue
script_queue
storyboard_queue
image_queue
audio_queue
subtitle_queue
video_queue
qc_queue
review_queue
analytics_queue
```
不同队列隔离,避免视频合成堵住文本和图片任务。
---
## 8. 存储策略
```text
原始小说文件:MinIO private bucket
清洗文本:数据库 LONGTEXT + 备份文件
角色参考图:MinIO private
分镜图:MinIO private
视频成品:MinIO private
公开案例:单独 public 或 CDN bucket
```
原始小说和用户素材默认私有。
---
## 9. 事件驱动
系统内部关键事件:
```text
ProjectCreated
NovelParsed
StoryBibleConfirmed
CharacterBibleConfirmed
EpisodesConfirmed
StoryboardConfirmed
PaymentPaid
PreviewConfirmed
ImageGenerated
VideoRendered
ProjectCompleted
RevisionRequested
```
可用于后续扩展数据统计、通知、运营分析。
+489
View File
@@ -0,0 +1,489 @@
# 05_数据库表结构设计
## 1. 核心表清单
```text
users
projects
novel_sources
novel_chapters
copyright_records
story_bibles
world_bibles
characters
character_images
character_memories
episodes
episode_scripts
storyboard_shots
shot_images
plot_memories
plot_threads
continuity_checks
assets
render_tasks
provider_configs
provider_logs
orders
quota_accounts
quota_logs
revision_requests
content_reviews
case_showcases
analytics_events
system_configs
operation_logs
```
---
## 2. projects
```sql
id BIGINT PRIMARY KEY
user_id BIGINT NOT NULL
title VARCHAR(255)
input_mode VARCHAR(50) -- ai_original/upload/admin_import
genre VARCHAR(100)
style_code VARCHAR(100)
output_type VARCHAR(50)
target_episode_count INT
episode_duration INT
status VARCHAR(80)
copyright_status VARCHAR(80)
payment_status VARCHAR(80)
quality_level VARCHAR(50)
is_long_series BOOLEAN DEFAULT FALSE
created_at DATETIME
updated_at DATETIME
completed_at DATETIME
```
索引:
```text
user_id,status
genre,status
created_at
```
---
## 3. novel_sources
```sql
id BIGINT PRIMARY KEY
project_id BIGINT NOT NULL
source_type VARCHAR(50)
title VARCHAR(255)
author_name VARCHAR(100)
raw_asset_id BIGINT
raw_text LONGTEXT
clean_text LONGTEXT
word_count INT
chapter_count INT
parse_status VARCHAR(50)
parse_report JSON
created_at DATETIME
```
---
## 4. novel_chapters
```sql
id BIGINT PRIMARY KEY
project_id BIGINT NOT NULL
novel_source_id BIGINT
chapter_no INT
title VARCHAR(255)
content LONGTEXT
summary TEXT
visual_summary TEXT
word_count INT
status VARCHAR(50)
created_at DATETIME
```
`visual_summary` 用于记录该章节可视化场景摘要。
---
## 5. copyright_records
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
user_id BIGINT
authorization_type VARCHAR(50)
statement_text TEXT
ip VARCHAR(80)
user_agent TEXT
confirmed_at DATETIME
```
authorization_type
```text
author_self
licensed
public_domain
internal_test
ai_original
```
---
## 6. story_bibles
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
title VARCHAR(255)
logline TEXT
main_plot TEXT
core_conflict TEXT
selling_points TEXT
tone VARCHAR(100)
world_summary TEXT
ending_direction TEXT
taboo_rules TEXT
version INT
status VARCHAR(50)
created_at DATETIME
updated_at DATETIME
```
---
## 7. world_bibles
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
world_type VARCHAR(100)
setting_text TEXT
rules_text TEXT
power_system TEXT
social_structure TEXT
time_period TEXT
visual_rules TEXT
forbidden_rules TEXT
status VARCHAR(50)
created_at DATETIME
```
---
## 8. characters
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
name VARCHAR(100)
role_type VARCHAR(50)
gender_label VARCHAR(50)
age_group VARCHAR(50)
identity_desc TEXT
appearance_desc TEXT
hair_desc TEXT
costume_rules TEXT
personality_desc TEXT
speech_style TEXT
relationship_desc TEXT
character_arc TEXT
negative_rules TEXT
anchor_asset_id BIGINT
importance_level INT
status VARCHAR(50)
created_at DATETIME
```
role_type
```text
lead_male
lead_female
villain
supporting
extra
```
---
## 9. character_images
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
character_id BIGINT
asset_id BIGINT
image_type VARCHAR(50)
prompt_text TEXT
negative_prompt TEXT
is_anchor BOOLEAN
quality_score DECIMAL(5,2)
status VARCHAR(50)
created_at DATETIME
```
image_type
```text
front_reference
side_reference
expression
costume
anchor
episode_variant
```
---
## 10. character_memories
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
character_id BIGINT
episode_id BIGINT
memory_type VARCHAR(50)
content TEXT
created_at DATETIME
```
memory_type
```text
appearance_state
relationship_state
emotion_state
goal_state
injury_state
costume_state
```
---
## 11. episodes
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_no INT
source_chapter_ids JSON
title VARCHAR(255)
summary TEXT
opening_hook TEXT
middle_conflict TEXT
ending_hook TEXT
target_duration INT
status VARCHAR(50)
created_at DATETIME
```
---
## 12. episode_scripts
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
script_text LONGTEXT
narration_text LONGTEXT
dialogue_json JSON
version INT
status VARCHAR(50)
created_at DATETIME
```
---
## 13. storyboard_shots
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
shot_no INT
scene_name VARCHAR(255)
location_desc TEXT
characters_json JSON
visual_desc TEXT
action_desc TEXT
dialogue_text TEXT
narration_text TEXT
camera_motion VARCHAR(100)
effect_type VARCHAR(100)
duration DECIMAL(6,2)
prompt_text TEXT
negative_prompt TEXT
status VARCHAR(50)
created_at DATETIME
```
---
## 14. plot_memories
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
chapter_id BIGINT
memory_type VARCHAR(50)
content TEXT
importance_level INT
status VARCHAR(50)
created_at DATETIME
```
memory_type
```text
event
clue
foreshadowing
resolved_conflict
unresolved_conflict
relationship_change
world_rule
item_state
```
---
## 15. plot_threads
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
thread_name VARCHAR(255)
thread_type VARCHAR(80)
description TEXT
start_episode_no INT
expected_resolve_episode_no INT
resolved_episode_no INT
status VARCHAR(50)
created_at DATETIME
```
thread_type
```text
main_plot
romance
revenge
mystery
villain_plan
character_growth
```
---
## 16. continuity_checks
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
check_type VARCHAR(80)
result_status VARCHAR(50)
issue_text TEXT
suggestion_text TEXT
created_at DATETIME
```
check_type
```text
character_name
relationship
timeline
appearance
plot_thread
world_rule
```
---
## 17. assets
```sql
id BIGINT PRIMARY KEY
user_id BIGINT
project_id BIGINT
asset_type VARCHAR(50)
file_path VARCHAR(500)
file_url VARCHAR(500)
mime_type VARCHAR(100)
width INT
height INT
duration DECIMAL(10,2)
size BIGINT
hash VARCHAR(128)
visibility VARCHAR(30)
status VARCHAR(50)
created_at DATETIME
```
---
## 18. render_tasks
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
shot_id BIGINT
task_type VARCHAR(80)
provider_id BIGINT
status VARCHAR(50)
input_json JSON
input_hash VARCHAR(128)
output_asset_id BIGINT
provider_request_id VARCHAR(255)
retry_count INT
max_retry INT
cost_estimate DECIMAL(12,4)
cost_actual DECIMAL(12,4)
error_code VARCHAR(100)
error_message TEXT
created_at DATETIME
started_at DATETIME
finished_at DATETIME
```
---
## 19. analytics_events
```sql
id BIGINT PRIMARY KEY
project_id BIGINT
episode_id BIGINT
event_type VARCHAR(80)
platform VARCHAR(80)
metric_json JSON
created_at DATETIME
```
用于后续记录播放量、完播率、点赞率、评论反馈等。
---
## 20. 索引建议
```text
projects(user_id,status)
novel_chapters(project_id,chapter_no)
characters(project_id,role_type)
episodes(project_id,episode_no)
storyboard_shots(project_id,episode_id,shot_no)
plot_memories(project_id,episode_id)
plot_threads(project_id,status)
render_tasks(project_id,status)
render_tasks(task_type,status)
assets(project_id,asset_type)
```
+218
View File
@@ -0,0 +1,218 @@
# 06_API接口设计文档
## 1. 通用返回格式
```json
{
"code": 0,
"message": "success",
"data": {},
"request_id": "req_xxx"
}
```
---
## 2. 认证接口
```text
POST /api/auth/register
POST /api/auth/login
POST /api/auth/logout
GET /api/auth/profile
```
---
## 3. 项目接口
```text
POST /api/projects
GET /api/projects
GET /api/projects/:id
PATCH /api/projects/:id
POST /api/projects/:id/cancel
DELETE /api/projects/:id
```
创建项目:
```json
{
"title": "重生归来,我不再爱你",
"input_mode": "ai_original",
"genre": "urban_rebirth",
"style_code": "korean_comic",
"output_type": "short_video",
"target_episode_count": 3,
"episode_duration": 60
}
```
---
## 4. AI 原创小说接口
```text
POST /api/projects/:id/original/idea
POST /api/projects/:id/original/outline
POST /api/projects/:id/original/chapters
POST /api/projects/:id/original/self-check
GET /api/projects/:id/original/result
```
---
## 5. 上传小说接口
```text
POST /api/projects/:id/novel/upload
POST /api/projects/:id/novel/paste
POST /api/projects/:id/novel/parse
GET /api/projects/:id/novel/parse-result
PATCH /api/novel-chapters/:chapterId
```
---
## 6. 版权确认接口
```text
POST /api/projects/:id/copyright/confirm
GET /api/projects/:id/copyright
```
请求:
```json
{
"authorization_type": "author_self",
"statement_text": "我确认拥有该小说的合法改编权。"
}
```
---
## 7. 故事圣经接口
```text
POST /api/projects/:id/story-bible/generate
GET /api/projects/:id/story-bible
PATCH /api/projects/:id/story-bible
POST /api/projects/:id/story-bible/confirm
```
---
## 8. 角色接口
```text
POST /api/projects/:id/characters/extract
GET /api/projects/:id/characters
POST /api/projects/:id/characters
PATCH /api/characters/:characterId
DELETE /api/characters/:characterId
POST /api/characters/:characterId/generate-images
POST /api/characters/:characterId/set-anchor
GET /api/characters/:characterId/memories
```
---
## 9. 分集接口
```text
POST /api/projects/:id/episodes/generate-plan
GET /api/projects/:id/episodes
PATCH /api/episodes/:episodeId
POST /api/projects/:id/episodes/confirm
```
---
## 10. 脚本接口
```text
POST /api/episodes/:episodeId/script/generate
GET /api/episodes/:episodeId/script
PATCH /api/episodes/:episodeId/script
POST /api/episodes/:episodeId/script/confirm
```
---
## 11. 分镜接口
```text
POST /api/episodes/:episodeId/storyboard/generate
GET /api/episodes/:episodeId/storyboard
PATCH /api/storyboard-shots/:shotId
DELETE /api/storyboard-shots/:shotId
POST /api/episodes/:episodeId/storyboard/confirm
POST /api/storyboard-shots/:shotId/regenerate-prompt
```
---
## 12. 长篇记忆接口
```text
GET /api/projects/:id/plot-memories
POST /api/projects/:id/plot-memories/generate
GET /api/projects/:id/plot-threads
POST /api/projects/:id/plot-threads
PATCH /api/plot-threads/:threadId
POST /api/episodes/:episodeId/continuity-check
```
---
## 13. 生成接口
```text
POST /api/episodes/:episodeId/preview/generate
POST /api/episodes/:episodeId/final/generate-images
POST /api/episodes/:episodeId/audio/generate
POST /api/episodes/:episodeId/subtitle/generate
POST /api/episodes/:episodeId/video/render
GET /api/projects/:id/progress
GET /api/episodes/:episodeId/assets
```
---
## 14. 修改申请接口
```text
POST /api/projects/:id/revisions
GET /api/projects/:id/revisions
```
---
## 15. 后台接口
```text
GET /api/admin/projects
GET /api/admin/projects/:id
POST /api/admin/tasks/:id/retry
POST /api/admin/tasks/:id/cancel
POST /api/admin/tasks/:id/manual-required
GET /api/admin/tasks
GET /api/admin/provider-logs
GET /api/admin/costs
POST /api/admin/projects/:id/manual-review
```
---
## 16. 案例和数据接口
```text
GET /api/cases
GET /api/cases/:id
POST /api/admin/cases
PATCH /api/admin/cases/:id
POST /api/projects/:id/analytics/import
GET /api/projects/:id/analytics
```
+174
View File
@@ -0,0 +1,174 @@
# 07_uniapp用户端页面交互文档
## 1. 页面路由建议
```text
/pages/index/index
/pages/cases/list
/pages/cases/detail
/pages/auth/login
/pages/projects/create
/pages/projects/source-select
/pages/projects/original-setting
/pages/projects/upload-novel
/pages/projects/copyright
/pages/projects/parse-result
/pages/projects/story-bible
/pages/projects/characters
/pages/projects/episodes
/pages/projects/script
/pages/projects/storyboard
/pages/projects/payment
/pages/projects/preview
/pages/projects/progress
/pages/projects/result
/pages/projects/revision
/pages/user/projects
/pages/user/profile
```
---
## 2. 页面流程
```text
首页
→ 登录
→ 创建项目
→ 选择 AI 原创 / 上传小说
→ 版权或原创声明
→ 故事圣经
→ 角色圣经
→ 分集计划
→ 分镜
→ 支付/额度
→ 预览
→ 正式生成
→ 成品下载
```
---
## 3. 项目恢复
用户中途退出后,从“我的项目”继续。
每个项目需要保存:
```text
当前状态
已填写数据
已生成结果
待确认步骤
失败任务
下一步按钮
```
---
## 4. 角色确认交互
角色卡必须支持:
```text
编辑文字设定
生成参考图
查看多张候选图
选择锚点图
锁定角色
重生
删除低价值配角
```
未锁定主角锚点图,不允许批量正式生成。
---
## 5. 分镜确认交互
分镜卡片展示:
```text
镜头画面
人物
场景
台词
时长
运镜
特效
Prompt
预览图
```
允许:
```text
编辑
删除
新增
重排
重生 Prompt
生成预览图
```
---
## 6. 长篇连载交互
当项目集数超过 10 集时,显示“剧情记忆”入口:
```text
主线进度
人物关系变化
伏笔列表
未解决冲突
下一集衔接
```
用户可查看但普通用户不建议直接大量编辑,避免破坏结构。
---
## 7. 生成进度交互
必须显示:
```text
当前阶段
任务进度
失败数量
预计剩余
后台处理中提示
联系客服
```
如果某任务进入人工处理:
```text
显示“需要人工审核,不影响已完成内容”
```
---
## 8. 成品页交互
展示:
```text
视频播放器
封面图
图片包
字幕文件
旁白音频
下载按钮
申请修改
授权公开案例
```
修改申请需要区分:
```text
小改:字幕、标题、BGM
中改:部分镜头、图片
大改:重新分集、重做风格、重做角色
```
+249
View File
@@ -0,0 +1,249 @@
# 08_GeekerAdmin后台管理设计
## 1. 后台菜单
```text
仪表盘
用户管理
项目管理
小说源管理
版权记录
故事圣经
世界观圣经
角色库
角色素材
章节管理
分集管理
分镜管理
剧情记忆
连续性检查
素材管理
生成任务
内容审核
案例管理
订单管理
额度管理
模板管理
AI Provider
成本日志
数据反馈
系统配置
操作日志
```
---
## 2. 仪表盘
指标:
```text
今日项目数
今日生成集数
今日完成视频
失败任务数
待人工审核数
AI 成本
平均单集成本
热门题材
热门风格
角色生成失败率
视频合成失败率
队列积压数
```
---
## 3. 项目管理
操作:
```text
查看项目详情
查看小说原文
查看清洗文本
查看故事圣经
查看角色库
查看分集
查看分镜
查看素材
查看任务
手动重试
转人工审核
取消项目
导出素材
```
---
## 4. 小说源管理
操作:
```text
查看原始文件
查看解析文本
查看章节列表
重新解析
手动编辑章节
删除广告水印
标记文本异常
```
---
## 5. 角色库管理
操作:
```text
编辑角色设定
生成角色参考图
选择锚点图
锁定角色
查看角色跨集出场
查看角色记忆
重生角色图
```
---
## 6. 分镜管理
操作:
```text
查看镜头
编辑画面描述
编辑台词
编辑 Prompt
重生单镜头图片
替换图片
调整顺序
标记不合格
```
---
## 7. 剧情记忆管理
展示:
```text
主线
支线
伏笔
未解决冲突
已解决冲突
角色关系变化
重要道具状态
世界规则
```
操作:
```text
新增记忆
编辑记忆
标记已解决
关联分集
执行连续性检查
```
---
## 8. 任务管理
字段:
```text
task_id
project_id
episode_id
shot_id
task_type
provider
status
retry_count
cost
error_message
created_at
finished_at
```
操作:
```text
查看输入
查看输出
重试
取消
跳过
转人工
复制 Prompt
查看 Provider 日志
```
---
## 9. 内容审核
审核对象:
```text
小说文本
故事圣经
角色设定
分集脚本
分镜脚本
图片
视频
封面
标题
字幕
旁白
```
审核操作:
```text
通过
驳回
要求修改
屏蔽
转人工
```
---
## 10. 模板管理
```text
题材模板
画风模板
角色模板
场景模板
镜头模板
Prompt模板
视频模板
BGM模板
字幕样式
套餐模板
```
---
## 11. 数据反馈
用于后续优化:
```text
导入播放量
导入完播率
导入点赞评论
记录封面标题
记录题材表现
记录每集转化
```
后续可让系统根据数据优化新项目。
+182
View File
@@ -0,0 +1,182 @@
# 09_AI生成流水线_Provider抽象设计
## 1. Provider 类型
```text
TextProvider:故事、脚本、分镜、标题
NovelProvider:原创小说生成
ImageProvider:角色图、分镜图、封面图
VideoProvider:关键镜头图生视频
VoiceProviderTTS
ModerationProvider:内容审核
QualityCheckProvider:图片/视频质检
FileParseProvider:文件解析
EmbeddingProvider:长篇记忆检索
```
---
## 2. Provider 必备能力
```text
mock 实现
真实实现
fallback
限流
重试
成本记录
请求日志
失败日志
输入输出保存
```
开发阶段全部先用 mock,流程跑通后再接真实最高模型。
---
## 3. AI 原创小说流水线
```text
用户设定
→ 故事创意
→ 故事大纲
→ 故事圣经
→ 角色圣经
→ 章节大纲
→ 正文生成
→ 自检
→ 章节摘要
→ 改编准备
```
---
## 4. 上传小说流水线
```text
文件上传
→ 文本提取
→ 清洗
→ 章节识别
→ 章节摘要
→ 角色抽取
→ 场景抽取
→ 世界观抽取
→ 故事圣经
→ 改编准备
```
---
## 5. 改编流水线
```text
故事圣经
+ 角色圣经
+ 剧情记忆
+ 章节内容
→ 分集计划
→ 单集脚本
→ 分镜脚本
→ 镜头 Prompt
→ 图片生成
→ 质检
→ 配音
→ 字幕
→ 视频合成
```
---
## 6. 长篇记忆参与生成
生成第 N 集时输入:
```text
故事圣经
角色圣经
世界观规则
前 3 集摘要
当前相关章节摘要
未解决伏笔
角色当前状态
上一集结尾钩子
本集目标
```
避免每次把全文塞给模型。
---
## 7. Prompt 分层
```text
BaseStyle:画风
ProjectWorld:世界观
Character:角色
Scene:场景
Shot:镜头
Emotion:情绪
Camera:运镜
Effect:特效
Quality:质量
Negative:禁止项
```
---
## 8. 图片生成顺序
```text
角色立绘
→ 角色锚点图
→ 场景锚点图
→ 封面图
→ 分镜预览图
→ 正式分镜图
```
---
## 9. 视频生成顺序
```text
镜头图片
→ 图片质检
→ 分配时长
→ 生成字幕
→ 生成旁白
→ 选择BGM
→ FFmpeg运镜
→ 合成MP4
→ 最终质检
```
---
## 10. 质检 Provider
自动检查:
```text
角色一致性
画风一致性
人脸崩坏
手部异常
多余人物
文字乱码
敏感内容
分辨率
视频可播放
字幕是否溢出
音画是否同步
```
质检不通过:
```text
自动重试
转人工
降低镜头复杂度
替换模板
```
@@ -0,0 +1,182 @@
# 10_Prompt模板_题材世界观_韩漫规范
## 1. Prompt 总原则
Prompt 必须模板化、版本化、可审计。
禁止:
```text
每次自由拼接
把整章小说直接塞进图片 Prompt
角色描述不固定
画风描述每集变化
负面约束缺失
```
---
## 2. 标准 Prompt 结构
```text
[画风层]
[角色层]
[世界观层]
[场景层]
[镜头层]
[动作层]
[情绪层]
[光影层]
[质量层]
[负面约束层]
```
---
## 3. 韩漫风基础模板
```text
高质量韩漫风格,精致人物五官,干净线条,细腻光影,商业漫画质感,竖屏构图,人物表情清晰,背景细节完整,色彩统一,高级画面质感
```
负面:
```text
低质量,脸部崩坏,五官变形,手指异常,多余人物,文字乱码,风格漂移,过度欧美化,年龄变化,角色换脸,服装错误
```
---
## 4. 都市重生模板
世界关键词:
```text
现代都市
医院病房
豪门别墅
公司办公室
雨夜街头
冷色电影感
复仇感
命运重启
强烈冲突
```
常用镜头:
```text
病床惊醒
离婚协议特写
雨夜背影
办公室对峙
反派震惊
主角眼神变冷
```
---
## 5. 霸总甜宠模板
关键词:
```text
高级办公室
豪车
晚宴
西装
礼服
落地窗
城市夜景
浪漫光影
强烈对视
情绪拉扯
```
---
## 6. 真假千金模板
关键词:
```text
豪门客厅
亲子鉴定报告
晚宴
真假身份
众人震惊
被赶出家门
华丽逆袭
```
---
## 7. 修仙爽文模板
关键词:
```text
仙山云海
宗门大殿
剑光
灵气
法阵
古风长袍
金色光效
史诗氛围
强者归来
```
---
## 8. 镜头模板
### 8.1 开局强冲突
```text
主角处于画面中心,周围人露出嘲讽或震惊表情,强烈压迫感构图,背景暗色,韩漫风,竖屏
```
### 8.2 反派震惊
```text
反派面部特写,眼睛睁大,表情震惊,背景速度线,漫画冲击效果,强烈情绪张力
```
### 8.3 主角觉醒
```text
主角眼神冷静坚定,身后光芒爆发,衣摆微动,低角度构图,强烈逆袭感,韩漫风
```
### 8.4 结尾钩子
```text
神秘人物站在阴影中,只露出半张脸,手中拿着关键物品,氛围悬疑,画面留白,适合下一集悬念
```
---
## 9. 角色固定片段
每个角色 Prompt 必须带:
```text
固定年龄段
固定脸型
固定发型
固定气质
固定身份
固定服装范围
禁止改变发色
禁止改变年龄
禁止变成其他角色
```
---
## 10. 分镜 Prompt 示例
```text
高质量韩漫风,现代都市医院病房,年轻男主从病床猛然坐起,额头冒汗,眼神震惊,短黑发,病号服,窗外雨夜,冷色电影光影,近景构图,强烈重生感,人物五官精致,背景清晰,竖屏9:16
```
+205
View File
@@ -0,0 +1,205 @@
# 11_角色一致性专项设计
## 1. 为什么必须专项设计
系统 A 最大质量风险是角色不一致:
```text
第一集男主短黑发
第二集变棕发
第三集脸型变了
女主和女配混脸
反派年龄漂移
同一角色服装无规则变化
```
所以角色一致性必须作为核心模块,而不是 Prompt 里的几句话。
---
## 2. 角色生产流程
```text
角色提取
→ 角色资料生成
→ 人工/自动确认角色
→ 角色立绘生成
→ 多张候选图
→ 选择锚点图
→ 生成表情图
→ 生成服装规则
→ 锁定角色
→ 分镜图引用角色锚点
```
---
## 3. 角色圣经字段
```text
姓名
别名
角色定位
性别
年龄段
身份
脸型
发型
眼睛
气质
身材
常用服装
特殊道具
说话风格
人物关系
情绪基调
人物弧光
禁止变化项
参考图
锚点图
出场集数
当前状态
```
---
## 4. 角色图类型
```text
front_reference:正面立绘
side_reference:侧脸
expression_pack:表情包
costume_default:默认服装
costume_special:特殊服装
anchor:锚点图
scene_variant:场景变体
```
---
## 5. 锚点图规则
主角必须有锚点图。
建议数量:
```text
男主:1-3 张锚点
女主:1-3 张锚点
反派:1 张锚点
重要配角:1 张锚点
普通配角:可选
```
锚点图需要人工确认或后台审核。
---
## 6. 角色锁定机制
角色确认后进入 locked 状态。
locked 后:
```text
不能随意改姓名
不能改年龄段
不能改核心外貌
不能改身份
可以新增服装变体
可以新增表情图
可以根据剧情更新状态
```
---
## 7. 跨集角色状态
角色状态随剧情变化,但要记录:
```text
当前服装
是否受伤
情绪状态
关系状态
是否隐藏身份
是否觉醒能力
持有什么道具
```
例如:
```text
第5集男主被打伤,第6集脸上应有轻微伤痕。
第8集女主知道真相,第9集对男主态度变化。
```
---
## 8. 防混脸策略
系统生成分镜时必须传入:
```text
本镜头出现角色列表
每个角色固定描述
每个角色锚点图
角色之间差异化描述
禁止角色混合
```
多角色镜头尽量控制在 2-3 人,避免一次生成太多人。
---
## 9. 角色一致性质检
自动检查:
```text
脸型是否明显变化
发型是否明显变化
年龄是否漂移
服装是否不符合规则
男女是否混脸
角色是否缺失
多出不相关人物
```
不合格处理:
```text
自动重生
降低镜头复杂度
拆成多个镜头
转人工
```
---
## 10. 长篇角色成长
角色不是永远不变,而是有受控变化。
允许变化:
```text
服装
表情
情绪
轻微伤痕
身份暴露后的气质
修仙升级后的气场
```
禁止变化:
```text
脸型大变
年龄大变
发色无原因变化
身份无原因变化
人物关系无记录变化
```
所有允许变化都要记录到 `character_memories`
@@ -0,0 +1,231 @@
# 12_长篇连载记忆_剧情一致性专项设计
## 1. 为什么必须设计长篇记忆
系统 A 如果只做 3 集,简单摘要够用。
如果要做 20-100 集,必须有长篇记忆,否则会出现:
```text
角色名字变了
人物关系忘了
伏笔丢了
反派计划断了
前面发生的事后面不承认
道具状态错乱
世界规则前后矛盾
```
---
## 2. 长篇记忆核心对象
```text
StoryBible:全局故事规则
WorldBible:世界规则
CharacterBible:角色固定资料
CharacterMemory:角色当前状态
EpisodeSummary:每集摘要
PlotMemory:关键事件
PlotThread:剧情线
ContinuityCheck:连续性检查
```
---
## 3. 每集生成前必须输入
生成第 N 集时,模型输入不应是全文,而是:
```text
故事圣经
世界观规则
主要角色圣经
当前相关角色状态
前 3 集摘要
第 N-1 集结尾
当前章节摘要
未解决剧情线
需要推进的伏笔
本集目标
本集禁用事项
```
---
## 4. 每集生成后必须沉淀
每集完成后生成:
```text
本集摘要
新增事件
角色关系变化
新增伏笔
解决的伏笔
未解决冲突
重要道具状态
下一集衔接点
人物状态变化
```
写入:
```text
plot_memories
plot_threads
character_memories
episodes.summary
```
---
## 5. PlotThread 剧情线
剧情线类型:
```text
main_plot:主线
romance:感情线
revenge:复仇线
mystery:悬疑线
villain_plan:反派计划
character_growth:人物成长
world_secret:世界秘密
```
每条线记录:
```text
起始集
目标
当前进度
关联角色
预计解决集
实际解决集
状态
```
状态:
```text
open
progressing
paused
resolved
abandoned
```
---
## 6. 伏笔管理
伏笔必须记录:
```text
伏笔内容
出现集数
关联角色
预计回收集数
是否已回收
回收方式
```
示例:
```text
第2集出现神秘玉佩
第8集揭示玉佩是女主母亲留下的线索
第15集成为打开密室的钥匙
```
---
## 7. 连续性检查
每集脚本生成后执行检查:
```text
角色名字一致
人物关系一致
时间线一致
道具状态一致
世界规则一致
伏笔没有冲突
上一集钩子被承接
本集结尾有新钩子
```
检查结果:
```text
pass
warning
fail
```
fail 必须重新生成或人工修改。
---
## 8. 长篇分批策略
20 集以内:
```text
整部故事大纲 + 每集摘要即可
```
20-100 集:
```text
分卷管理
每卷 10-20 集
每卷有阶段目标
每集有独立钩子
每 5 集有小高潮
每 10-20 集有大转折
```
---
## 9. 分卷设计
长篇项目需要:
```text
Volume 1:开局冲突和身份建立
Volume 2:主角第一次反击
Volume 3:反派升级
Volume 4:真相揭露
Volume 5:最终反击
```
每卷字段:
```text
卷标题
卷目标
主要冲突
核心角色
高潮集
结尾钩子
```
---
## 10. 长篇生成规则
禁止一次性生成 100 集完整脚本。
正确方式:
```text
先生成全局大纲
再生成分卷大纲
再生成 5 集批次计划
再生成单集脚本
再生成单集分镜
每集完成后更新记忆
```
这样能减少后期重构和剧情崩坏。
@@ -0,0 +1,216 @@
# 13_小说生成_上传解析_改编质量标准
## 1. AI 原创小说质量标准
原创小说必须满足:
```text
主线清晰
冲突明确
角色数量可控
场景可视化
每章有转折
每章有钩子
适合短视频改编
无明显逻辑断裂
无敏感违规内容
```
---
## 2. 原创小说生成阶段
```text
创意
→ 大纲
→ 故事圣经
→ 角色圣经
→ 分章大纲
→ 正文
→ 自检
```
不要直接从一句话生成完整长篇正文。
---
## 3. 上传小说解析标准
支持:
```text
txt
docx
md
pdf,第一阶段可限制为文本型 PDF
粘贴文本
```
清洗内容:
```text
广告
水印
页眉页脚
重复章节标题
乱码
多余空行
无关说明
```
---
## 4. 章节识别规则
识别:
```text
第1章
第一章
Chapter 1
001
楔子
序章
番外
正文
```
如果章节识别失败:
```text
按字数切分
提示用户手动确认
后台可编辑章节
```
---
## 5. 小说改编原则
小说原文常见问题:
```text
心理描写多
旁白多
动作少
场景不明确
对话太长
节奏慢
```
改编时必须转成:
```text
可视化画面
明确动作
短台词
强冲突
镜头切换
结尾钩子
```
---
## 6. 每集标准结构
45-60 秒:
```text
0-3 秒:强冲突
3-12 秒:交代处境
12-30 秒:矛盾升级
30-45 秒:主角行动
45-55 秒:反转
55-60 秒:悬念钩子
```
90 秒:
```text
0-5 秒:强钩子
5-25 秒:背景
25-55 秒:冲突
55-75 秒:反击
75-90 秒:新危机
```
---
## 7. 分镜质量标准
每个镜头必须有:
```text
一个画面中心
一个主要动作
一个情绪点
一段短台词或旁白
2-5 秒时长
明确人物
明确场景
明确构图
```
避免:
```text
一个镜头包含连续动作
一个镜头超过 4 个主要人物
抽象心理活动
无画面对象
场景模糊
台词太长
```
---
## 8. 不可视化内容改写
原文:
```text
他心里像被刀割一样。
```
改写:
```text
画面:男主站在雨中,望着女主离开的背影,拳头攥紧。
台词:你真的一点机会都不给我吗?
```
---
## 9. 改编保真度
上传小说改编需要平衡:
```text
保留核心剧情
保留人物关系
保留名场面
压缩旁白
加快节奏
增强冲突
减少不可视化内容
```
不能擅自改掉主线和人物关系。
---
## 10. 质量评分
每集生成后评分:
```text
开头钩子:0-10
冲突强度:0-10
视觉化程度:0-10
台词简洁度:0-10
结尾悬念:0-10
角色一致性:0-10
剧情连续性:0-10
```
低于阈值进入重生或人工调整。
+195
View File
@@ -0,0 +1,195 @@
# 14_分镜镜头_视频合成_特效设计
## 1. 漫剧视频形态
第一阶段视频采用:
```text
静态韩漫图片
+ FFmpeg 运镜
+ 字幕
+ AI 配音
+ BGM
+ 音效
+ 转场
= MP4 漫剧
```
这是最稳的商业 MVP 方案。
---
## 2. 镜头类型
```text
人物特写
双人对峙
远景环境
道具特写
回忆镜头
反派压迫
主角觉醒
群体震惊
结尾悬念
```
---
## 3. 运镜类型
```text
zoom_in:慢慢推近
zoom_out:慢慢拉远
pan_left:左移
pan_right:右移
shake:震屏
flash:闪白
fade:淡入淡出
cut:硬切
blur_memory:回忆模糊
```
---
## 4. 特效分级
### L1FFmpeg 基础特效
```text
推近
拉远
平移
震屏
闪白
黑场
字幕弹出
转场
```
低成本,第一阶段主力。
### L2:素材叠加特效
```text
花瓣
雨雪
火光
光粒子
速度线
红绸
雷电贴片
```
可用透明视频素材或后期叠加。
### L3AI 图生视频特效
```text
火焰动起来
雷电闪烁
衣摆飘动
头发飘动
角色转头
光效爆发
```
只用于关键镜头。
### L4:高级视频生成
```text
复杂打斗
镜头环绕
追车爆炸
多人动作
```
第一阶段不做常规能力,仅高端套餐后续考虑。
---
## 5. 推荐比例
```text
80% L1 静态图 + 运镜
15% L2 轻特效
5% L3 AI 图生视频爆点
```
不要第一版每个镜头都 AI 视频化。
---
## 6. 单集结构
60 秒示例:
```text
片头钩子:3 秒
剧情镜头:45 秒
反转镜头:7 秒
结尾钩子:5 秒
```
图片数量:
```text
10-20 张
每张 2-5 秒
```
---
## 7. 字幕规范
```text
竖屏底部安全区
每行不超过 14-18 个中文
避免遮挡人物脸
高对比描边
可选逐句字幕
后续支持逐字高亮
```
---
## 8. 音频规范
```text
旁白音量清晰
BGM 不盖过人声
关键反转加音效
震惊镜头加短促音效
结尾钩子音乐停顿
```
---
## 9. 视频输出规格
```text
9:16 竖屏
1080x1920
MP4 H.264
AAC 音频
30fps
封面图
有字幕版
无字幕版,可选
```
---
## 10. 镜头复杂度控制
避免:
```text
一个镜头 5 人以上
同镜头同时打斗
人物大幅转身
复杂手部互动
大量文字招牌
```
复杂场景拆成多个镜头。
@@ -0,0 +1,146 @@
# 15_任务队列_错误重试_稳定性设计
## 1. 队列列表
```text
novel_queue
parse_queue
story_queue
character_queue
episode_queue
script_queue
storyboard_queue
image_queue
audio_queue
subtitle_queue
video_queue
qc_queue
review_queue
analytics_queue
```
---
## 2. 任务状态
```text
pending
running
success
failed
retrying
cancelled
manual_required
skipped
```
---
## 3. 幂等设计
幂等 key
```text
project_id + episode_id + shot_id + task_type + input_hash
```
重复提交时:
```text
已有成功结果 → 返回结果
任务运行中 → 返回任务状态
失败可重试 → 按规则重试
```
---
## 4. 重试规则
```text
文本任务:2 次
图片任务:3 次
视频合成:2 次
TTS2 次
质检:1 次
```
连续失败进入:
```text
manual_required
```
---
## 5. 失败处理
失败必须记录:
```text
错误码
错误信息
输入参数
Provider 响应
重试次数
是否扣额度
是否可恢复
```
---
## 6. 队列隔离
图片生成和视频合成不能共用队列,避免视频任务堵塞所有任务。
---
## 7. 并发限制
```text
每用户同时 1-2 个正式项目
每项目图片并发 3-5
每 Provider 独立限流
视频合成单独限流
```
---
## 8. 服务器重启恢复
系统启动后扫描:
```text
running 超时任务
retrying 超时任务
video_rendering 中断任务
```
处理:
```text
重新入队
标记失败
转人工
```
---
## 9. 成本安全
系统错误导致的重试不重复扣用户额度。
用户主动重生、主动大改,需要扣额度或重新计费。
---
## 10. 队列监控
后台显示:
```text
等待任务数
运行任务数
失败任务数
平均耗时
Provider 错误率
队列积压
```
+160
View File
@@ -0,0 +1,160 @@
# 16_订单支付_额度_成本控制设计
## 1. 为什么必须设计成本控制
系统 A 成本高于普通文本工具,因为每集需要:
```text
文本生成
角色图
分镜图
图片重试
TTS
字幕
BGM
视频合成
质检
存储
人工审核
```
如果使用最高模型,必须先设计额度和成本规则。
---
## 2. 套餐建议
### 试用版
```text
1 集
低清水印
少量图片
不可商用
```
### 标准短剧版
```text
3 集
每集 45-60 秒
每集 10-20 张图
正式 MP4
1 次小改
```
### 连载测试版
```text
10 集
批量生成
封面标题
人工审核
```
### 高端定制版
```text
20 集以上
角色精修
关键镜头动态
更多重试
人工审核
```
---
## 3. 额度消耗点
```text
原创小说生成
上传小说解析
故事圣经生成
角色图生成
分集计划
脚本生成
分镜生成
预览图
正式图
TTS
字幕
视频合成
AI视频镜头
```
---
## 4. 预览规则
建议:
```text
预览图低清水印
预览数量限制
正式生成前必须支付或冻结额度
```
---
## 5. 重试扣费规则
```text
系统失败重试:不扣用户额度
用户不满意主动重生:扣额度
人工判定质量失败重生:不扣或少扣
大改:重新计费
```
---
## 6. 成本日志
记录:
```text
task_id
project_id
episode_id
provider
model
input_size
output_size
cost_estimate
cost_actual
user_charge
created_at
```
---
## 7. 成本预警
后台必须有:
```text
单项目成本超限
单用户成本异常
Provider 日成本超限
失败重试率异常
视频任务成本异常
```
---
## 8. 最高模型策略
开发阶段:
```text
全部 mock
少量真实接口联调
限制额度
```
正式阶段:
```text
正式生成用最高模型
预览限制数量和分辨率
视频模型只用于关键镜头
```
+135
View File
@@ -0,0 +1,135 @@
# 17_版权授权_内容审核_合规设计
## 1. 上传小说版权确认
上传小说必须选择:
```text
我是作者本人
我已获得改编授权
这是公版作品
仅用于内部测试
```
必须勾选:
```text
我确认拥有该文本的合法使用权
我授权平台为本项目进行 AI 改编和生成
我理解未经授权不得用于商业发布
```
---
## 2. 版权记录
保存:
```text
项目ID
用户ID
授权类型
授权声明
IP
User-Agent
确认时间
```
---
## 3. AI 原创小说记录
AI 原创内容也要记录:
```text
用户输入
生成时间
模型
Prompt版本
项目ID
```
用于内容来源追踪。
---
## 4. 内容审核对象
```text
上传小说文本
AI 原创小说
故事圣经
角色圣经
分集脚本
分镜脚本
图片
封面
标题
配音文本
字幕
最终视频
```
---
## 5. 禁止内容
```text
违法内容
色情低俗
仇恨攻击
未成年人不当内容
未经授权名人冒用
政治人物冒充
侵犯版权
极端暴力血腥
平台规则敏感内容
```
---
## 6. 公版作品提醒
用户选择公版作品时提示:
```text
不同地区版权期限和改编权规则不同,用户需自行确认商业使用权。
```
---
## 7. 音乐版权
BGM 来源:
```text
平台授权音乐
可商用音乐库
用户自上传并承诺有权使用
```
每首音乐记录:
```text
来源
授权类型
使用范围
授权文件
```
---
## 8. 公开案例授权
默认不公开用户项目。
公开案例必须单独授权。
---
## 9. 商业发布提醒
下载成品时提示:
```text
请确认你拥有小说文本、音乐、图片和视频的商业发布权。
```
@@ -0,0 +1,127 @@
# 18_批量生产_运营发布_数据反馈设计
## 1. 批量生产不是第一阶段核心
第一阶段目标是 1 个项目生成 1-3 集。
但数据库和架构必须预留批量能力。
---
## 2. 批量生产流程
```text
选择小说项目
→ 批量生成分集计划
→ 每 5 集一批确认
→ 批量生成分镜
→ 角色一致性检查
→ 批量图片生成
→ 自动质检
→ 人工抽检
→ 批量视频合成
→ 导出发布包
```
---
## 3. 发布素材包
每集输出:
```text
MP4视频
封面图
标题候选
简介文案
话题标签
字幕文件
图片素材包
```
---
## 4. 标题封面生成
每集生成 3-5 个标题候选:
```text
震惊型
反转型
情绪型
悬念型
爽点型
```
封面图要求:
```text
主角清晰
冲突明显
文字少
情绪强
适合竖屏
```
---
## 5. 数据反馈
可记录平台数据:
```text
播放量
完播率
点赞率
评论数
收藏数
关注转化
用户催更评论
```
---
## 6. 数据反哺
后续系统可根据数据优化:
```text
题材选择
开头钩子
封面风格
标题风格
剧情节奏
单集时长
人物设定
```
---
## 7. A/B 测试
支持同一集生成:
```text
不同标题
不同封面
不同开头
不同视频节奏
```
记录数据后选择更优版本。
---
## 8. 自动发布
第一阶段暂缓自动发布。
后续可做:
```text
抖音
快手
小红书
视频号
B站
```
但平台接口和规则变化大,应单独设计。
+115
View File
@@ -0,0 +1,115 @@
# 19_部署运维_日志监控_备份设计
## 1. 目录结构
```text
ai-manga-system-a/
├── backend/
├── admin/
├── user-app/
├── workers/
├── deploy/
├── docs/
└── storage/
```
---
## 2. 环境变量
```text
DATABASE_URL
REDIS_URL
MINIO_ENDPOINT
MINIO_ACCESS_KEY
MINIO_SECRET_KEY
OPENAI_API_KEY
JWT_SECRET
FFMPEG_PATH
NODE_ENV
```
禁止把密钥写进代码。
---
## 3. 服务组成
```text
backend-api
queue-worker
ffmpeg-worker
admin-web
user-web
mysql
redis
minio
nginx
```
---
## 4. 日志类型
```text
API访问日志
用户操作日志
任务日志
AI调用日志
错误日志
支付日志
下载日志
审核日志
成本日志
```
---
## 5. 备份策略
```text
MySQL 每日备份
MinIO 重要素材备份
Prompt 模板备份
系统配置备份
授权记录重点备份
```
---
## 6. 清理策略
```text
草稿项目 30 天未操作可清理
失败临时文件 7 天清理
预览图 30 天清理
正式成品按套餐保存
日志按周期归档
```
---
## 7. 告警
```text
AI成本超阈值
任务失败率超阈值
视频合成失败
Redis队列积压
磁盘空间不足
数据库备份失败
Provider连续失败
```
---
## 8. 安全
```text
后台必须登录
管理员操作留日志
下载链接有有效期
原始小说私有存储
用户素材私有存储
公开案例单独授权
```
+153
View File
@@ -0,0 +1,153 @@
# 20_测试用例_验收标准
## 1. MVP 总体验收
必须跑通:
```text
AI 原创小说 → 3 集漫剧 MP4
上传小说 → 1 集漫剧 MP4
后台能查看任务和重试失败
用户能下载成品
```
---
## 2. 登录测试
```text
注册成功
登录成功
Token过期
未登录禁止创建项目
用户只能看自己的项目
```
---
## 3. AI 原创小说测试
```text
生成故事创意
生成大纲
生成故事圣经
生成角色圣经
生成章节
自检通过
```
---
## 4. 上传小说测试
```text
txt解析
docx解析
md解析
pdf文本型解析
乱码提示
章节识别
章节手动编辑
```
---
## 5. 版权测试
```text
未确认版权不能继续
确认后保存记录
后台可查授权记录
```
---
## 6. 角色一致性测试
```text
主角有锚点图
角色锁定后不能改核心设定
分镜图引用角色设定
角色跨集不明显变脸
```
---
## 7. 长篇记忆测试
```text
生成第5集时能引用前集摘要
伏笔能记录
人物关系变化能记录
连续性检查能发现冲突
```
---
## 8. 分集和分镜测试
```text
每集有开头钩子
每集有结尾悬念
每个镜头有画面描述
每个镜头有时长
每个镜头有 Prompt
复杂镜头能拆分
```
---
## 9. 图片生成测试
```text
角色图生成
分镜预览图生成
正式图生成
失败可重试
图片关联镜头
图片质检记录
```
---
## 10. 视频合成测试
```text
图片转视频
字幕正常
旁白正常
BGM正常
MP4可播放
封面正常
```
---
## 11. 后台测试
```text
项目列表
任务列表
任务重试
人工审核
角色管理
分镜管理
成本日志
模板管理
```
---
## 12. 验收标准
项目完成标准:
```text
一条 AI 原创链路完整可用
一条上传小说链路完整可用
任务失败可恢复
用户可下载成品
后台可管理项目
成本可统计
核心数据可追踪
```
+308
View File
@@ -0,0 +1,308 @@
# 21_Codex开发任务拆解文档
## 1. Codex 开发规则
```text
每次只完成一个任务
完成后等待人工审核
不得一次性开发整个系统
不得擅自删除 docs
不得把真实 API Key 写入代码
所有 AI Provider 先 mock
所有状态必须写入数据库
所有任务必须支持失败记录
```
---
## 2. 推荐项目结构
```text
ai-manga-system-a/
├── docs/
├── backend/
├── admin/
├── user-app/
├── workers/
├── deploy/
└── README.md
```
---
## 3. 任务 01:读取文档并输出计划
要求:
```text
只读 docs
不写代码
输出开发理解
输出 MVP 范围
输出目录结构
输出疑问
```
---
## 4. 任务 02:初始化项目骨架
```text
创建 monorepo
初始化 backend
初始化 admin
初始化 user-app
创建 workers
创建 deploy
创建 .env.example
```
---
## 5. 任务 03:数据库 schema
`05_数据库表结构设计.md` 创建表。
验收:
```text
迁移可执行
索引存在
基础表可写入
```
---
## 6. 任务 04:认证和用户
```text
注册
登录
JWT
用户信息
权限守卫
```
---
## 7. 任务 05:文件上传和资产
```text
MinIO
小说文件上传
图片/视频资产表
私有访问
```
---
## 8. 任务 06:项目创建流程
```text
创建项目
选择输入模式
选择题材
保存目标集数
状态流转
```
---
## 9. 任务 07:上传小说解析
```text
txt/docx/md解析
章节识别
文本清洗
章节保存
```
---
## 10. 任务 08AI 原创小说 Mock
```text
Mock 故事创意
Mock 大纲
Mock 章节
Mock 自检
```
---
## 11. 任务 09:故事圣经模块
```text
生成
编辑
确认
版本管理
```
---
## 12. 任务 10:角色圣经和锚点图
```text
角色提取
角色编辑
角色图生成任务
锚点图选择
角色锁定
```
---
## 13. 任务 11:长篇记忆模块
```text
plot_memories
plot_threads
character_memories
continuity_checks
```
---
## 14. 任务 12:分集计划
```text
生成分集
编辑分集
确认分集
```
---
## 15. 任务 13:脚本和分镜
```text
生成单集脚本
生成分镜
编辑镜头
Prompt生成
```
---
## 16. 任务 14BullMQ 队列
```text
任务创建
任务状态
重试
幂等key
失败记录
```
---
## 17. 任务 15AI Provider 抽象
```text
TextProvider
ImageProvider
VoiceProvider
VideoProvider
ModerationProvider
Mock实现
```
---
## 18. 任务 16:图片生成
```text
角色图
分镜预览图
正式图
质检记录
```
---
## 19. 任务 17TTS 字幕 FFmpeg
```text
生成旁白
生成SRT
图片转视频
字幕/BGM合成
导出MP4
```
---
## 20. 任务 18:后台管理
```text
项目管理
小说管理
角色管理
分镜管理
任务管理
审核管理
模板管理
成本日志
```
---
## 21. 任务 19uni-app 用户端
```text
首页
创建项目
AI原创设置
上传小说
版权确认
故事圣经
角色库
分集
分镜
进度
成品
```
---
## 22. 任务 20:订单额度
```text
套餐
订单
额度冻结
额度扣减
成本日志
```
---
## 23. 任务 21:内容审核
```text
版权确认
文本审核
图片审核
视频审核
公开案例授权
```
---
## 24. 任务 22:真实 AI Provider 接入
在所有 mock 流程跑通后再接入真实模型。
---
## 25. 任务 23MVP 验收
必须完成:
```text
AI原创小说生成3集MP4
上传小说生成1集MP4
后台可重试失败任务
用户可下载成品
```
@@ -0,0 +1,159 @@
# 22_系统A与系统B后续合并架构设计
## 1. 合并目标
系统 A 和系统 B 第一阶段分开开发,但后续应合并为:
```text
AI 内容影像生成平台
```
系统 A
```text
小说 / 文本故事 → 韩漫 / 漫剧
```
系统 B
```text
真人照片 → 写真 / 婚礼 / 纪念视频
```
---
## 2. 公共平台模块
```text
用户系统
权限系统
订单系统
额度系统
套餐系统
素材系统
AI Provider
任务队列
视频合成
内容审核
案例管理
成本统计
日志监控
部署运维
```
---
## 3. 系统 A 独有模块
```text
小说源
章节
故事圣经
世界观圣经
角色圣经
长篇记忆
分集计划
分镜脚本
连载管理
剧情数据反馈
```
---
## 4. 系统 B 独有模块
```text
真人照片
人像档案
人生主题
世界模板
场景模板
写真镜头
人像一致性
纪念视频模板
```
---
## 5. 后续统一数据模型
公共实体:
```text
User
Project
Asset
Task
Order
Quota
Provider
Review
Case
Analytics
```
系统 A Project type
```text
novel_manga
```
系统 B Project type
```text
portrait_video
```
---
## 6. Provider 共用
```text
TextProvider
ImageProvider
VideoProvider
VoiceProvider
ModerationProvider
QualityCheckProvider
```
系统 A 和 B 都不允许直接写死模型。
---
## 7. 视频合成共用
系统 A 和 B 都可以使用:
```text
图片排序
运镜
字幕
BGM
TTS
FFmpeg合成
封面生成
```
区别:
```text
系统 A 偏剧情分镜
系统 B 偏写真镜头和纪念视频
```
---
## 8. 合并顺序建议
```text
第一步:统一用户和订单
第二步:统一素材系统
第三步:统一 AI Provider
第四步:统一任务队列
第五步:统一视频合成
第六步:统一后台权限和日志
第七步:合并前台入口
```
不要一开始就强行写成一个复杂系统。
+134
View File
@@ -0,0 +1,134 @@
# 系统 A:原创小说 / 上传小说 → 韩漫 / 漫剧生成系统 V2 Production 文档包
## 1. 文档包定位
本包是系统 A 的 **生产级基础需求 + 工程落地文档**,用于替代上一版 `system_a_docs_v1.zip` 作为 Codex / 开发团队的开发基线。
上一版 V1 的定位:
```text
能跑通 MVP
能证明小说 → 漫剧链路可行
需求颗粒度不够细
长篇连载、角色一致性、批量稳定性不足
```
本版 V2 Production 的定位:
```text
作为系统 A 正式开发基线
覆盖原创小说、上传小说、授权小说改编
覆盖短篇 MVP、长篇连载、批量生成
覆盖角色一致性、剧情记忆、分镜质量、视频合成、成本控制、版权合规
为后续与系统 B 合并预留公共平台架构
```
---
## 2. 系统 A 一句话定位
> 系统 A 是一套把 AI 原创小说或已授权上传小说,自动改编成韩漫图集、短视频漫剧和连载剧集的 AI 内容工厂。
---
## 3. 第一阶段落地目标
第一阶段不要追求全自动 100 集。正式 MVP 目标是:
```text
AI 原创小说模式:
1 个小说项目
→ 生成故事圣经
→ 生成 3 个主要角色
→ 生成 3 集短漫剧
→ 每集 45-60 秒
→ 每集 10-20 张图
→ 自动配音、字幕、BGM
→ 自动合成 MP4
上传小说模式:
上传 1 篇已授权小说
→ 解析章节
→ 生成故事圣经
→ 提取角色
→ 生成 1-3 集漫剧
→ 下载 MP4
```
---
## 4. 后续生产级目标
```text
支持 20-100 集连载剧集
支持批量生成
支持角色跨集稳定
支持剧情长线记忆
支持人工审核和重试
支持高质量封面标题
支持不同题材 A/B 测试
支持多模型 Provider 替换
支持成本监控和额度管理
支持与系统 B 合并为统一 AI 影像平台
```
---
## 5. 本文档包清单
```text
00_上下文难点清单_已接入设计.md
01_系统A总需求文档_v2_生产级基线.md
02_业务流程_状态流转_权限设计.md
03_功能清单_页面清单.md
04_技术架构设计_模块拆分.md
05_数据库表结构设计.md
06_API接口设计文档.md
07_uniapp用户端页面交互文档.md
08_GeekerAdmin后台管理设计.md
09_AI生成流水线_Provider抽象设计.md
10_Prompt模板_题材世界观_韩漫规范.md
11_角色一致性专项设计.md
12_长篇连载记忆_剧情一致性专项设计.md
13_小说生成_上传解析_改编质量标准.md
14_分镜镜头_视频合成_特效设计.md
15_任务队列_错误重试_稳定性设计.md
16_订单支付_额度_成本控制设计.md
17_版权授权_内容审核_合规设计.md
18_批量生产_运营发布_数据反馈设计.md
19_部署运维_日志监控_备份设计.md
20_测试用例_验收标准.md
21_Codex开发任务拆解文档.md
22_系统A与系统B后续合并架构设计.md
文件行数统计.json
```
---
## 6. 使用规则
开发时以这些文档为主:
```text
01_系统A总需求文档_v2_生产级基线.md
02_业务流程_状态流转_权限设计.md
04_技术架构设计_模块拆分.md
05_数据库表结构设计.md
09_AI生成流水线_Provider抽象设计.md
11_角色一致性专项设计.md
12_长篇连载记忆_剧情一致性专项设计.md
14_分镜镜头_视频合成_特效设计.md
15_任务队列_错误重试_稳定性设计.md
21_Codex开发任务拆解文档.md
```
Codex 开发时禁止一口气做完整系统。必须按 `21_Codex开发任务拆解文档.md` 分阶段执行。
---
## 7. 旧版处理
```text
system_a_docs_v1.zip:只作为历史稿保存
system_a_docs_v2_production.zip:作为当前开发基线
```
+122
View File
@@ -0,0 +1,122 @@
[
{
"file": "00_上下文难点清单_已接入设计.md",
"lines": 97,
"chars": 1660
},
{
"file": "01_系统A总需求文档_v2_生产级基线.md",
"lines": 447,
"chars": 2962
},
{
"file": "02_业务流程_状态流转_权限设计.md",
"lines": 301,
"chars": 3188
},
{
"file": "03_功能清单_页面清单.md",
"lines": 364,
"chars": 1774
},
{
"file": "04_技术架构设计_模块拆分.md",
"lines": 202,
"chars": 2325
},
{
"file": "05_数据库表结构设计.md",
"lines": 490,
"chars": 6814
},
{
"file": "06_API接口设计文档.md",
"lines": 219,
"chars": 3712
},
{
"file": "07_uniapp用户端页面交互文档.md",
"lines": 175,
"chars": 1412
},
{
"file": "08_GeekerAdmin后台管理设计.md",
"lines": 250,
"chars": 1306
},
{
"file": "09_AI生成流水线_Provider抽象设计.md",
"lines": 183,
"chars": 1305
},
{
"file": "10_Prompt模板_题材世界观_韩漫规范.md",
"lines": 183,
"chars": 1295
},
{
"file": "11_角色一致性专项设计.md",
"lines": 206,
"chars": 1384
},
{
"file": "12_长篇连载记忆_剧情一致性专项设计.md",
"lines": 232,
"chars": 1661
},
{
"file": "13_小说生成_上传解析_改编质量标准.md",
"lines": 217,
"chars": 1280
},
{
"file": "14_分镜镜头_视频合成_特效设计.md",
"lines": 196,
"chars": 1188
},
{
"file": "15_任务队列_错误重试_稳定性设计.md",
"lines": 147,
"chars": 1085
},
{
"file": "16_订单支付_额度_成本控制设计.md",
"lines": 161,
"chars": 967
},
{
"file": "17_版权授权_内容审核_合规设计.md",
"lines": 136,
"chars": 801
},
{
"file": "18_批量生产_运营发布_数据反馈设计.md",
"lines": 128,
"chars": 710
},
{
"file": "19_部署运维_日志监控_备份设计.md",
"lines": 116,
"chars": 845
},
{
"file": "20_测试用例_验收标准.md",
"lines": 154,
"chars": 932
},
{
"file": "21_Codex开发任务拆解文档.md",
"lines": 309,
"chars": 2045
},
{
"file": "22_系统A与系统B后续合并架构设计.md",
"lines": 160,
"chars": 1064
},
{
"file": "README.md",
"lines": 135,
"chars": 1773
}
]