小说改写剧本工具 - 产品需求文档 (PRD)

版本：v1.0
日期：2026-03-28
状态：已批准

1. 产品概述

1.1 产品定位

将短篇小说（1-2 万字）自动改写为短剧剧本，输出旁白为主（60%）+ 对白（40%）+ 分镜描述 + AI 绘画关键词，最终生成 40-50 分钟动漫素材。

1.2 目标用户

• 动漫制作团队
• 短剧内容创作者
• 小说 IP 改编方

1.3 核心价值

2. 功能需求

2.1 核心功能矩阵

2.2 功能详细设计

2.2.1 项目管理

输入：

• 小说文件（txt/md/docx）
• 项目名称
• 可选参数（目标时长/旁白比例等）

处理：

• 文件存储到本地 data/storage/projects/{id}/
• MySQL 记录元数据
• 自动统计字数

输出：

• 项目 ID
• 原文预览

2.2.2 剧情分析

输入：小说原文

处理：

1. 提取核心情节链（起承转合）
2. AI 识别爆点位置
3. 生成爆点前移方案

爆点类型：

输出：

{
  "plot_chain": ["起因", "发展", "转折", "高潮", "结局"],
  "plot_points": [
    {"type": "hook", "position": 150, "target_time": 10},
    {"type": "twist", "position": 3200, "target_time": 180}
  ],
  "hook_collection": "背叛、复仇、真相——他没想到，一切都是一场局"
}

调试模式：

• 可查看情节链详情
• 可手动调整爆点位置
• 可重新执行分析

2.2.3 角色提取

输入：小说原文

处理：

1. NER 识别角色名
2. 分析角色行为/对话提取性格
3. 分析角色关系
4. 提取口头禅/习惯用语
5. 生成 AI 绘画提示词

输出：

{
  "characters": [
    {
      "name": "林萧",
      "personality": "冷硬、内敛、重情义",
      "relationship": {"苏晴": "前女友", "陈峰": "宿敌"},
      "catchphrase": "无所谓",
      "image_prompt": "young man, black hair, cold expression, dark coat, cinematic lighting, anime style",
      "style_profile": {"tone": "简短", "emotion": "克制", "vocabulary": "口语化"}
    }
  ]
}

调试模式：

• 可查看每个角色的详细信息
• 可手动编辑角色档案
• 可重新生成 AI 提示词

2.2.4 剧本改写

输入：小说原文 + 剧情分析结果 + 角色档案

处理：

1. 文学描写 → 旁白解说
2. 场景描写 → 分镜描述 + AI 绘画关键词
3. 对话 → 口语化优化
4. 节奏控制（紧凑快速）
5. 爆点前移

输出格式：

## 场景 1：雨夜相遇

【分镜描述】
镜头：中景→特写，推镜
画面：雨夜街道，霓虹灯闪烁，女主撑伞站立
AI 关键词：rainy night, neon street, young woman, umbrella, cinematic lighting, anime style

【旁白】(60%)
"那场雨下了一整夜，也冲走了他最后的退路。"

【对白】(40%)
林萧："你不该来这里"（声音沙哑，点烟）
苏晴："但你还是来了"（转身，眼神复杂）

【角色检查】
✓ 林萧台词符合"冷硬"风格
✓ 苏晴台词符合"外柔内刚"设定

调试模式：

• 可逐段查看改写结果
• 可手动修改后继续
• 可重新执行改写

2.2.5 多模型对比

输入：小说原文 + 改写配置

处理：

1. 并行调用多个模型（Gemini/GPT/其他）
2. 收集各模型输出
3. 生成对比视图

输出：

• 并排展示不同模型输出
• 标记差异部分
• 支持手动选择/混合

对比维度：

2.2.6 版本管理（Gitea 集成）

输入：剧本草稿

处理：

1. 在 Gitea 创建分支（project-{id}-version-{n}）
2. 提交剧本内容
3. 记录版本元数据到 MySQL

输出：

• 分支名
• 提交哈希
• 版本对比链接

Git 操作：

2.2.7 调试模式

设计原则：

• 每步可暂停查看
• 中间结果可修改
• 支持从任意步骤重新开始

调试流程：

1. 上传小说 → [暂停] 确认原文
         ↓
2. 剧情分析 → [查看] 情节链/爆点位置
         ↓
3. 角色提取 → [查看/编辑] 角色档案
         ↓
4. 剧本改写 → [查看] 中间结果
         ↓
5. 输出版本 → [对比/评分]

调试界面：

• 左侧：步骤导航
• 中间：当前步骤输出
• 右侧：操作按钮（继续/修改/重做）

2.2.8 质量评估

自动评分：

人工评分：

• 1-5 星打分
• 可选标签（节奏好/角色鲜明/画面感强等）
• 文字评语

评分历史：

• 记录每次评分
• 生成质量趋势图
• 反馈优化模型

2.3 模型配置

支持接口：OpenAI 兼容格式

配置项：

操作：

• 添加模型
• 编辑模型
• 删除模型
• 测试连接

3. 技术架构

3.1 技术栈

3.2 系统架构

┌─────────────────────────────────────────────────────────────────┐
│                        Docker Compose                           │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│ │   Vue 前端   │  │  FastAPI    │  │   MySQL     │            │
│ │   :8080     │  │   :8000     │  │   :3306     │            │
│ └─────────────┘  └─────────────┘  └─────────────┘            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│ │   Gitea     │  │   Redis     │  │  MinIO      │            │
│ │   :3000     │  │   :6379     │  │  :9000      │            │
│ │  (版本管理)  │  │   (缓存)    │  │ (可选)      │            │
│ └─────────────┘  └─────────────┘  └─────────────┘            │
└─────────────────────────────────────────────────────────────────┘
                              ↓
                    ┌─────────────────┐
                    │  外部模型 API    │
                    │  - Gemini       │
                    │  - GPT          │
                    │  - 其他兼容接口  │
                    └─────────────────┘

3.3 数据库设计

项目表 (projects)

角色表 (characters)

版本表 (versions)

模型配置表 (model_configs)

爆点标记表 (plot_points)

3.4 API 设计

# 项目管理
POST   /api/projects                    # 创建项目
GET    /api/projects                    # 项目列表
GET    /api/projects/{id}               # 项目详情
DELETE /api/projects/{id}               # 删除项目
PUT    /api/projects/{id}               # 更新项目

# 剧情分析
POST   /api/projects/{id}/analyze       # 执行分析
GET    /api/projects/{id}/analysis      # 查看分析结果
PUT    /api/projects/{id}/analysis      # 修改分析结果

# 角色管理
POST   /api/projects/{id}/extract       # 提取角色
GET    /api/projects/{id}/characters    # 角色列表
PUT    /api/characters/{id}             # 更新角色

# 剧本改写
POST   /api/projects/{id}/rewrite       # 执行改写
GET    /api/projects/{id}/draft         # 查看草稿
PUT    /api/projects/{id}/draft         # 修改草稿

# 版本管理
POST   /api/projects/{id}/versions      # 创建版本
GET    /api/projects/{id}/versions      # 版本列表
GET    /api/compare                     # 版本对比
POST   /api/projects/{id}/merge         # 版本合并

# 模型管理
GET    /api/models                      # 模型列表
POST   /api/models                      # 添加模型
PUT    /api/models/{id}                 # 更新模型
DELETE /api/models/{id}                 # 删除模型
POST   /api/models/{id}/test            # 测试连接

# 质量评估
POST   /api/quality/auto-score          # 自动评分
POST   /api/quality/manual-score        # 人工评分
GET    /api/projects/{id}/scores        # 评分历史

4. 数据流

用户上传小说
    ↓
本地存储 (data/storage/projects/{id}/original.txt)
    ↓
MySQL 记录元数据 (projects 表)
    ↓
剧情分析 → 中间结果 (temp/) → 调试查看
    ↓
角色提取 → 中间结果 (temp/) → 调试查看
    ↓
剧本改写 → 草稿 (temp/) → 调试查看
    ↓
确认输出 → 推送到 Gitea → MySQL 记录版本
    ↓
多模型对比 → 选择最佳版本
    ↓
质量评分 → 反馈优化

5. 目录结构

~/novel-rewriter/
├── docker-compose.yml
├── .env                    # 环境变量
├── backend/
│   ├── app/
│   │   ├── main.py        # FastAPI 入口
│   │   ├── config.py      # 配置
│   │   ├── database.py    # 数据库连接
│   │   ├── models/        # SQLAlchemy 模型
│   │   ├── schemas/       # Pydantic schema
│   │   ├── api/           # API 路由
│   │   ├── services/      # 业务逻辑
│   │   └── utils/
│   ├── requirements.txt
│   └── Dockerfile
├── frontend/
│   ├── src/
│   │   ├── views/
│   │   ├── components/
│   │   └── api/
│   ├── package.json
│   └── Dockerfile
├── data/
│   ├── mysql/             # MySQL 数据
│   ├── gitea/             # Gitea 数据
│   ├── redis/             # Redis 数据
│   └── storage/           # 本地文件存储
│       ├── projects/
│       ├── versions/
│       └── temp/
└── scripts/
    ├── init-db.sql
    └── deploy.sh

6. 实现计划

Phase 1: 基础框架（第 1 周）

Phase 2: 核心功能（第 2-3 周）

Phase 3: 对比与评估（第 4 周）

Phase 4: 优化（第 5 周+）

7. 验收标准

7.1 功能验收

7.2 性能验收

7.3 质量验收

8. 风险与应对

9. 附录

9.1 术语表

9.2 参考文档

• FastAPI 官方文档
• Vue 3 官方文档
• Element Plus 文档
• Gitea API 文档

修订历史

文档状态: ✅ 已批准 - 可以开始开发