漫剧工作台标准文档

来源：oceanway-drama 仓库 docs/standard/manju-workbench-standard.md，提交 45524ef。2026-10-01 迁入并补充新架构的职责映射；产品行为保持标准 1.7.0 的范围，不表示原型已经迁入 Next.js。旧实现及来源原文用于追溯，不恢复 Core 或 Contracts 依赖。

标准版本：1.7.0

生效日期：2026-09-21

业务契约：0.4.0 公司依据：AI 漫剧工作台

1. 文档定位

本文件定义现行产品行为、领域模型、平台能力边界与 UI 原则。 实现结构见架构，接入协议见技术接入， 完成情况见验收状态。需求编号表示规则，测试证据表示已验证范围。

2. 产品目标

让创作者以简单、舒适的操作完成从剧本到视频段素材的生产：

项目与剧本 → 分集与正文 → 本集生产准备 → 分镜草稿 → 视频段组合 → 视频生成与选择 → 下载。

最终顺序、转场、字幕、配音和成片制作由外部剪辑工具完成。 工作台保存创作内容、资产关联、生成输入、任务、候选和用户选择，使每份素材可追溯。

3. 领域模型

原始上传和原始模型结果不可变；用户编辑当前工作稿。 删除立即作用于工作稿，历史修订保留。下游媒体继续存在，相关对象记录来源影响。 来源变化按实际引用范围处理，其他有效内容可继续工作。

资产身份、别名、变体与单集关联分别维护。移除单集关联保留共享资产。 缺少图片是相关素材的状态提示，用户仍可编辑正文和整理资产范围。

4. 自由文档

创作长正文采用完整文档和一行工具栏：保存、撤销/重做、正文/标题、加粗、 斜体、下划线、列表、表格和更多。更多操作包含查找替换、对齐和清除格式； 表格支持行列及单元格编辑。短名称、时长和参数使用普通控件。 连续剧本共用一条顶部固定编辑工具栏，位于剧集导航下方。点击正文或切集时， 工具栏操作对应集的选区和撤销记录；原文对照时工具栏仍位于滚动正文上方。 “对照原文”在同一位置切换为“取消对照”。剧集导航定位对应正文标题， 高亮跟随当前阅读集；刷新在正文加载完成后恢复阅读位置。

正文支持纯文本、Markdown、标题、列表、表格和自定义段落。 模型文本与顺序完整保留，镜头识别只是辅助索引。 脚本内容作为文字处理；文档结构经过规范化与校验。 当前稿可以清空并保存，刷新仍恢复当前空稿。

生产准备与剧本页编辑同一份单集正文。保存即可进入后续页面或生成。 自动保存与主动保存共用服务命令，Ctrl+S 可保存；保存后保留撤销记录， 刷新后的版本恢复使用历史入口。中文组词期间保留输入，组词结束后再提交。 失败、冲突、撤权或未知回执保留本地输入，只有确认的服务回执才能显示“已保存”。

5. 分镜与视频

分镜生成

用户通过预设或自写的“分镜生成提示词”生成正文。首次成功直接进入可编辑文档。 已有正文时，重新生成先确认替换；成功形成新修订，失败保留当前正文。 生成期间发生编辑时，迟到结果单独保留，由用户决定是否替换。 原始结果、当前文档和历史修订各有明确身份。

大纲定位正文真实节点，重复选择仍可跳转。原文对照在原按钮位置返回， 双栏可见时按阅读进度联动；小屏使用标签切换。自由正文的比例联动表示阅读位置， 精确引用仍由版本化范围和内容指纹确定。

视频段组合

用户在视频段页选择分镜并组合，正文修改在分镜页完成。 临时勾选即时反馈，组合操作保持可见；成功后可直接进入制作。 智能分组提供本地规则建议和应用预览，逐项保存，部分成功保留，未知结果可恢复。 视频段条目提供制作、删除和恢复入口，相关任务和媒体保留。

视频描述与生成

创建视频段时，从所选分镜实际正文形成可编辑画面描述，保留必要资产信息。 手改描述与来源分开保存。来源更新后，自动描述可同步，手改描述由用户决定同步或保留。 服务保存完整文档范围；分镜组合界面使用镜头辅助索引选择内容。

生成自动固定实际使用的文档修订、范围、描述、资产、提示词与参数。 完整文档指纹和模型实际输入指纹分别管理，纯样式调整按实际输入语义判断影响。 历史任务、快照和视频候选保持原有指纹。

视频结果用缩略图展示。预览与正式选择是独立操作，正式候选由用户决定。 历史设置只读查看，明确复用后建立当前设置的新修订。 视频内嵌音频随媒体保留，播放、单段下载和素材清单导出使用授权媒体入口。

6. AI 助手与选区

创作页提供可收起助手，桌面首次收起，后续记住开关和右侧入口的竖向位置。 入口支持拖动与键盘；小屏使用抽屉和带文字的按钮。 UI 偏好独立于项目、文档和会话保存。上下文以项目、集数、页面和工作稿版本呈现。

同一选区仅有一个上方单行工具条。生产准备按权限显示“添加为资产”和 “添加到对话”，其他页面显示适用动作。选择添加到对话后，就近输入意见； 点击勾确认才建立批注、加入待发送引用并展开助手。蓝色标志支持重新编辑和取消。

批注保存稳定 ID、精确引用、文档范围、来源修订、意见和时间。 文档事务维护锚点；位置无法可靠恢复时保留脱离状态和原引用。 对话、纵向引用和输入区组成单层助手。跨页保留草稿，失败保留原请求身份和上下文。

当前聊天由显式会话适配器提供，未配置时输入与引用可以保存，发送不可用。 模型内容修改属于待接入能力：建议须先比较，再由用户显式应用， 并通过与人工编辑相同的权限、版本和修订检查。视频选择与导出始终属于用户操作。

7. 可靠提交与权限

• 每次提交固定请求身份、预期修订和完整输入；未知结果通过原回执查询或精确重放恢复。
• 重复请求复用回执，真正重新执行建立新 Attempt。部分成功和迟到结果都有明确归属。
• 精确重试后发现远端新修订时，保留本地输入并呈现冲突，用户决定后续保存。
• 权限在命令和结果登记时重新校验；媒体完整性与实际来源在相应操作校验。
• 错误提供可执行中文提示，并保留错误码、请求 ID、重试能力、冲突和字段信息。
• 持久化修订、命令回执和历史指纹按其原格式读取，格式升级由明确兼容逻辑处理。

8. 平台与产品工程能力边界

原型中的“平台接入方”不再等同于一个集中持有全部业务的 Core。详细映射见技术接入和共用任务与媒体。

普通视频生产可独立运行。Canvas 按已配置能力显示入口，返回后再次检查权限、 来源和媒体。File 与本地测试 Provider 构成本地参考实现，界面明确标记测试媒体。 生产服务接入通过现有适配端口完成。

9. UI 与交互规范

• 保持明亮、克制、连续文档式布局和现有导航；只展示当前任务需要的信息。
• 每个操作区域一个高强调主动作，错误与来源提示放在对应操作附近。
• 保存状态只显示一次，历史通过轻量入口访问，密集设置渐进展开。
• 工具栏吸顶贴合实际滚动视口上沿，对照和弹窗同样适用。
• 助手使用单层边界、页头和输入区分隔；小屏内容和底部操作保持可达。
• 图标操作提供名称、清晰焦点和适当点击区域：桌面至少 40px，触屏至少 44px。
• 页面滚动、返回和深链保留阅读位置；选择浮层与输入框避开工具栏和窗口边缘。
• 弹窗按内容定宽：简短决定紧凑，文档编辑留足阅读宽度；高度受视口限制， 长内容内部滚动，标题、关闭和底部动作保持可达。原生模态层管理焦点， Tab 在当前窗口循环，Escape 与关闭按钮采用一致的保存保护，关闭后返回入口。

10. 可追溯修改规则

现行追溯链为：要求 → 页面 → 服务/契约 → 代码 → 测试 → 证据 → 状态。

工程验收使用 A01–A22，体验评审使用 R01–R06，定义和当前状态见验收总表。 页面 manifest 记录入口与职责，decisions 解释当前选择，QA 记录重复验证步骤。 每次修改同步相应文档与证据，完成情况集中记录。

11. 验收门槛

功能验证覆盖文档保存、资产关联、分镜生成、三个不同视频段、候选选择、 内嵌音频播放、下载哈希和导出清单。可靠性覆盖刷新、返回、深链、失败、 未知结果、重复请求、冲突、撤权及进程恢复。

四视口为 1440×1000、1280×600、820×1180、390×844。 规模检查包含 50 集、201 项资产和 343 个变体；性能目标为预热后至少 20 次采样， 首个可交互 p95 ≤ 2 秒、缓存返回 ≤ 500ms、输入响应 ≤ 100ms，冷启动单列。 File、SQL mock、隔离 PostgreSQL 和真实平台分别记录实测结果。