# 产品愿景与范围（单一事实源）

本文档定义「AI 影视制作平台」的终局叙事、已实现范围与非目标。**界面与叙事细节**还请同时阅读根目录 [DESIGN.md](../DESIGN.md)；**迭代顺序**请见 [ROADMAP.md](./ROADMAP.md)。

---

## 1. 愿景与定位

本产品面向 **影视前期可视化** 与 **AI 短片/分镜视频生产**：从剧本结构化到「演员—地点—分镜」实体，再到基于参考图的短片镜头生成。

**我们是什么**

- 剧本 → 章节/实体池 → 分镜表 → 文生参考图 → 图生视频的 **连贯工作流**，强调 **可复现、可修订**。
- **工业化辅助**：帮助团队在实拍/动画前对齐「长得像谁、穿什么、在什么地方」的可视草稿。

**我们不是什么**

- **不是** 替代长篇院线实拍或全流程 DCC 离线渲染的端到端替代品。
- **不是** 「漫画创作的唯一终点」——产品语义以 **动起来、可当片用** 的影像为准；静态条漫可走同一套定妆与风格锁，但并非主叙事核心。

边界上的诚实表述：当前链路以 **单张（或少量）角色参考图 + 文案描述** 驱动图生视频，对 **超长镜头走位、布景毫米级复原、法务级道具纹样一致** 等能力受模型上限约束——见下文「North Star」与「非目标」。

---

## 2. 用户与典型场景（分级）

| 层级 | 用户 | 典型诉求 |
|------|------|----------|
| A | 业余创作者 / 试水者 | 快速出片、能接受一定画风漂移 |
| B | 小团队前期 / Storyboard Artist | 多角色、多场次，需要 **风格与子实体可锁** |
| C | 商业短片 / 宣传片 | **造型版本、道具、环境气氛**一致，有可审流程 |

路线图按 **Phase 1→5** 逐步从 A 向 B/C 补强；MVP（已完成）已覆盖 A 与部分 B。

---

## 3. MVP 已完成范围（与当前实现对齐）

以下能力在当前仓库主线中已实现，可作为「基线契约」：

- **项目**：创建、脚本文本、SQLite 持久化。
- **章节**：`Script` 多章节、解析任务 `ParseTask`、预览与导入落库（[`parse_task.import_parse_result`](../backend/app/services/parse_task.py)）。
- **实体池**：`Character`、`Location`，含 `image_prompt`、定妆图上传/生成；[`GET /projects/{id}/cast`](../backend/app/routers/projects.py) 等。
- **分镜**：`Scene`（专业分镜模式），演员多选、`character_id` 与参考视频主角对齐、地点外键；[`storyboard.html`](../frontend/storyboard.html)。
- **视频**：默认 **万相 2.7**（`input.media`/I2V 主路径，`BAILIAN_VIDEO_BACKEND=wan27`；可退回 `wan26`）、本地 `/api/videos`、[`generate_video`](../backend/app/routers/projects.py)；镜间衔接依赖公网可访问的参考/成片 URL（`BAILIAN_VIDEO_REF_PUBLIC_BASE_URL`）。分镜支持手填首尾帧/clip/自备成片、QC 状态等。
- **其它**：拼接相关 API、简易模式 [`index.html`](../frontend/index.html)。

若 README 与本节冲突，**以本节 + 代码为准**，README 应保持链接回本文。

---

## 4. 终局能力模型（North Star）

同一 **项目** 在以下维度上具备 **审定、锁定、可追溯**：

1. **视觉一致性（画风 / 写实度）**
   - 项目级 **风格锁**：例如写实电影剧照 vs 卡通 / 插画，通过 **全局提示前缀 + 负面词模板** + 可选预设，让所有角色与环境文生图处于同一渲染路径语义，避免「同剧有人像真人、有人像二次元」的无控漂移。
2. **时间与造型版本（Look Variant）**
   - 同一 logical **Character** 可有多套 **Look**（年代、年龄外貌、衣着），每条分镜可选 **本镜所用的 Look**，图生视频的参考图与提示词与该 Look 对齐。
3. **道具一致性**
   - **Prop（道具）实体池**：名称、描述、参考图（可选）；分镜级引用；解析或手工维护；生成链路中能进入 prompt 或（在模型允许的范围内）补充参考——见 ROADMAP 对多参考限制的说明。
4. **环境与叙事连续性（相对现实）**
   - **地点**不只一张「装饰画」：**多视角 mood plate / 关键陈设** 可选用；分镜与地点绑定清晰；对用户声明 **单帧环境图 + 文案** 在长镜头复杂调度上的局限性，进阶能力分阶段解锁。

North Star **一句话**：  
**画风、造型版本、关键道具与环境气氛在项目内可审定、可复现，支撑从剧本到分镜视频的连贯 AI 制片流程。**

### 4.1 商业化 Phase 1：默认模型与「可上映」表述

- **默认视频链路**：万相 **2.7**（图生视频为主；复杂多参考可走 2.7 R2V，见 `docs/阿里百炼/wan/`）。**LLM / 文生图** 仍走百炼 Qwen 与 Wanx，由 `BAILIAN_LLM_MODEL`、`BAILIAN_T2I_MODEL` 等配置。
- **存储与衔接前提**：百炼拉取素材要求 **HTTPS（或 OSS 临时链）**；镜间 `first_clip`/尾帧续写需部署侧保证 **成片与 assets 的公网根**（`.env` 中 `BAILIAN_VIDEO_REF_PUBLIC_BASE_URL`），否则衔接链无法稳定启用。
- **对外若使用「可上映」**，建议拆成两层，避免法务与交付风险：
  - **技术成片**：分辨率、片长、宽高比、字幕轨、导出母带等由平台与后期工具链承接的范围。
  - **发行合规**：龙标、备案、权利人审查等 **不作为「换视频模型」能解决的问题**，须单列 **人工 QC / 法务**；产品内以分镜 **QC 状态** 等字段支持可追溯审阅（硬门禁导出可分期迭代）。

---

## 5. 非目标（Non-goals）（当前阶段不写进承诺）

以下内容 **不在现阶段产品承诺之内**，除非你方单独立项：

- **替代院线长片全流程**（DIT、离线调色台、片场实时合成等）。
- **无人工审核的全自动法务合规**（肖像权、Logo、军火等）。
- **超越参考图类视频模型的物理学与多人精准交互**——以业界模型迭代为准渐进增强。
- **纯漫画条漫排版工具**作为主卖点（可与短片工具共享实体与风格锁，但不是终局主轴）。

---

## 6. 成功指标（定性验收，Phase 收口用）

每项在对应 ROADMAP Phase 收尾时自检即可（不必一上来自动化）。

- **一致性**
  - 同一项目批量生成定妆后，目视画风是否可归为单一「渲染路径」（真人/插画等不混）。
  - 抽查 5 组分镜：**分镜头像/参考与演员池中同一 ID 的演员图**一致。
- **可审流程**
  - 用户能理解「谁先锁风格、谁先定妆、再审分镜」，关键操作有不可逆或版本提示。
  - 关键分镜具备 **QC 状态**（草稿/待审/通过）与 **人工覆盖素材**（自备成片、手填首尾帧或 clip）的入口，可追溯。
- **诚实边界**
  - 产品上对「单靠一张环境图不能保证长镜头布景一致」有可见说明或帮助文案。

---

## 7. 相关文档

- [ROADMAP.md](./ROADMAP.md) — 分阶段开发与验收顺序  
- [DESIGN.md](../DESIGN.md) — 界面与 UX 设计语言  
- [README.md](../README.md) — 快速开始与技术栈摘要  

---

*文档版本：与 post-MVP 规划基线同步；功能性变更时请同步更新本节「MVP 已完成」或在新 Phase 条目于 ROADMAP 中勾选。*