历史 · Design 所有权与迁移

历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。

当前维护源为既有 Oceanway-AI/Oceanway-design 的 design-system/。 2026-09-09 的源码移交已合并：Design PR #2 与 Infrastructure PR #21。共享包未发布，产品消费者、旧入口移除和生产部署分别待验收。

本页保留原 infrastructure-ownership 路径以兼容已有链接，标题和正文按新所有权更新。原“永久在 Infrastructure 内维护”的安排已被取代；Studio/VOZEB 和 Infrastructure 的历史提交只作为迁移来源，不能继续双向同步。

当前结构

Oceanway-design/                    # 默认分支 baseten-ui
├── design-system/                  # 设计唯一维护源，独立 pnpm 工作区
│   ├── apps/components-lab/        # 独立实验室与平台规范分页
│   ├── packages/tokens/            # token、品牌资源与导出
│   ├── packages/ui/                # 通用组件和既有适配
│   └── tests/                     # 组件、来源、许可和包边界检查
├── src/                            # 既有根网站保留
└── …                               # 原资源、npm 依赖和 Git 历史保留

baseten-ui 继续为默认分支，krea-ui 与根网站历史保留。实验室有自己的依赖、锁文件、构建和 CI，不与原网站混装，也不把根网站的演示登录、价格、额度等功能当作正式产品。

当前包名为 @oceanway/design-tokens、@oceanway/ui 和 @oceanway/components-lab；版本 0.0.0 只用于私有工作区，显式禁止发包。跨仓消费者不能使用本地源码路径、Git 分支依赖或符号链接；未来接入只使用获准的固定制品。

职责分开

所有模块业务负责人和最终验收人均为用户本人；下表表示代码、规范和运行事实的责任分工。

模块	拥有	不拥有
Design	品牌、token、通用 UI、详细平台设计规范、独立实验室、设计包与检查	客户 Session、钱包、产品 API、领域 Store 和业务导航
Docs	架构关系、实施计划、设计决策/版本索引、历史资源说明和消费者接入记录	第二份详细设计正文、可编辑运行时 token 或实验室源码
Infrastructure	固定设计制品的托管、环境、发布、可观测与工程治理	设计源码副本、品牌/token 真源或产品页面
各产品	产品需求、页面、业务组件、真实交互、BFF 与服务调用	共享实验室、共享设计标准的第二维护源
Contracts	跨仓业务 schema、Service/Event、错误和版本契约	视觉 token、组件 props 或设计资产库

详细规范以 Design 固定来源为准；Docs 解释与链接，不再与 Design 同时维护同一段标准。已在 Docs 内置的历史品牌资源不会因此自动替换或从生产制品删除。

首轮需求、设计与原型

当前统一先做各平台的需求、设计与原型，按 Design 实施计划和统一实施流程交付页面清单、主用户链路、状态矩阵、组件/token 映射和可审查样板。无 UI 模块使用拓扑、时序、接口/配置 fixture。

实验室只包含分类/搜索、主题、状态、品牌和组件预览；不连接 Studio/Core/Gateway，不读取账户、业务数据库或 Secret。产品样板只保留无副作用展示，演示交互不写正式事实。已有实验室用于复用，不重复创建基础库，也不把原型确认当作发包或切换消费者的许可。

后续接入顺序

确认设计：统一需求、平台差异和原型，引用 Design 当前规范；旧主题/品牌试验保留历史标签。
确定接口：补齐组件 props/events、token/资源导出、版本、错误用法与消费者构建约定。
完成分发资格：核验来源与许可、可分发子集、完整资源、样式与摘要；完成不可变包验收。
单页接入：选择一个产品真实页面消费固定制品，验证样式、资源、状态与原业务行为。
扩展与退役旧入口：按产品扩展；旧实验室路由/菜单的清理与业务组件替换分开，只有回滚成立后才清理原实现。
更新记录：Design 维护实现与规范，消费者维护版本与验收，Docs 汇总状态，Infrastructure 记录发布证据。

这些工作由本机工作包协调，见本地协调。后续 GitHub 审查和发布用于归档结果，不要求先开远端任务才能分析或做原型。

当前进度与回滚

事项	已记录事实	不能推导
初次提取	Infrastructure PR #16 从固定 Studio 来源提取实验室及共享基础	Infrastructure 仍是长期维护源
正式移交	从 Infrastructure `6c23e831683ab8f3d5d93d816984c467ed216e5a` 保留 242 个文件到 Design；配对 PR 均合并	已发布共享包或已部署
固定目标	Design head `8456773288c05f4a5f65f0932fd47905e4f7f873`；合并提交 `898ba45f9cb5ef9bc1b96e37a2585bb47556b1be`	原网站被替换、默认分支改为 main
独立验证	记录 frozen install、格式/类型、63 项测试、构建与 390/430px 等本地浏览器证据	所有产品浏览器矩阵或根网站审计通过
品牌与平台规范	Design 保存 Enterprise v1/Inter 黑白正式应用规范、各平台分页和历史试验	旧 Docs/Studio/Console 静态资源已全部切换
待完成	许可与分发资格、固定设计制品、产品消费与旧入口清理、部署	通过文档更名就完成消费者迁移

来源与逐文件摘要见 Design 迁移记录。其中的准备态/待验收表述保留当时记录属性；当前是否合并以配对 PR 为准，发布与消费者状态另行核验。记录中的 63 项检查属于原移交验证，本轮文档计划未重跑。

原 Studio/VOZEB 与第三方组件的许可正文、来源和修改说明必须保留。所有权移交没有改变授权范围；可发布子集、消费者使用方式及商业授权由后续适用许可审核确认。确认前保持共享包不发布，不自动切换消费者。既有大 chunk 和 token 未全量单源生成等工程问题继续记录，不以本次计划重写掩盖。

回滚使用已验证的 Design/消费者版本；需要撤回移交时通过可追溯的新提交恢复，不重写历史或建立双维护源。不覆盖用户未提交工作，不回滚客户数据。