OiiOii 完整产品架构拆解

1. 执行摘要

一句话架构：OiiOii 是一个以“聊天 + 可视画布”为工作台、由专业 Agent 串行推进、通过用户确认门逐阶段生成剧本—角色—场景—道具—分镜—视频资产的异步创作系统；当前页面已经暴露出状态事实源分裂、最终完成定义不清和资产依赖治理不足。

当前已确认

多 Agent 身份、阶段确认、画布资产图、模型选项、分镜视频生成、预览/剪辑/下载入口、任务与错误提示。

核心合理推断

存在项目上下文、Agent 编排、异步工具调用、模型调用、媒资保存与有向依赖，但后台实现和字段 schema 不可见。

关键建议

建立统一状态事实源、版本化资产 DAG、质量与完成门、幂等重试、额度冻结、权限隔离和全链路追踪。

2. 证据来源与证据缺口

【已确认】【合理推断】【建议设计】【未知】

证据类别	可复核内容	主要证据	覆盖范围	缺口
用户操作	提交故事；满意继续；生成道具；选择分镜/模型策略；修改入口。	S01 S03 S06	已确认	无真实中断、余额不足、生成失败操作。
聊天记录	艺术总监规划；剧本/角色/视频满意确认；场景依赖阻断；分镜知识摘要。	S01–S06、S11、S16–S18	已确认	仅静态截面；无法展开所有被遮挡消息。
Agent 名称	Oii Agent、艺术总监、编剧、角色设计师、场景设计师、道具设计师、分镜师。	S01/S02/S04/S16/S17	已确认	Oii Agent 是独立主控还是 UI 容器未知。
按钮/表单	工作流/短片参数、满意/修改、模型/质量/分辨率、先1个/全部、预览/剪辑/下载、取消/确定。	S01/S02/S03/S05/S07/S08	已确认	部分表单值被输入框遮挡。
画布资产	1 剧本、3 角色、1 场景多视图、3 道具、4 分镜/视频卡及有向连线。	S01/S07/S10	已确认	资产 ID、URL、版本和引用 schema 不可见。
历史版本	未发现版本列表；资产侧栏为空。	S09	缺失事实	不能证明后台没有版本，只能确认页面不可见。
模型选择	Seedance 2.0、Pro/Fast、720p/480p、自定义音色条件。	S05	已确认	没有完整模型目录、价格、时长、失败率或路由日志。
工具结果	激活工作流、更新短片参数完成卡；3 图/3 视频结果；任务生成中/无任务。	S01/S03/S06/S18	结果可见	官方函数名、请求/响应、调用 ID 不可见。
错误/警告	场景多视图缺失；音效/BGM等素材未完全生成。	S04/S08	已确认	无模型失败、安全拦截、扣费失败或写入失败实例。
计费信息	右上角显示 1,233 STAR。	S01–S09	余额显示	是否会员、冻结/扣费/退款、调用成本未知。
官方资料	本轮未补充外部资料。	—	未使用	模型规格、计费、安全和隐私政策仍待官方资料核验。

文件标注冲突：S12–S15 的文件名/清单描述为“加入与交接”，截图本身却显示后期分镜视频状态；架构结论只使用页面画面，不用文件名补写不存在的事实。

3. 核心功能域

账号与权限

头像/余额可见；登录、会员、租户与权限体系未知。

显示事实 + 架构推断

项目入口与管理

项目标题、分享/更多、发布按钮、工作流激活与短片参数。

已确认

聊天与 Agent

统一聊天、专业身份、计划/思考摘要、确认/修改。

已确认

剧本管理

“我的剧本”卡、查看入口、满意/修改；版本不可见。

已确认

风格选择

输入区可见“3D言情”；如何编译给模型未知。

选择已确认

角色设计

3 个角色主图与提示词修改入口；无 Face ID 证据。

主图已确认

角色库 / Face ID

资产入口存在，但角色库、Face ID、复用策略未出现。

未知

场景设计

豪华会所私密包间多视图；缺失依赖可阻断。

已确认

道具设计

从剧本关键物形成 3 个道具卡，并交给分镜师。

结果已确认

分镜设计

4 镜头、画面/音效/台词提示词、知识检索与策略选择。

已确认

视频生成

Seedance 2.0；先小样再批量；4 个视频卡。

已确认

音频/台词/音色

提示词和自定义音色条件可见；音效/BGM未齐；独立生产链未知。

部分可见

预览与剪辑

单镜头播放、编辑、删除；最终预览、去剪辑、下载入口。

入口已确认

历史版本

没有版本列表、差异或回退入口证据。

未知

资产库

右侧资产页存在但显示“这里还什么都没有”，与画布冲突。

已确认

分享与发布

顶部分享/发布入口可见；实际发布路径未执行。

仅入口

积分/额度

显示 1,233 STAR；估价、冻结、扣费、退款未见。

仅余额显示

错误与任务状态

依赖阻断、素材不完整警告、生成中与“当前无任务”。

已确认

4. 端到端功能流转表

五条流在同一张表中对齐：用户交互、Agent 控制、工具调用、全局上下文、媒资。工具名均为功能命名，不是官方函数名。

步骤	用户交互流	Agent 控制流	工具调用流	数据/全局上下文流	资产流	确认/失败分支
1 进入项目	输入现代言情故事；可选 3D言情。	艺术总监首次接管；Oii Agent 作为统一容器。	激活工作流、更新短片参数完成卡。	写入原始需求、项目/工作流状态、参数草案（字段为推断）。	暂无创意资产。	需要确认影片基本信息；失败路径未知。
2 剧本	查看“我的剧本”；满意继续或修改。	编剧围绕“觉醒”生成 0-1 剧本。	检索剧本知识（具体调用推断）；生成剧本资产。	写入 script.current 与确认状态（推断）。	1 个剧本卡。	不满意→修改→再确认；版本未知。
3 角色	查看 3 个图片；满意/修改提示词。	角色设计师读取角色/外貌/风格。	生成角色主图；更新提示词入口。	写入角色列表、提示词、主图引用（schema推断）。	许清和、顾砚、江叙白主图。	不满意→局部重生（路径入口已确认，执行未演示）。
4 场景/道具	发送“生成道具”。	场景设计师先检查依赖；缺多视图则阻断。	检查多视图；补生成场景；提取/生成道具（执行者部分推断）。	更新 scene.multiview_status；写入 props（推断）。	1 个 3 图场景卡、3 个道具卡。	场景缺失→停止→补齐→确认→继续。
5 分镜方案	选择 Seedance 2.0、Pro/Fast、720p/480p；不要分镜图；先1个/全部。	道具设计师明确邀请分镜师；分镜师提取 4 镜头。	检索运镜知识（调用形态推断）；生成画面/音效/台词提示词。	读取上游资产；写 storyboard[1..4] 与模型配置（推断）。	4 个镜头/提示词卡。	提示词满意→小样/批量；不满意修改。
6 视频小样	等待镜头1；满意继续或修改。	分镜师第一次视频执行。	视频生成。	写 video[1]、生成状态、确认状态（推断）。	镜头1视频。	满意→批量；不满意→修改提示词/重生。
7 视频批量	等待镜头2/3/4；查看“3个视频”。	分镜师再次执行。	并行或批量生成 3 视频（并行方式未知）。	写 video[2..4]；任务状态变“当前无任务”。	最终画布 4 个视频卡。	生成失败/余额不足/中断无真实分支证据。
8 最终预览	预览最终视频/去剪辑/下载所有分镜。	无独立 Agent 身份；最终界面预检。	预览预检；剪辑/下载仅入口。	读取视频及音效/BGM完整性。	视频存在；音效/BGM不完整。	警告→取消或确定；最终合成未确认。
9 状态冲突	仍看到“满意吗”。	聊天逻辑仍待确认。	无工具在运行。	任务面板“当前无任务”；资产页为空；画布有资产。	同一项目的资产在不同视图口径不一致。	建议进入 reconciliation_required，当前产品未见。

5. 产品分层架构

1 用户与渠道层

用户中文界面1,233 STAR资产入口发布入口分享入口

账号、会员、登录、权限、历史项目、偏好、发布渠道实现未知。

2 交互与工作台层

聊天Agent 身份画布资产卡表单/确认按钮任务面板预览器剪辑入口错误弹窗资产侧栏

3 产品应用层

项目管理剧本管理角色管理场景管理道具管理分镜管理视频管理音频状态资产管理发布/下载

功能域已确认；服务拆分方式为推断。版本管理未确认。

4 Agent 与流程编排层

Oii Agent/主控（身份未知）艺术总监编剧角色设计师场景设计师道具设计师分镜师工作流/确认门

专业 Agent 已确认；持久状态机、回退、重试、幂等和完成门应补充。

5 工具与服务层

上下文读写剧本/实体提取提示词生成图片生成视频生成预览/导出资产存储任务状态

音频/语音、安全、余额/计费、合成服务未确认；建议工具层强制执行。

6 模型接入与路由层

文本能力（推断）图片能力（推断）Seedance 2.0Pro/Fast720p/480p自定义音色条件

只有一个视频模型名称被确认；动态模型路由、音频/TTS 模型、成本/失败率不可确认。

7 全局上下文与数据层

用户上下文项目配置剧本角色/场景/道具分镜资产引用任务/状态确认/错误计费

8 知识与公共资产层

故事动画剧本知识“觉醒”运镜知识3D言情风格用户资产入口模型能力知识（推断）

提示词模板、安全/版权/计费规则、公共/私有隔离实现未知。

9 基础设施与治理层

身份认证/租户权限结构化数据库对象存储/CDN队列/异步任务模型网关日志/追踪质量评测内容安全成本控制数据版本

均为满足产品能力所需的建议/推断，不是已确认技术栈。

6. Agent、工具和全局上下文关系

Agent/容器	触发	读取	判断	功能性工具	写入/资产	交接	能力边界
Oii Agent	所有用户输入	会话/画布/任务（推断）	专业 Agent 路由（推断）	维护会话/画布（功能命名）	任务容器	全部专业 Agent（推断）	独立主控身份未知。
艺术总监	首次故事	原始需求、风格、参数字段	项目是否可启动、需确认什么	激活工作流、更新短片参数	项目/配置状态（推断）	编剧（推断）	不生成剧本/图/视频。
编剧	入口配置完成（推断）	原始需求/项目参数	0-1 剧本；是否待确认	检索剧本知识、生成剧本	我的剧本	角色设计师（推断）	不生成角色/视频。
角色设计师	剧本确认（推断）	剧本人物、外貌、3D言情	3 主图是否生成并满意	生成角色主图、更新提示词	3 角色资产	场景设计师（推断）	Face ID/一致性验证未知。
场景设计师	用户“生成道具”	剧本场景、多视图状态	依赖是否齐全	检查/补生成场景多视图	场景资产与状态	道具设计师	口头提取道具计划不等于已执行。
道具设计师	场景补齐（推断）	剧本、角色、场景	三类资产是否全部就绪	提取/生成道具、邀请分镜师	3 道具资产	分镜师（明确）	道具 ID/版本未知。
分镜师	明确邀请；小样满意后重入	剧本+角色/场景/道具+模型设置	4 镜头；小样/批量；满意门	检索运镜知识、提示词、视频生成	4 分镜/4 视频/状态	最终界面	音频/BGM/最终完成不属于已确认能力。

关系结论：画布曲线已确认“上游资产按阶段连接”，但 Agent 读取的是稳定 ID、对象 URL、名称代称还是纯文本提示词，页面无法确认。建议把“聊天消息”“工作流状态”“资产 DAG”分开存储，并由同一项目事件流同步。

7. 全局上下文架构

以下 Context 名称是架构模板，不等于 OiiOii 当前真实字段名。每个上下文都标明已确认内容和建议补足。

UserContext

已确认: 中文界面、余额显示、资产入口、头像。
未知: 会员、权限、偏好、历史角色/音色、租户。
建议: user_id、tenant_id、locale、entitlements、private_asset_scope。

ProjectConfig

已确认: 原始需求、3D言情、影片长度字段、Seedance 2.0、Pro/Fast、720p/480p。
未知: 比例/语言实际值、完整参数 schema。
建议: 版本化 config + confirmed_by + stale impact。

ScriptContext

已确认: “我的剧本”正文卡、满意/修改。
未知: 结构化字段、版本、锁定、差异。
建议: script_version、scenes、characters、dialogues、duration_estimate。

CharacterContext

已确认: 3 角色名与主图、提示词修改入口。
未知: Face ID、多视图、音色、稳定引用。
建议: character_id、asset_version、identity_embedding、voice_ref。

SceneContext

已确认: 豪华会所私密包间、3 图多视图、缺失阻断。
未知: 首次主图、视角 schema、版本。
建议: scene_id、views[]、style_profile_ref、status。

PropContext

已确认: 3 道具卡、从剧本关键物而来。
未知: 精确名称/ID、版本、尺度关系。
建议: prop_id、prompt、main_image_version、scene_bindings。

StoryboardContext

已确认: 4 镜头；画面/音效/台词提示词；不需要分镜图。
未知: 角色/场景/道具的稳定引用。
建议: shot_id、refs、duration、camera、prompt_bundle、stale_status。

AssetContext

已确认: 画布多类资产和 4 视频；资产侧栏为空。
未知: URI、存储域、版本、哈希、ACL。
建议: asset_id、version_id、mime、producer_run、storage_ref、lineage。

WorkflowState

已确认: 当前 Agent、生成中、满意门、当前无任务、依赖错误。
问题: 聊天/任务/画布状态不一致。
建议: 单一状态机、事件序号、确认记录、reconciliation。

BillingContext

已确认: 1,233 STAR 余额显示。
未知: 估价、冻结、扣费、退款、重试费用。
建议: estimate、reservation、settlement、refund、idempotency_key。

EvaluationContext

已确认: 用户满意/修改。
缺失: 自动质量、时长、风格、音画同步、角色一致性。
建议: check_results、user_feedback、failure_reason、model_metrics。

KnowledgeBindings

已确认: 剧本知识与“觉醒”运镜知识摘要。
未知: 知识版本、命中条目、模板 ID。
建议: knowledge_ref、version、retrieval_trace、license_scope。

8. 知识与公共资产架构

类型	当前证据	项目数据还是可复用知识	当前结论	建议架构
专业知识	编剧搜索“觉醒”剧本灵感；分镜师检索“觉醒”运镜知识。	可复用知识	公开摘要已确认	版本化知识库；检索结果带 source/version/license。
模型能力知识	Seedance 2.0、Pro/Fast、720p/480p、自定义音色条件。	可复用知识	能力表存在为推断	模型能力注册表，包含时长/分辨率/参考图/价格/延迟/安全。
风格知识	3D言情入口。	平台公共配置 + 项目选择	选择已确认	StyleProfile 编译为模型级提示词、色彩、镜头、负面约束。
提示词模板	角色主图提示词、画面/音效/台词提示词结果。	可复用知识	模板机制推断	模板版本 + 模型适配层 + 变量 schema。
安全/版权规则	没有艺术创作安全/版权规则结果。	平台治理知识	未知	由工具/网关强制，Prompt 只做前置提示，规则不可由 Agent 绕过。
计费规则	只有 STAR 余额显示。	平台规则	未知	独立定价/冻结/结算服务，不放在可被 Prompt 修改的逻辑里。
用户私有资产	资产入口；本项目资产；资产页空。	用户/项目私有数据	隔离未知	tenant ACL、私有命名空间、显式授权、不可跨用户检索。
平台公共资产	未见角色/场景/道具模板清单。	公共知识/资产	未知	公共资产独立命名空间，带授权与来源，引用到项目而非复制身份。
项目临时数据	需求、剧本、角色、场景、道具、分镜、视频、确认状态。	项目数据	已确认	版本化上下文 + 资产 lineage + retention policy。
反馈/模型表现	满意/修改按钮与用户消息。	项目反馈；是否沉淀未知	当前项目反馈已确认	默认只影响项目；用于全局训练/评测必须单独同意并脱敏。

七个关键问题

1 风格如何可执行？【已确认】用户选 3D言情；【未知】编译方式。建议 StyleProfile → 模型适配器 → 提示词/参数/校验规则。

2 角色如何跨分镜复用？【已确认】角色卡和画布连线；【未知】稳定引用。建议每镜头引用 CharacterAssetVersion/FaceID，而非复制描述。

3 镜头知识来自哪里？【已确认】分镜师公开摘要称检索“觉醒”运镜知识；具体知识库和条目未知。

4 模型能力如何知道？【已确认】UI 展示 Seedance 选项与约束；【合理推断】存在配置；建议能力注册表驱动 UI 与调用校验。

5 安全与计费放哪里？【建议设计】必须由工具/模型网关强制；Agent Prompt 只能辅助，不是唯一防线。

6 用户反馈是否沉淀？【已确认】只看到当前项目确认；【未知】是否学习。建议默认项目级，平台学习需 opt-in。

7 私有/公共如何隔离？【未知】当前实现；建议租户 ACL、对象存储前缀、检索过滤、审计日志与最小授权。

9. 模型接入与路由架构

模型能力	当前页面证据	可确认结论	合理架构推断	建议路由维度	不可确认
文本/Agent 模型	自然语言规划、剧本、实体提取、提示词。	存在文本生成能力。	专业 Agent 可能共享或分别配置文本模型。	任务类型、上下文长度、结构化输出、成本、延迟、质量。	厂商、模型名、动态路由。
图片模型	角色主图、场景多视图、道具图。	存在图片生成能力。	工具层接入图片模型并写入资产服务。	参考图、多视图、一致性、分辨率、风格、成本、安全。	模型名、种子、重试。
视频模型	Seedance 2.0；Pro/Fast；720p/480p；4 视频。	至少一个视频模型/产品档位。	UI 配置传给视频生成工具。	画质/速度/成本、时长、参考图、音频支持、失败率。	是否还有其他模型；真正动态路由。
音频/语音/TTS	音效/台词提示词；自定义音色条件；最终音效/BGM不完整。	产品考虑音频能力，但完成链不明。	可能由视频模型或独立工具产生。	语言、角色音色、时长、版权、同步、费用。	模型名、生产者、音色资产。
能力注册表	条件提示“自定义音色，仅在选择 Seedance 2.0 时生效”。	UI 有能力约束。	可能存在模型配置表。	能力、限制、价格、健康度、版本、弃用日期。	真实实现与更新机制。
模型网关/重试	无调用日志；无模型失败实例。	不能确认。	多模态工具需要统一接入层。	幂等、超时、熔断、回退、审核、计费、trace_id。	当前是否存在。

边界：页面只出现一个视频模型名称，不能据此声称 OiiOii 已具备完整的多模型动态路由。主架构把“能力注册表/模型网关”标为合理推断或建议设计。

10. 底层架构选型表

不猜厂商和语言；“可能选型”只描述类别或常见实现路径。

能力域	必须具备的能力	可能选型	推荐方案	证据级别	不能确认原因
聊天/画布前端	流式聊天、节点图、卡片、表单、任务/错误、媒体预览。	现代 Web SPA + 图编辑/画布库 + 流式协议。	统一 project_version 与 event_seq 驱动聊天/画布/侧栏读模型。	交互已确认	框架与协议不可见。
Agent 编排	角色路由、上下文装配、确认门、交接。	自定义编排器、图式 Agent Workflow。	显式 AgentRun/Task 状态机，Prompt 不承担 durable state。	合理推断	后台不可见。
工作流/状态机	长任务恢复、阻断、确认、重试、中断、回退。	持久工作流引擎或数据库状态机。	事件溯源 + durable workflow + reconciliation。	建议设计	当前状态冲突说明实现不足或读模型不同步。
异步任务	图片/视频长耗时生成、进度、取消、晚到结果。	任务队列 + worker + 事件总线。	job_id、attempt、idempotency_key、cancel_token、heartbeat。	行为支持	具体队列未知。
模型网关	统一请求、路由、限流、超时、安全、成本、追踪。	内部 API 网关/适配器层。	能力注册表驱动路由；所有调用带 trace_id 和 billing_reservation。	建议设计	只见 UI 模型选择。
工具调用	schema 校验、权限、幂等、结果写入。	内部工具 RPC/HTTP/任务命令。	ToolCall 作为一等实体；成功必须伴随状态/资产事务或补偿。	结果可见	官方工具名/协议未知。
全局上下文存储	版本化项目图、引用、确认、状态。	关系数据库 + JSON 文档 + 读模型。	结构化主数据 + 事件日志 + 缓存；避免单个“大上下文 blob”。	建议设计	前端只显示结果。
结构化业务数据	用户/项目/任务/确认/计费的事务一致性。	ACID 关系数据库。	单一事实源；状态变更带乐观锁/version。	建议设计	数据库未知。
媒资存储/CDN	大文件、多版本、缩略图、播放、下载、权限。	对象存储 + CDN + 媒体处理。	内容寻址/哈希、签名访问、版本 metadata、生命周期。	媒资行为支持	厂商/部署未知。
资产版本管理	新版本、差异、回退、lineage、stale。	不可变 AssetVersion + 依赖 DAG。	永不覆盖已确认版本；修改触发局部失效/重算计划。	建议设计	页面历史为空。
用户确认/中断	结构化确认、暂停、取消、晚到结果处理。	Workflow command + confirmation record。	确认与状态写入事务化；中断写 cancel_requested。	建议设计	只见按钮，无协议。
计费与额度冻结	预估、冻结、结算、退款、重复请求去重。	独立账本/额度服务。	生成前 reserve，成功 settle，失败 release/refund，按 ToolCall 幂等。	建议设计	仅余额显示。
内容安全	输入/输出审核、策略版本、申诉、审计。	安全策略引擎 + 模型审核。	网关强制；Agent 不可绕过；记录 policy_version 与 evidence。	建议设计	无拦截证据。
日志/链路追踪	用户动作→AgentRun→ToolCall→ModelInvocation→Asset。	结构化日志 + 分布式追踪 + 指标。	贯穿 trace_id/project_version；支持对账和复现。	建议设计	页面无日志。
模型效果评测	角色一致性、风格、时长、台词、同步、用户反馈。	自动评测 + 抽检 + 人工反馈。	EvaluationContext 作为完成门；模型/模板版本回流。	建议设计	仅满意按钮。
知识检索	检索剧本/镜头知识，版本和来源可追溯。	全文/向量/混合检索。	知识条目带版本、许可、适用模型；记录 retrieval trace。	检索摘要已确认	索引/数据库未知。
权限/租户隔离	项目/媒资/FaceID/音色最小权限和审计。	RBAC/ABAC + tenant-scoped storage。	所有检索、对象访问和 ToolCall 强制 tenant_id。	建议设计	登录/权限 UI 未见。

11. 数据实体表和 ER 图

实体名是分析模板，不代表 OiiOii 真实表名。

实体	职责	关键字段示例（推导设计）	页面证据	关系结论
User	用户/租户主体	user_id、locale、entitlements	头像、中文 UI、STAR	实体推断
Project	一次创作项目	project_id、title、config_version、status	项目标题、工作流、画布	概念已确认
Conversation	聊天消息容器	conversation_id、messages、agent_identity	统一聊天区	已确认
Agent	专业角色定义	agent_id、name、capabilities	7 个名称/容器	身份已确认
AgentRun	一次 Agent 执行	run_id、state、input_version、trace_id	规划/思考/生成状态	实体推断
Workflow	阶段顺序与状态机	workflow_id、current_stage、event_seq	激活工作流、画布链路	合理推断
Task	长耗时任务	task_id、status、attempt、cancel_requested	任务列表、生成中/无任务	概念已确认
ToolCall	工具请求/结果	tool_call_id、tool_type、idempotency_key、result	完成卡/资产结果	实体推断
Script	剧本版本	script_id、version、body、status	“我的剧本”	资产已确认
Character	角色主数据	character_id、name、prompt、identity_ref	3 角色卡	已确认
Scene	场景主数据	scene_id、description、multiview_status	豪华包间多视图	已确认
Prop	道具主数据	prop_id、description、scene_bindings	3 道具卡	已确认
Storyboard	镜头与提示词	shot_id、refs、prompt_bundle、duration	4 镜头卡	已确认
Asset	逻辑媒资	asset_id、type、owner_scope、current_version	图片/视频卡	概念已确认
AssetVersion	不可变媒资版本	version_id、storage_ref、hash、producer_run	无版本 UI	建议实体
UserConfirmation	结构化确认	confirmation_id、stage、version、action	满意/修改按钮	实体推断
ModelInvocation	模型请求/响应	invocation_id、model、params、usage、latency	Seedance 选项+视频结果	实体推断
Error	错误/警告	error_id、category、retryable、source	多视图缺失、素材不完整	概念已确认
BillingRecord	额度账本	record_id、estimate、reserve、settle、refund	仅余额	建议实体
Feedback	用户/自动评测	feedback_id、target_version、rating、reason	满意/修改	实体推断

Mermaid ER 图

实体关系（模板名称）

erDiagram
    USER ||--o{ PROJECT : owns
    PROJECT ||--o{ CONVERSATION : has
    PROJECT ||--|| WORKFLOW : runs
    WORKFLOW ||--o{ TASK : schedules
    AGENT ||--o{ AGENT_RUN : executes
    WORKFLOW ||--o{ AGENT_RUN : orchestrates
    AGENT_RUN ||--o{ TOOL_CALL : invokes
    TOOL_CALL ||--o{ MODEL_INVOCATION : may_create
    PROJECT ||--o{ SCRIPT : versions
    PROJECT ||--o{ CHARACTER : contains
    PROJECT ||--o{ SCENE : contains
    PROJECT ||--o{ PROP : contains
    PROJECT ||--o{ STORYBOARD : contains
    STORYBOARD }o--o{ CHARACTER : references
    STORYBOARD }o--o{ SCENE : references
    STORYBOARD }o--o{ PROP : references
    SCRIPT ||--o{ STORYBOARD : decomposes_into
    PROJECT ||--o{ ASSET : owns
    ASSET ||--|{ ASSET_VERSION : versions
    AGENT_RUN ||--o{ ASSET_VERSION : produces
    STORYBOARD ||--o{ ASSET_VERSION : renders_to
    PROJECT ||--o{ USER_CONFIRMATION : records
    USER_CONFIRMATION }o--|| ASSET_VERSION : confirms
    TASK ||--o{ ERROR : reports
    TOOL_CALL ||--o{ ERROR : reports
    MODEL_INVOCATION ||--o{ BILLING_RECORD : settles
    PROJECT ||--o{ FEEDBACK : collects
    FEEDBACK }o--|| ASSET_VERSION : evaluates

关键关系：Project→剧本/角色/场景/道具/分镜/资产由画布支持；Storyboard 对三类资产的稳定多对多引用、AgentRun/ToolCall/ModelInvocation、AssetVersion、账本和反馈实体属于架构推导/建议。

12. 端到端时序图

场景：用户提交完整剧本并附带角色参考图。参考图上传是输入框能力，但本次记录没有真实上传；相应步骤在图中标为推断/建议。

sequenceDiagram

sequenceDiagram
    autonumber
    actor U as 用户
    participant W as 聊天/画布工作台
    participant O as 主控Agent（推断）
    participant A as 专业Agent
    participant WF as 工作流与状态服务（推断）
    participant C as 全局上下文（推断）
    participant T as 工具服务（推断）
    participant SB as 安全与计费服务（建议）
    participant MG as 模型网关（推断）
    participant AS as 资产服务（推断）

    U->>W: 提交完整剧本 + 角色参考图 + 风格/规格
    W->>O: 创建/恢复项目会话（推断）
    O->>WF: 激活工作流（页面有完成卡）
    O->>C: 写入原始输入与参数草案（推断）
    WF-->>W: 展示参数确认表
    W-->>U: 请求明确确认

    alt 用户修改参数
        U->>W: 修改影片长度/比例/语言/风格
        W->>C: 写新配置版本（建议）
        C->>WF: 标记受影响下游资产 stale（建议）
    else 用户确认
        U->>W: 确认并继续
        W->>WF: 记录 UserConfirmation（推断）
    end

    WF->>O: 触发艺术总监/编剧交接（推断）
    O->>A: 分派编剧/角色设计师任务
    A->>C: 读取剧本、风格、参考图（推断）
    A->>T: 构建角色提示词/生成请求（推断）
    T->>SB: 安全检查 + 额度预估/冻结（建议）

    alt 安全拦截或余额不足
        SB-->>T: 拒绝 + 可复核原因
        T-->>WF: failed，不生成资产
        WF-->>W: 显示错误与可恢复动作
    else 允许生成
        SB-->>T: reservation_id（建议）
        T->>MG: 图片生成请求（推断）
        MG-->>T: 异步 job_id
        T-->>WF: executing + progress
        WF-->>W: 展示生成中
        MG-->>T: 图片结果
        T->>AS: 保存角色 AssetVersion（建议）
        AS-->>T: asset_ref
        T->>C: 写入角色资产引用（推断）
        T->>SB: 结算/释放额度（建议）
        WF-->>W: 展示角色卡并等待确认
    end

    alt 用户要求局部修改
        U->>W: 修改某角色提示词
        W->>WF: 创建新版本任务
        WF->>C: 仅角色及其下游分镜/视频标记 stale（建议）
        WF->>A: 重新触发角色设计师
    else 用户满意
        U->>W: 满意并继续
        W->>WF: 写确认记录
        WF->>A: 交接场景→道具→分镜
    end

    A->>C: 读取已确认剧本/角色/场景/道具
    A->>T: 生成分镜提示词
    T->>MG: Seedance 2.0 视频生成（模型选择已确认）
    MG-->>T: 异步视频任务

    alt 用户中断
        U->>W: 中断
        W->>WF: cancel_requested（建议）
        WF->>T: 停止新调用/取消任务（建议）
        T-->>C: 晚到结果仅登记，不自动采用（建议）
    else 生成失败
        MG-->>T: 失败
        T-->>WF: 分类错误 + retryable
        WF->>T: 同幂等键重试≤策略次数（建议）
    else 生成成功
        MG-->>T: 视频结果
        T->>AS: 保存视频版本
        AS-->>C: 写入资产引用
        WF-->>W: 展示 4 视频 + 满意/修改
    end

    W->>WF: 请求最终预览
    WF->>C: 读取视频/音效/BGM完整性
    alt 素材不完整（页面已确认）
        WF-->>W: 警告“素材未完全生成”
    else 完成门通过（建议）
        WF->>T: 合成/预览/导出
        T->>AS: 保存最终成片
        WF-->>W: completed + 可预览/下载
    end

13. 产品全景架构主图

实线：已确认虚线：合理推断粗线：建议设计红色节点：当前问题

OiiOii 分层全景架构

flowchart TB
    classDef confirmed fill:#153f31,stroke:#39bd88,color:#fff
    classDef inferred fill:#493316,stroke:#dfa044,color:#fff
    classDef suggested fill:#173952,stroke:#55a5e5,color:#fff
    classDef unknown fill:#38294a,stroke:#a487d0,color:#fff
    classDef risk fill:#4a211f,stroke:#ed6c61,color:#fff,stroke-width:2px

    subgraph L1[1 用户与渠道层]
      U[用户]:::confirmed
      ACCT[账号/权限/会员
实现未知]:::unknown
      BAL[1,233 STAR]:::confirmed
      PUB[分享/发布入口]:::confirmed
      UAS[用户私有资产]:::unknown
    end

    subgraph L2[2 交互与工作台层]
      CHAT[聊天 + Agent 身份]:::confirmed
      FORM[参数/确认/修改]:::confirmed
      CANVAS[画布 + 资产卡 + 连线]:::confirmed
      TASKUI[任务面板]:::confirmed
      PREVIEW[预览/剪辑/下载]:::confirmed
      ASSETPANEL[资产侧栏为空]:::risk
      WARN[依赖/素材警告]:::confirmed
    end

    subgraph L3[3 产品应用层]
      PROJECT[项目/配置管理]:::inferred
      SCRIPTAPP[剧本管理]:::confirmed
      CHARAPP[角色管理]:::confirmed
      SCENEAPP[场景管理]:::confirmed
      PROPAPP[道具管理]:::confirmed
      STORYAPP[分镜管理]:::confirmed
      VIDEOAPP[视频管理]:::confirmed
      AUDIOAPP[音频/BGM管理]:::unknown
      ASSETAPP[资产管理]:::inferred
      VERSIONAPP[版本/依赖失效]:::suggested
      PUBLISHAPP[预览/发布管理]:::inferred
    end

    subgraph L4[4 Agent 与流程编排层]
      MASTER[Oii Agent / 主控
身份未知]:::inferred
      AD[艺术总监]:::confirmed
      WR[编剧]:::confirmed
      CD[角色设计师]:::confirmed
      SD[场景设计师]:::confirmed
      PD[道具设计师]:::confirmed
      ST[分镜师]:::confirmed
      WF[持久工作流/状态机]:::inferred
      CONFIRM[用户确认门]:::confirmed
      COMPLETE[统一完成门]:::suggested
      RETRY[中断/幂等/重试]:::suggested
      RECON[状态调和]:::suggested
    end

    subgraph L5[5 工具与服务层]
      CTXIO[上下文读写]:::inferred
      PARSE[剧本/角色/场景/道具提取]:::inferred
      PROMPT[提示词生成]:::confirmed
      IMG[图片生成]:::confirmed
      VID[视频生成]:::confirmed
      AUD[音频/语音生成]:::unknown
      COMPOSE[合成/预览/导出]:::inferred
      STORE[媒资写入/读取]:::inferred
      TASKS[异步任务服务]:::inferred
      SAFE[安全检查]:::suggested
      BILL[额度预估/冻结/结算]:::suggested
      QA[质量/时长/风格/同步校验]:::suggested
    end

    subgraph L6[6 模型接入与路由层]
      TEXT[文本模型能力]:::inferred
      IMAGE[图片模型能力]:::inferred
      SEED[Seedance 2.0
Pro/Fast · 720p/480p]:::confirmed
      AUDIO[音频/TTS/音色模型]:::unknown
      REG[模型能力注册表]:::suggested
      ROUTER[模型网关/路由/回退]:::suggested
    end

    subgraph L7[7 全局上下文与数据层]
      UC[UserContext]:::inferred
      PC[ProjectConfig]:::confirmed
      SC[ScriptContext]:::confirmed
      CC[CharacterContext]:::confirmed
      SEC[SceneContext]:::confirmed
      PRC[PropContext]:::confirmed
      SBC[StoryboardContext]:::confirmed
      ASC[AssetContext]:::inferred
      WS[WorkflowState]:::confirmed
      BC[BillingContext]:::unknown
      EC[EvaluationContext]:::suggested
      SPLIT[聊天/任务/画布/资产
状态不一致]:::risk
    end

    subgraph L8[8 知识与公共资产层]
      STYLE[3D言情风格]:::confirmed
      SKB[故事动画剧本知识]:::confirmed
      CKB[“觉醒”运镜知识]:::confirmed
      TMPL[提示词模板]:::inferred
      MK[模型能力知识]:::inferred
      POL[安全/版权/计费规则]:::suggested
      PRIVATE[用户私有资产域]:::suggested
      PUBLIC[平台公共资产域]:::unknown
    end

    subgraph L9[9 基础设施与治理层]
      AUTH[认证/租户权限]:::suggested
      DB[结构化数据库/事件日志]:::suggested
      OBJ[对象存储/CDN]:::suggested
      QUEUE[队列/异步 Worker]:::suggested
      GW[模型网关]:::suggested
      OBS[日志/链路追踪/告警]:::suggested
      EVAL[模型效果评测]:::suggested
      PRIV[隐私/数据版本/隔离]:::suggested
    end

    U -->|输入/确认/修改| CHAT
    U -->|选择| FORM
    CHAT -->|展示| CANVAS
    CANVAS -->|预览入口| PREVIEW
    TASKUI -->|状态显示| U
    BAL -->|余额显示| U
    PUB -->|入口| PUBLISHAPP

    CHAT -.->|调用/路由| MASTER
    MASTER -.->|调用| AD
    AD -.->|交接| WR
    WR -.->|交接| CD
    CD -.->|交接| SD
    SD -.->|交接| PD
    PD -->|明确邀请| ST
    ST -->|确认请求| CONFIRM
    CONFIRM -->|确认事件| WF
    WF -.->|状态更新| TASKUI
    WF -.->|任务分派| MASTER
    RETRY ==>|建议控制| WF
    COMPLETE ==>|完成判定| WF
    RECON ==>|对账| SPLIT

    WR -.->|调用| PARSE
    CD -.->|调用| IMG
    SD -.->|调用| IMG
    PD -.->|调用| IMG
    ST -->|调用| PROMPT
    ST -->|调用| VID
    VID -.->|模型请求| SEED
    IMG -.->|模型请求| IMAGE
    PARSE -.->|模型请求| TEXT
    AUD -.->|模型请求| AUDIO
    SAFE ==>|强制检查| ROUTER
    BILL ==>|额度门| ROUTER
    REG ==>|能力/限制| ROUTER
    ROUTER ==>|统一调用| SEED
    QA ==>|验证| COMPLETE

    CTXIO -.->|读取/写入| PC
    CTXIO -.->|读取/写入| SC
    CTXIO -.->|读取/写入| CC
    CTXIO -.->|读取/写入| SEC
    CTXIO -.->|读取/写入| PRC
    CTXIO -.->|读取/写入| SBC
    CTXIO -.->|状态更新| WS
    IMG -.->|资产写入| STORE
    VID -.->|资产写入| STORE
    STORE -.->|资产引用| ASC
    ASC -.->|资产引用| CANVAS
    ASC -.->|读取| ASSETAPP
    WS -.->|读取| CHAT
    WS -.->|读取| TASKUI
    ASC -.->|读取| ASSETPANEL
    WS -->|冲突证据| SPLIT
    ASC -->|冲突证据| SPLIT

    STYLE -->|风格知识| PROMPT
    SKB -->|检索| WR
    CKB -->|检索| ST
    TMPL -.->|模板| PROMPT
    MK -.->|能力| REG
    POL ==>|策略| SAFE
    UAS -.->|私有引用| PRIVATE
    PRIVATE ==>|租户隔离| AUTH

    WF ==>|持久化| DB
    TASKS ==>|任务事件| QUEUE
    STORE ==>|媒资| OBJ
    ROUTER ==>|网关| GW
    WF ==>|trace| OBS
    QA ==>|评测结果| EVAL
    AUTH ==>|授权| PRIV

需求从哪里进入？聊天输入框；艺术总监/Oii Agent 首次处理。

谁决定调用 Agent？专业交接可见；主控编排实体合理推断，未确认实现。

Agent 从哪里拿输入？聊天、项目配置、画布上游资产；稳定引用方式未知。

图片/视频由谁生成？角色/场景/道具 Agent 触发图片能力；分镜师触发视频能力。

结果存哪里？画布资产可见；对象存储/资产服务为推断。

失败后怎么办？只确认依赖阻断和最终警告；系统性重试/中断建议补充。

余额不足在哪里拦截？当前未知；建议工具/模型网关前由计费服务强制。

如何保证完成？当前未保证；建议统一完成门读取资产、状态、质量、确认和计费。

14. 当前架构 As-Is

能力	当前可见架构	证据	成熟度判断	当前问题
交互工作台	聊天 + 画布 + 侧栏 + 任务 + 预览。	S01/S07/S09	核心体验已成形	不同视图状态口径不一。
多 Agent 链	艺术总监→编剧→角色→场景→道具→分镜。	S01–S06/S16/S17	阶段角色清晰	主控调度、重入与回退协议不透明。
用户确认门	剧本、角色、提示词、小样、批量视频均有满意/修改。	S02/S03/S06/S18	可控性较好	确认是否结构化写入未知。
资产生成	剧本、角色、场景、道具、分镜、视频逐步产生。	画布与卡片	端到端覆盖广	版本、lineage、稳定引用不可见。
依赖检查	场景多视图缺失可阻断并补偿。	S04	有局部依赖治理	检查发生较晚；全局依赖失效未知。
模型配置	Seedance 2.0、Pro/Fast、720p/480p。	S05	用户可控	能力/成本/时长/失败率不透明。
知识检索	剧本与镜头知识摘要。	S02/S17	专业知识增强	来源、版本、许可和命中记录未知。
任务/错误	生成中、当前无任务、依赖警告、素材不完整。	S04/S08/S18	有基础反馈	完成定义与状态同步不足。
计费	STAR 余额显示。	S01–S09	仅展示层可见	估价/冻结/扣费/退款未知。
最终成片	预览/剪辑/下载入口；音效/BGM不完整。	S07/S08	链路未闭环	无法确认完整成片实际产出。

15. 建议架构 To-Be

建议组件	解决的问题	核心机制	落点	验收标准
统一状态事实源	聊天/任务/画布/资产冲突。	事件序号、乐观锁、读模型订阅、reconciliation。	WorkflowState + 事件日志	四个界面同一 project_version/event_seq。
统一完成门	Agent 口头完成≠真正完成。	必需资产、状态写入、确认、质量、计费、交接同时校验。	编排层	任一条件失败不得 completed。
资产 DAG 与失效引擎	上游修改后下游可能继续引用旧版。	不可变 AssetVersion、lineage、stale、局部重算计划。	AssetContext/版本服务	修改角色自动列出受影响分镜/视频。
结果质量校验	缺少角色一致性、风格、时长、台词验证。	自动评测 + 规则校验 + 用户确认。	EvaluationContext	报告可追溯；失败不声称符合。
音画同步/时长门	音效/BGM不完整与最终预览不确定。	镜头时长、对白时长、音轨、BGM、总时长检查。	合成前工具	可预览/可导出状态分级清晰。
模型能力注册表	UI 与真实模型约束可能漂移。	版本化能力、价格、健康、限制、弃用时间。	模型路由层	UI 与调用共用同一能力源。
幂等任务与重试	重复生成/扣费/资产。	idempotency_key、attempt、去重、补偿。	ToolCall/Task	重复点击只产生一个有效账单/版本。
额度预估/冻结	生成前成本未知。	estimate→reserve→settle/release/refund。	BillingContext	余额不足在调用前阻断；失败自动释放。
中断协议	用户停止后后台可能继续。	cancel_requested、worker cancel、晚到结果隔离。	Workflow/Task	中断后无新调用；晚到资产不自动采用。
全链路追踪	难以解释错资产/错状态/错扣费。	trace_id 串联 UserAction→AgentRun→ToolCall→ModelInvocation→Asset→Billing。	Observability	可在单页复原一次生成全过程。
模型效果反馈	满意/修改无法驱动质量改进。	项目反馈、失败原因、模型/模板版本统计；全局使用需 opt-in。	Evaluation/Knowledge	能比较模型/模板效果且不泄露私有数据。
私有资产隔离	FaceID/音色/参考图高敏感。	tenant ACL、签名访问、最小权限、审计。	认证/资产/检索	跨租户访问自动拒绝并告警。

16. 关键风险

状态事实源分裂

聊天待确认、任务无任务、画布有资产、资产侧栏为空。可能导致错误交接、误删或误完成。

口头完成替代真实完成

“规划完成/已生成”可能早于状态、资产、音频或最终合成完成。

资产成功但上下文未更新

生成工具成功若写入失败，画布/侧栏/下游读取可能分叉。

用户中断后继续执行

长视频任务若无取消令牌，后台可能继续扣费并生成晚到资产。

私有资产权限泄漏

角色参考图、FaceID、音色属于高敏私有资产；隔离机制不可见。

上游修改未使下游失效

角色/场景改版后旧分镜和视频仍可能被当作当前结果。

自动重试重复扣费

无幂等和账本冻结证据；重复请求可能产生多资产/多账单。

时长偏离原剧本

影片长度值与镜头时长校验不可见，最终视频可能严重偏离目标。

风格一致性缺失

3D言情选择是否贯穿角色/场景/道具/视频与校验不可确认。

台词与音画同步缺失

音效/BGM未完整，未见台词时长与嘴型/画面同步验证。

安全误判/解释不足

未见安全实例；缺少规则版本和申诉可能导致无法解释拦截。

知识与模型能力过期

知识/模型限制若无版本更新，会让 Prompt、UI 与实际能力漂移。

17. 架构组件—证据追溯表

架构组件	为什么需要	页面/官方证据	分类	置信度
聊天/画布工作台	核心交互与资产可视化。	S01/S07/S10	已确认	高
专业 Agent 链	分工完成剧本到视频。	S01–S06/S16/S17	已确认	高
主控 Agent/编排器	需要决定阶段触发与路由。	Oii Agent 容器、画布链路、明确邀请分镜师。	合理推断	中
用户确认门	每阶段满意/修改分支。	S02/S03/S06/S17/S18	已确认	高
异步任务服务	视频生成中、3视频批量、任务面板。	S06/S18	合理推断	高
项目上下文	后续 Agent 使用上游剧本/角色/场景/道具。	画布连线、S16/S17就绪摘要。	合理推断	高
资产服务	保存/预览/下载图片与视频。	多类卡片、播放/下载入口。	合理推断	高
对象存储/CDN	大规模媒资传输与播放。	无后台证据。	建议设计	设计必要
视频模型 Seedance 2.0	分镜视频生成。	S05配置 + S06/S18结果。	已确认	高
模型能力注册表	UI 显示模型条件/分辨率。	自定义音色条件。	推断/建议	中
知识检索	剧本灵感和运镜知识。	S02/S17公开思考摘要。	能力已确认	高
统一状态事实源	解决聊天/任务/画布/资产冲突。	S07/S09/S18冲突。	建议设计	高必要性
资产 DAG/失效引擎	支撑画布引用、修改与局部重算。	画布连线；修改入口。	建议设计	高必要性
质量/完成门	避免4视频存在但音效/BGM不完整。	S08警告。	建议设计	高必要性
计费账本/额度冻结	生成成本与重复扣费治理。	仅余额显示。	建议设计	高必要性
安全策略服务	多模态生成合规。	无页面实例。	建议设计	设计必要
全链路追踪	调和状态、资产、模型与账单。	当前冲突需要可诊断性。	建议设计	高必要性
版本/历史	修改与回退、防覆盖。	资产页空、无历史。	建议设计	高必要性
租户权限/私有资产隔离	保护参考图、FaceID、音色。	资产入口存在；权限未知。	建议设计	设计必要

18. 仍然无法确认的问题

主控与编排

Oii Agent 是独立主控、群聊容器还是 UI 名称；专业 Agent 如何调度、恢复和重入。

后台技术栈

前端框架、服务语言、数据库、对象存储、CDN、队列、工作流引擎和云服务。

模型目录

文本/图片/音频模型名，Seedance之外是否有路由、降级、回退、健康度与价格。

资产引用

角色/场景/道具是否通过稳定 ID、URI、Face ID、embedding、名称代称或提示词复制关联分镜。

历史与失效

是否有 AssetVersion、项目历史、局部回退；上游修改如何使下游失效。

任务语义

“当前无任务”是否只代表没有后台作业，还是阶段完成；聊天满意门如何同步。

计费

STAR 与模型调用的换算、估价、冻结、扣费、退款、失败/重试费用和会员权益。

安全与版权

输入/输出审核、规则版本、真人/肖像/音色许可、误判恢复和审计。

音频链

音效、BGM、台词、音色、TTS、视频原生音频的生产者与完成条件。

发布/剪辑

剪辑器是否内置、最终合成与导出格式、发布渠道、权限和可恢复性。

用户数据隔离

私有资产的租户边界、跨项目复用授权、下载链接权限、数据保留与删除。

质量与效果

角色一致性、风格、时长、台词准确、音画同步、用户反馈和模型评测是否存在。