历史 · Oceanway-design 实施计划
重构前档案，仅供追溯，不作为新版本执行指令
历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。
仓库：Oceanway-AI/Oceanway-design。默认分支：baseten-ui。业务负责人和最终验收人：用户本人；本会话统筹，Design 模块承担设计标准与复用基础责任。按本地协调分配工作包，先在本机完成方案与原型，不要求先建 GitHub Issue。
目标与已有基础
Design 是品牌、设计 token、通用组件、全平台视觉/交互规范和独立组件实验室的唯一维护源。Infrastructure 的 242 个设计文件已迁入既有 Design 仓库，目标 PR #2 与源端 PR #21 均已合并；源码移交不等于共享包发布、消费者切换或生产部署。
design-system/ 使用独立 pnpm 工作区、锁文件和 CI。原根网站、src/、资源、npm 依赖和 baseten-ui / krea-ui 历史保留，不与实验室的依赖混装，不因本计划改变默认分支。根网站的登录、价格、额度、API Key 和企业能力是历史高保真演示，不是实际产品后端。
已记录实验室独立安装、格式/类型、63 项测试、构建和本地浏览器验收。共享包仍为私有工作区，尚未发布；来源许可、可分发范围、不可变制品与各产品消费者资格仍待完成。详细来源与边界见设计所有权与迁移。
需求确定
首轮与各平台同时盘点用户任务和页面，建立“共用基础 + 平台差异”矩阵。
| 需求对象 | 需要确定 | 交付物 |
|---|---|---|
| 公司品牌 | 正式标识、字标、深浅适配、静态资源与来源 | 当前决策/历史素材/待接入列表；不重新设计已确认 Logo |
| 通用交互 | 控件状态、密度、键盘/焦点、反馈、错误、加载与动效降级 | 共享组件与状态矩阵 |
| 平台体验 | Site、Console、Studio、Admin、Drama、Commerce、Docs 等主路径与布局差异 | 每平台任务、页面、状态和组件需求表 |
| 内部工具 | 实验室浏览、分类/搜索、主题、状态预览和设计规范 | 实验室页面清单；不接入客户会话和业务服务 |
| 无 UI 模块 | Core、Contracts、Edge、Gateway、Infrastructure 的读图和接口说明需求 | 统一图示、时序、接口与配置样板，不造业务页面 |
| 复用与交付 | 组件现状、许可、token 来源、包导出、消费者构建约束 | 可复用/需适配/待确认清单 |
用户确认基础规则与平台差异；设计资产的原始来源、已确认决定和候选参数分开标记。所有产品由同一用户负责，仍保持客户面、Workforce 管理面和内部 Workload 的体验与权限边界。
产品设计与原型
在既有实验室中组织可比较样板，不重新创建另一个设计库。设计交付包含全局基础、每平台信息架构、关键页面布局、组件状态、窄屏策略和用户流程。当前正式应用标识遵循 Design 的 Enterprise v1 原图形、Inter 字标与黑白适配；Ocean Air 动态环境仅用于 Studio，其他平台按自己的设计规范采用中性环境和适合的蓝色表达。
每个平台先提供 1–2 条主用户链路及关键页面，再补空/加载/错误/拒绝/成功/禁用和待确认状态。实验室负责通用控件及页面视觉样板；真实登录、项目、生成、钱包、资产和数据持久化由对应产品/Core 实现。原型数据明确标为演示，保存等操作仅改变本页内存，不让演示结果成为业务事实。
首轮验收对象是需求、设计方向与原型：用户能比较平台差异，确认导航、主动作、信息密度、状态反馈和品牌规则。桌面、390px、430px、浅深主题、键盘和 reduced-motion 都列入原型检查；实际原型检查尚未完成的项保留待验证。没有正式 UI 的模块交付可读拓扑、时序和字段示例即可。
组件接口、工具与文档
Design 不需要客户业务后台。后续实现围绕既有组件实验室、包构建与校验工具；仅当用户明确需要受控协作能力时才单独评估服务端需求，不默认建立账号、云端保存或设计资产数据库。
| 接口 | 后续设计内容 | 文档内容 |
|---|---|---|
| 组件 API | 导出、props、事件、状态、可访问性、主题与样式依赖 | 使用示例、错误用法、键盘行为、兼容和变更 |
| Token / 品牌资源 | 单一可编辑来源、CSS/TS 输出、摘要、资源解析 | 名称/语义、平台差异、版本和迁移；禁止另存运行时真源 |
| 实验室/构建工具 | 本地入口、预览 fixture、检查/构建命令、包边界 | 参数、输入输出、失败提示、适用运行环境 |
| 消费者接入 | 允许发布范围、不可变包、导出兼容、回滚 | 安装与构建示例、框架适配、许可与验收状态 |
详细规范维护在 Design 的 design-system/apps/components-lab/src/design-guide/content/，每个平台独立分页。Docs 解释跨仓关系并引用固定版本，不复制整份设计正文；业务 Service/Event 规范仍归 Contracts。组件 API 文档不等于对外 HTTP API 文档。
分阶段实施
| 阶段 | 交付物 | 退出条件 |
|---|---|---|
| 需求确定 | 品牌/组件/平台任务与页面矩阵、复用盘点 | 用户确认共用规则与平台差异 |
| 产品设计 | 平台布局、交互、状态、token/组件映射 | 每项设计有需求来源；未确认参数可见 |
| 交互原型 | 实验室样板、关键页面与状态流程、无 UI 图示 | 用户确认首批原型；本轮到此收口 |
| 组件/工具 API 设计 | props/events、token/资源、构建导出与消费约定 | 边界稳定，不引入产品 Session/Store/API |
| API 与使用文档 | 组件参考、示例、版本兼容、接入和迁移说明 | 与真实导出对应，规范源唯一 |
| 实现与联调 | 经确认的组件/样板、token 校验、固定制品和产品定向接入 | 先完成许可与制品资格，再验证真实产品页面 |
| 验收与发布 | 设计确认、组件/浏览器证据、制品与消费者记录 | 用户分别验收设计、发布和消费者切换；未发布保持私有 |
后续按“统一基础与平台样板 → 接口和文档 → 可发布子集 → 一个产品真实页面 → 扩展消费者”推进。设计资产移交已完成，不重复提取；旧产品实验室和既有组件的清理须在消费者接入与回滚方案成立后处理。
验收与风险
- 实验室独立构建，不依赖同级产品源码、登录、数据库或 Gateway；演示夹具不进入共享 UI 包。
- 品牌资源保留原字节与摘要；详细规范使用 Design 固定来源，Docs 中旧资源只记录当前已部署/历史状态。
- 组件检查包含状态、可访问性、样式资源、主题、窄屏和真实交互；单一样板通过不能替代全平台验收。
- 既有 Studio/VOZEB 与第三方组件许可记录继续保留；共享包发布和消费者接入前完成适用许可审核，不因私有仓或源码迁移自动放行。
- 根网站和
krea-ui历史保留；实验室结果不能扩展为根网站的安全/功能结论。 - 回滚使用上一已验证设计制品和消费者版本，不恢复两个长期维护源，不覆盖产品未提交工作。
实现与验收统一遵循实施流程。发布托管由 Infrastructure 按固定制品执行；本轮不发布共享包、不切换产品依赖、不部署实验室。