历史 · oceanway-studio 实施计划
重构前档案，仅供追溯，不作为新版本执行指令
历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。
仓库：Oceanway-AI/oceanway-studio。目标 Surface：canvas.oceanway.tech。迁移来源：oceanway-vozeb。
现有实现与本轮起点
Studio 已有统一创作、工作台、Canvas、素材、服务端任务与既有 /drama。模型发布目录隔离、调用入口隔离、品牌、依赖与入口清理形成了独立来源和组合验收候选；本地组合测试通过不等于全部源变更已进入主线、远端门禁通过或生产发布。目录过滤和真实调用授权分开验收，后者必须证明拒绝前无任务、无扣费、无上游副作用。
本轮先围绕已有能力补全需求、设计与原型。固定提交、活动工作树、已审范围和候选验证按本地协调登记；GitHub 候选只作为对应历史证据，不取代本地活动包。B1 运行依赖不阻塞这轮产品设计。
目标结果与当前基线
Studio 承载统一创作入口、图片/视频/音频工作台、无限画布工具、资产使用和 Agent 协作。oceanway-studio 已保留来自 oceanway-vozeb 的历史与产品基础，后续迁移围绕现有能力渐进进行，不重新复制整站。现有 /drama 继续保留和维护，独立 Drama 使用自身需求建设；两者不在本轮合并产品流程或迁移数据。
所有开发者公开内容迁往 oceanway-console 承载的 Developer Center 匿名 Surface；Apps、Credential、API Usage 等私有控制能力迁往同仓 Console 认证 Surface；内部管理员能力迁往 Admin。
范围边界
负责 Studio 私有会话、创作体验、Canvas 产品聚合、产品内引用与写回命令。
目标态不负责全局 Identity/Wallet/Run/Asset 事实、Developer 控制面、Public API、Provider 路由、管理后台或其他产品聚合。当前仍承载的旧 Owner 能力须明确登记，接收端通过后逐命令切换；不能把目标边界误读为立即删除现有后台或用户功能。
依赖与输出
| 类型 | 内容 |
|---|---|
| 上游 | Core Product Contract、Model Offering、Run、Asset、Agent 与未来 Canvas Runtime Contract |
| 迁移 | oceanway-vozeb 的提交历史、路由、数据 Owner、在途任务和部署来源 |
| 下游 | 将稳定 Asset/Canvas/Run 引用交给 Drama、Commerce 或 Console，不复制对方业务对象 |
| 输出 | Studio Web/BFF 制品、命令级 Writer Map、迁移与浏览器验收证据 |
仓库里程碑
- STUDIO-1 边界清理：盘点 Developer/Public API/Admin 导航、API 与 Writer；接收端真实可用后按已确认范围迁移或 Redirect，保留未被替代的服务与既有
/drama。 - STUDIO-2 独立 Surface：完成仓库历史、CI、配置、部署和
canvas.oceanway.tech切换。 - STUDIO-3 共享上下文：接入 Customer Identity、Organization/Workspace/Project 和公开 Model Offering。
- STUDIO-4 首个 Core-backed 命令：在 B3/B4 后迁移一个明确文本或创作命令到 Core Run/Billing/Asset。
- STUDIO-5 Asset 与 Canvas：使用稳定 Asset Version、Lineage、Canvas Revision 和显式 Handoff/Return Binding。
- STUDIO-6 媒体扩展：Media Gateway 门禁通过后再迁移图片/视频正式执行。
验收与切换
- 每个命令维护唯一 Writer、旧新路由、幂等水位、在途任务与回滚归属。
- Shadow 只能读取和比较，不能创建费用、Run、Asset 或 Provider Task。
- Studio 展示的模型严格限制为当前创作 Surface 支持的公开 Offering，不显示 API-only/internal 模型。
- 资产、会话、Canvas 和生成记录均按登录用户与 Tenant 服务端恢复，不依赖浏览器持久化业务事实。
- 回滚只改变后续新命令，已受理 Operation 保持原 Owner 处理。
完整迁移边界见Studio 迁移计划与资源模型。
本轮需求、设计与原型
遵循统一实施流程。负责人同时承担创作者需求、设计确认和迁移调度职责；先审视存量真实链路，再制作缺口原型，不先重做所有页面。
| 用户 | 首期任务目标 | 需确定或核对 |
|---|---|---|
| 个人创作者 | 提交需求与参考素材，得到可继续使用的文本/图片/视频/音频 | 默认创作入口、已有工作台与统一 Agent 的可见关系、首轮重点媒体链 |
| Canvas 使用者 | 组织节点/引用、生成、比较并保存项目 | 首页到画布的主入口、结果回用方式、移动端可操作范围 |
| 既有短剧与开发者用户 | 原有工作不中断，理解功能去向 | /drama 保留清单、Key/用量/Admin 的接收端与逐项迁移时机 |
需求清单标记“现有并保留、改进、候选、待迁移”；模型能力、提示词与内部执行信息的公开边界沿用现有规则。普通创作请求不自动新建 Canvas/短剧项目，失败重试和历史恢复不改变原对象归属。
首期两条旅程：首页 → 统一创作 → 选择参考/能力 → 生成结果 → 引用/下载 → 刷新恢复；Canvas 列表 → 打开项目 → 引用和连线 → 发起生成 → 节点结果 → 保存/重开。保留 /drama 和尚未被接收的账户功能作为兼容验收旅程，不自动扩充其需求。
信息架构与原型页面
| 页面/区域 | 设计输出 | 必须覆盖的状态 |
|---|---|---|
| 首页与产品导航 | 创作入口、最近工作与 Console 去向；明确当前已开放功能 | Session 初始化、无历史、未登录、未接入目标平台 |
| 统一创作与媒体工作台 | 紧凑输入、素材、模型和参数入口、结果与后续动作 | 草稿、上传/提交、运行、部分成功、失败、重试、历史加载 |
| 结果与媒体查看 | 原比例、结果切换、引用/下载、原文与公开提示内容边界 | 单/多结果、无可用 URL、窄竖屏、加载失败 |
| Canvas | 节点、连线、配置、Agent、历史与引用的真实关系 | 空画布、生成中、已有任务恢复、失效引用、保存失败、权限变化 |
素材与既有 /drama | 复用路径与保留能力清单，不重新设计第二素材事实源 | 空、分页、删除引用保护、刷新、跨会话恢复 |
复用已存在 Ocean Foundation 与业务组件，统一基础以 Infrastructure 所有权为目标；业务 Run、Session、模型规划不能随组件迁移。交付桌面、390/430px、浅深主题与键盘原型；移动画布的精细编辑范围先确认，不用缩小桌面画布冒充适配。
API 能力、Owner 与文档
| 能力 | 当前 Owner | 目标与接入规则 |
|---|---|---|
| 会话、创作记录、Canvas 与现有短剧聚合 | Studio 现有服务及服务端存储 | 私有产品聚合保留；不迁独立 Drama，不使用浏览器业务缓存 |
| 用户 Session、个人 Key、旧用量/积分 | 当前 Studio 服务 | 按具体 facade/命令移交 Identity、Console 接收面或 Core；迁移完成前保留唯一 Writer |
| 公开创作模型与生成入口校验 | Studio 现有配置/服务 | 区分 web/api/internal；未来采用固定 Core Offering，不直连私有 Gateway |
| 生成任务、取消、重试、恢复 | Studio 既有任务服务 | 后续逐命令迁 Core Run/Execution；在途任务由原 Owner 完成，禁止双创建 |
| 媒体、素材引用与删除保护 | Studio 现有资产/媒体服务 | 后续稳定 Asset/Version/Lineage 接入；引用不变成下载重传副本 |
| 扣费、退款与预算 | 当前 Studio 账务服务，目标 Core Billing | 先冻结命令、幂等与结算归属，再切换；UI 不计算第二余额 |
需求与设计时同步列出每个公开动作的 API 能力和字段来源。文档必须分别描述创作请求、Agent Run、媒体任务、历史分页、取消/重试/恢复、媒体权限与错误；注明内部与公开字段、幂等身份、异步状态、调用结果与资产登记差异。真实迁移接口只有在 Owner binding 固定后才标正式，旧新路由/Writer/在途任务/回滚表与文档一起更新。
阶段输出与依赖
- 需求：确认两条主旅程与保留清单、模型发布面、原型边界和迁移候选；不把正在改动的工作树当成已接受版本。
- 设计与原型：在已核验存量界面上补页面/状态矩阵、跨平台入口与首条媒体链，产出 API 需求草案；无真实新身份或 Core 仍可评审交互。
- 最小开发：先完成经确认的本产品缺口，再选择一个已具备契约的迁移命令；模型调用授权与低风险外观修改分开验证，不能靠 UI 隐藏做权限控制。
- 验收切换：实际生成/恢复、历史/媒体归属、拒绝前无副作用、Canvas 与
/drama保留回归；接收端、身份和真实数据链通过后再退旧入口，原型通过不授权切流。