历史 · Ocean Foundation 复用与验收
重构前档案，仅供追溯，不作为新版本执行指令
历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。
本页记录 oceanway-vozeb 已构建、Studio 已继承的迁移来源与历史验收，
不将候选清单误写成全部生产可用。2026-09-09 后详细设计规范、共享实现、token 与独立实验室
均正式归 Design；Docs 记录来源和架构，Infrastructure 负责发布与治理。源码移交已合并，产品接入与旧入口移除分别待验收，
见归属与迁移。下列 Studio 路径保留为迁移前来源，不是新的消费入口。
独立 Drama 后续使用自己的项目，现有 Studio 内 drama 不在本轮迁出。
固定实现来源
核对快照：Studio d7b4ee8。
本地 oceanway-vozeb 有在途改动，不能用其当前工作区作为不可变制品或覆盖源。
| 内容 | 固定源码位置 | 本轮处理 |
|---|---|---|
| 组件实验室 | 入口与展示 | 历经 Infrastructure 提取后正式归 Design；产品旧入口独立退役 |
| 基础控件 | components/ui | 优先复用 Button、Input、Field、状态、Tabs 和媒体壳 |
| Ocean 组合与适配 | components/ocean | 保留材质、弹层、表格、布局与展示边界 |
| 候选 token 快照 | 原 JSON | 原版本 0.2.0-candidate，不复制为第二份可编辑规范 |
| CSS 主题 | global-ocean-air-theme.css | DOM 的现有浅深变量；品牌增量增加独立 ink |
| TS 调色板 | ocean-air-theme.ts | 保留 Canvas/OGL 等非 CSS 消费者 |
| Ant Design 映射 | app-theme.ts | 已存在，不作为从零开发事项 |
| 清单与成熟度 | component-manifest.ts | 沿用 readiness/reuse 分类，逐项评估 |
抽查实验室入口/展示、Ocean README、TS 调色板、Ant Design 映射、Button 和 JSON 与原项目文件一致；组件清单有差异，本轮不覆盖。此抽查不等于整个项目字节相同。
Token 映射与待收敛项
| 候选 JSON | CSS | TS palette | 后续处理 |
|---|---|---|---|
canvas | --ocean-air-background | background | 同一背景语义，保留名称映射 |
ink / ink-secondary | text / text-muted 前缀变量 | text / textMuted | 同一文字语义，不新增平行角色 |
action | --ocean-air-primary | primary | Ant Design 当前主色入口 |
action-fill | --ocean-air-action-fill | actionFill | 自有 Button 实心背景，不擅自合并到 primary |
edge | --ocean-air-border | border | JSON/CSS/TS 数值一致性校验 |
glass / material | --ocean-glass-* | 独立材质配置 | 与基础色分层，不强制非创作页面使用 |
| radius / space / motion | CSS/组件存在具体值 | 未全量单源生成 | 先登记角色与尺寸变体，不能宣称已消除重复 |
需要处理的真实差异：
- 原 JSON、CSS 和 TS 调色板仍存在手工同步；原 JSON 不包含全部运行时变量。
- Ant Design 主色与自有 Button 的实心动作色不同，需对照实际状态，不直接当作拼写错误修正。
- Canvas 主题已引用 palette，但仍有独立状态色和透明度，不能漏验 Canvas。
- 实验室材质控件展示值可有意不同于默认配置；必须区分演示状态和产品默认值。
brand.ink来自新 Logo 接入，与业务主题主色没有替代关系。
后续工作目标是让同义颜色在 Design 唯一来源下校验或生成，先确认各平台需求与原型中的差异； 源码所有权移交已完成，不重复提取或借此重做全站；共享包在 Design 内构建， 不允许跨仓相对源码导入、分支依赖或从 Docs 运行时下载 token。
实验室复用规则
- 基础组件必须展示默认、焦点、禁用、加载、错误、空态与选中状态中的适用项。
- Product Kit 的
built标签只代表视觉候选有实现；资产归属、API、钱包、Run、 鉴权、持久化仍由真实业务层负责，不从实验室复制合成数据到产品。 - 保留现有 Ant Design/Radix 的焦点、键盘和弹层生命周期，不重写第二套底层控件。
- 玻璃、指针与背景动效是可选装饰，继续检查 reduced-motion 和静态回退； 密集财务/运维页面不因共用组件而自动带入背景渲染器。
- Studio/Infrastructure 实验室记录只作为迁移前基线；当前维护源是 Design 独立实验室。对公网开放与访问权限另行评审， 不能因本地无需登录就宣称已有管理员隔离。
迁移前 Studio 验收
验收对象为上述 Studio 品牌分支上的原实验室，不是生产站，也不是所有业务页面。
验证流程：进入 /components → 浅深主题 → 基础控件/弹层 → 窄屏布局和品牌显示。
本轮不创建账号、不配置生产服务、不发起模型或计费请求。
2026-09-07 本轮检查：
| 项目 | 证据与结果 |
|---|---|
| 组件与品牌定向测试 | 11 个文件、46 项测试通过，覆盖 Foundation、清单、Ocean 适配、主题与 Logo |
| 已有颜色子集 | 使用 TypeScript 转译读取调色板、PostCSS 读取 CSS；42 项 JSON/CSS 和 40 项 JSON/TS 颜色映射通过，忽略大小写、空白与等值小数书写差异 |
| 桌面 1280×720 | 正确实验室标题与非空内容，无框架错误层；新默认 Logo 32×32；浅色黑标、深色白标，主题背景同步 |
| Dialog | 深色 Ocean Dialog 正常显示；Escape 关闭。关闭动画结束后再操作下一控件，不使用固定延时 |
| Filter / Table | 点击“进行中 1”后选中态为 true，表格只保留对应一行；错误态显示“加载失败/重试”，恢复后回到原筛选结果 |
| 手机 390×844 | 页面根宽度 390，无整页横向溢出；移动导航 288px，浅深切换后 Logo 正确黑白转换 |
| 手机 430×932 | 页面根宽度 430；Ocean Drawer 宽 340px、右边界 430，内容宽 338，无抽屉内容溢出 |
| 控制台 | 上述交互期间未捕获 warn/error；未触发生成或账务操作 |
仍需保留的差异和验收缺口：
- 移动导航 Logo 当前沿用 24px，小于素材说明的 32px 推荐尺寸；本轮记录为后续品牌布局复核项，未批量修改组件尺寸。
- 390px 能力工具条有局部横向滚动；它与整页溢出不同，仍需后续检查各业务 Surface 的末项可操作性。
- token 子集数值一致不等于全 token 单源；尚未验证全部透明叠层对比度、禁用态和所有动效偏好组合。
- 本次为匿名、无业务写入的实验室检查；服务状态显示“服务需要检查”，不代表后端健康验收通过。
- 未完成所有 Product Kit、真实登录/自定义 Logo、Canvas/视频/图片生产流程和其他仓库的浏览器矩阵；不把实验室候选数据作为这些验收的替代。
截图在本轮浏览器工具输出中展示，未写入源码仓库。设计冻结、跨仓消费及生产发布仍未完成。
Infrastructure 独立验收
以下保留初次提取时的历史验收，固定来源为 Infrastructure 888633d，不是当前维护源。 实验室已解除产品 Session、服务状态和导航依赖；30 项组件/提取测试、独立目录冻结安装与构建、 三种视口浅深主题、弹层/键盘/搜索、冷启动无业务请求及动效降级完成验证。 新入口的品牌统一为 32×32，不再沿用产品移动导航的 24px 品牌容器。
共享工作区尚未发布：React Bits 适配必须先审核再分发许可。独立应用成立不等于所有产品已消费共享包， 完整验收范围与剩余项见归属与迁移。
Design 正式承接
Design PR #2 与 Infrastructure PR #21 均已合并。 当前固定实现为 Design 8456773，保留 242 个来源文件与许可，新增独立 Design 规范分页。 原移交记录包含冻结安装、类型/格式、63 项测试、构建和本地窄屏/主题检查；本轮只引用该历史证据，未重新运行。 默认分支仍为 baseten-ui，根网站和 krea-ui 历史未替换。包未发布、产品消费者未据此自动切换；新平台需求与原型按 Design 实施计划确认。