OceanWay Studio 信息架构

本文细化 canvas.oceanway.tech 的页面与导航边界。站点拓扑、身份、钱包和共享服务的主规范仍分别以站点与产品拓扑、身份与多租户、统一客户控制台和共享内核为准。

四项已确认决策

1. canvas.oceanway.tech 是以当前 oceanway-vozeb 为代码基座演进的通用创作平台宿主；/canvas 才是其中的无限画布工具。
2. 图片、视频和音频是统一创作 Agent 的能力模式，可以有专用参数与结果交互，但不再被组织成三个独立产品。
3. AI 漫剧与电商工作台是独立垂直产品，已分别建立 oceanway-drama 与 oceanway-commerce；当前 Canvas 仓中的旧路由只是迁移来源，不改变其领域所有权。
4. console.oceanway.tech 负责全局账户、组织、Workspace、Project、资产、任务、钱包、订阅与治理；Canvas 只提供当前创作上下文中的摘要和操作。

这四项是本文件的前提，不再作为待决策项。

命名层级

“Canvas”在产品沟通中必须区分三个层次：

界面文案可以使用“创作平台”“画布”“画布文档”。代码和契约中不得继续用 CanvasProject 指代跨产品 Project；目标术语是 CanvasDocument。

当前态

当前 oceanway-vozeb 已经具备以下页面和能力：

当前代码中的“同仓库”和“同侧栏”不是最终产品边界。任何新增功能都应先按目标归属放置，避免扩大迁移债务。

目标态：页面结构

canvas.oceanway.tech
├── /                       创作首页：统一 Agent 与继续工作
├── /canvas                 画布文档库
├── /canvas/{id}            无限画布编辑器
├── /assets                 当前上下文素材与引用
├── /works                  Canvas 作品与发布管理
└── 产品内深链接             会话、Run、Asset、Document 与节点定位

创作首页

首页围绕“描述目标、提供参考、获得结果、继续编辑”组织：

• 普通 Agent、图片、视频和音频使用同一个会话与 Run 体系；
• 模式切换只改变输入控件、能力过滤、参数和结果呈现，不改变产品身份；
• 用户只看到适合当前模式且发布到 web Surface 的 Model Offering；
• 结果保存为 AssetVersion，并提供“在画布中继续”“引用到新任务”等后续动作；
• 页面恢复服务端会话和 Run，不使用浏览器本地业务数据作为事实源。

兼容链接可以预选创作模式，但其最终落点仍是 /。不得重新建设互相独立的图片、视频或音频历史、素材库、钱包与模型目录。

画布文档库与无限画布编辑器

/canvas 管理 CanvasDocument，不管理跨产品 Project。列表应使用当前 Organization、Workspace 和可选 Project 过滤，并展示最近编辑、协作者、版本状态与关联资源摘要。

/canvas/{id} 是完整无限画布编辑器：

• 编辑节点、连接、分组和视图；
• 引用固定 AssetVersion、Agent Revision 和其他授权资源；
• 创建 Run 并展示可恢复的执行状态；
• 将结果保存为新资产或新 CanvasRevision；
• 对跨产品来源提供可见的来源与返回动作。

素材与作品

Canvas 内的 /assets 是创作情境视图，重点是搜索、引用、上传和回到当前任务；Console 的全局资产页负责跨产品检索、授权、转让、保留与引用影响分析。两处必须使用同一个 assetId / assetVersionId，不能同步出第二份资产事实。

/works 是 OceanWay Studio 拥有的作品与发布体验，不等同于所有产品的资产总览。漫剧成片、商品渠道内容和 FDE 交付物仍由各自领域管理。

全局外壳与产品外壳

登录后的 OceanWay 产品共享一层稳定的全局上下文，但各自拥有专业侧栏和工作区。

全局外壳

Studio 顶部应提供或接入：

• OceanWay 品牌与应用切换器；
• 当前个人空间或 Organization；
• 当前 Workspace 与可选 Project；
• 全局任务、通知、钱包或预算摘要；
• 用户与安全入口。

这些入口只展示摘要并深链接 Console。组织成员、Workspace、Project、预算、购买、订阅、发票、Connection 治理等完整操作都在 Console 完成。

Studio 产品外壳

Canvas 自己负责：

• 创作首页、CanvasDocument、素材引用和作品；
• 当前会话、当前画布和当前节点的局部导航；
• 本产品 Run 的进度、失败、重试和结果操作；
• 当前任务需要的 Agent、模型和工具选择；
• 从来源产品进入以及返回来源产品的上下文提示。

不得为了减少跳转，在 Canvas 中复制一个“轻量 Console”并直接维护全局数据。

上下文切换规则

Canvas 页面始终在以下上下文中工作：

principalId
organizationId
workspaceId
projectId?
billingAccountId

交互规则：

1. 个人用户只有默认 Workspace 时可以隐藏层级，但服务端上下文仍然完整。
2. 切换 Organization 时，同时重新解析资产、Project、Agent、Connection、钱包和应用授权。
3. 切换 Workspace 或 Project 前，如果有未提交的画布工作副本，必须先保存、放弃或留在原上下文，不能静默迁移。
4. 深链接指向其他 Organization 时先展示组织和资源名称并要求确认，不能后台自动切换。
5. 创建 Run 前必须显示或可追溯“产物归属”和“费用承担方”。
6. 目标 Project 不可访问时返回可理解的权限处理路径，不自动降级到另一个 Project。

产品归属与迁移边界

即使漫剧或电商暂时与 Canvas 同部署，也应通过稳定资源 ID、服务契约和 Handoff 协作；Canvas 页面不得直接成为它们的长期主导航或事实源。

页面放置判定

新增页面先回答以下问题：

1. 用户是在完成通用创作，还是某个垂直业务流程？
2. 页面写入的是 Canvas 私有聚合，还是全局/其他产品领域对象？
3. 页面需要当前会话或画布上下文，还是需要跨产品治理视角？

满足“通用创作 + Studio 私有写入 + 当前上下文”的页面属于 OceanWay Studio。公开模型、文档、价格与状态属于 AI 公开开发者中心；需要管理 App、Environment、Service Account、Key、Playground、API 用量或 Webhook 的页面属于 Console /ai；需要 Episode / Shot 或 SKU / Campaign 状态的页面分别属于漫剧或电商工作台。

目标态验收

• 用户能明确理解 canvas.oceanway.tech 是 OceanWay Studio，而 /canvas 是其中一项无限画布工具。
• / 是唯一统一创作入口；图片、视频和音频不会形成三套导航、历史、素材或计费体验。
• /canvas 展示 CanvasDocument，界面和契约不再把它称作跨产品 Project。
• 漫剧与电商的入口、领域状态和主要工作流可在不依赖 Canvas 私有页面的情况下独立演进。
• Canvas 顶部能看见当前 Organization、Workspace、Project 和付款摘要，切换后所有局部资源同步刷新。
• 购买、充值、订阅、发票、成员与全局治理动作进入 Console；Canvas 不直接写对应事实源。
• Canvas 素材视图与 Console 全局资产入口对同一资源显示一致的稳定 ID、版本和权限结果。
• 旧开发者入口退出 Canvas 后，创作模型仍只使用经过 web Surface 和当前能力过滤的 Offering。
• 任意深链接、刷新和跨站返回都能恢复原业务上下文，且服务端重新验证权限。

延伸阅读

• OceanWay Studio
• Canvas 资源模型
• Canvas 跨产品交接
• 从 oceanway-vozeb 收敛到 OceanWay Studio
• 统一客户控制台