OceanWay 公开开发者中心与 Console AI 专业空间的体验目标、设计范围和文档路线

开发者平台产品与体验设计

本目录把已经确认的技术架构转换成可讨论、可实现、可验收的产品设计。技术架构继续回答“谁拥有数据、请求怎样执行、网关怎样隔离”；这里回答“用户看见什么、从哪里进入、如何完成任务、出现异常时怎样理解和恢复”。

已确认的设计基线

ai.oceanway.tech
  公开 Developer Center：发现模型、理解价格、阅读文档、进入接入流程

console.oceanway.tech/ai
  登录后 AI 专业空间：管理 App、环境、身份、凭据、Playground、请求和用量

api.oceanway.tech/v1
  公共机器入口：接受 Developer Credential 或受限 Playground Execution Grant

这三个入口组成一个开发者产品，但保持不同安全边界。公开 Center 不因为用户已登录而变成客户后台；Console AI 不建立第二套钱包、组织或 Run；Public API 不接受浏览器 Session。

设计目标

OceanWay Developer 需要同时完成五件事：

让第一次到访的人在短时间内理解 OceanWay 提供哪些 AI 能力。
让开发者按任务和能力找到适合的模型，而不是在供应商 ID 列表中搜索答案。
让公开模型详情自然衔接到 Console Playground、代码接入和正式 Credential。
让个人开发者低成本开始，同时让企业管理员能够管理成员、预算、应用和生产环境。
让每一次调用都能回到可解释的 Request、Run、用量、费用和错误证据。

设计原则

原则	产品含义
一个公开承诺	客户只理解 OceanWay Offering、公开协议、价格和服务状态，不接触私有网关拓扑
一个客户控制台	登录后所有开发者管理位于 Console `/ai`，不在 Developer Center 复制后台
一个模型事实源	Center、Console、API 和状态页读取同一已发布 Offering Revision 的不同投影
一个商业事实源	列表价、合同价、预占、结算、退款和账本由 Billing 负责，页面不自行计算余额
先任务后型号	目录先帮助用户表达“我要完成什么”，再选择 Family、Variant 和 Offering
公开 ID 稳定	Provider、Channel、Deployment 和网关内部别名不得成为客户集成契约
试用即接入	Playground 运行真实公共契约，并能生成等价代码、Request 与 Run 证据
错误可以行动	所有失败都要给出稳定错误、关联 ID、费用状态和下一步，而不是只显示“请求失败”

体验分层

公开 Center 负责发现与评估，Console AI 负责试用、接入、运行和专业治理，Console 顶层负责跨产品组织、钱包、成员和账务治理。

核心用户与默认路径

用户	首要任务	默认路径
个人开发者	快速找到模型并完成第一次调用	Center 模型 → Console Playground → 默认 App/Environment → 创建 Credential
企业开发者	在已有组织和应用上下文中接入模型	Console `/ai` → 选择 App/Environment → Playground 或文档 → Credential
Developer Admin	管理应用、服务身份、环境隔离和 Webhook	Console `/ai/apps` → Environment → Service Account / Credential / Webhook
Billing Admin	理解 API 消费并控制预算	Console 账务总览 → API 用量下钻 → App/Environment/Offering
技术决策者	比较能力、价格、稳定性、数据政策和支持	Center 模型/价格/状态 → 企业接入或 FDE 咨询
支持与运维人员	用客户提供的关联 ID 定位调用异常	Admin Run Explorer；客户侧只暴露标准 Request/Run 信息

文档地图

第一批：已建立

文档	回答的问题
参考产品矩阵	OceanWay 分别向哪些产品学习，采用什么，明确拒绝什么？
公开 Developer Center	`ai.oceanway.tech` 首页、导航、转化和跨站链路如何设计？
模型目录分类体系	大量文本与媒体模型如何组织、检索、比较和展示？

后续详细设计

计划文档	设计范围
`model-catalog-and-detail.mdx`	目录列表、Family 页、Variant 详情、参数、代码与状态区域
`pricing-and-commercialization.mdx`	公开价格、合同价、套餐、充值、试用权益和失败计费表达
`playground.mdx`	文本流式、媒体异步、参数表单、输出、代码生成和执行授权
`apps-environments-and-credentials.mdx`	App、Environment、Service Account、Credential 的界面与流程
`requests-runs-and-webhooks.mdx`	Request、Run、日志、错误、用量、Webhook 和重放体验
`developer-docs-information-architecture.mdx`	快速开始、概念、SDK、API Reference 与模型文档的生成规则
`states-and-validation.mdx`	空态、加载、故障、权限、响应式、无障碍、埋点和验收矩阵

只有实际完成的页面进入本目录导航，计划文档不以空白占位页发布。

与架构主规范的关系

问题	事实源
三个 Host、Session 和产品边界	Developer Center 与 Console AI 信息架构
App、Environment、Service Account、Credential	应用、环境与服务身份
API Edge、Run、双网关和结果交付	公共 API 运行链路
模型层级、Surface 和发布生命周期	模型、Agent 与 MCP
价格、预占、结算、退款和账本	钱包与商业系统
内部诊断、Incident、Trace 与运维	管理员平台与运维控制面

体验设计不得重新定义这些领域事实。发现冲突时先回到架构主规范决策，再更新界面设计。

首期成功标准

未登录用户能够完成“理解能力 → 找到模型 → 理解价格与协议 → 进入 Console”的完整旅程。
大量文本模型进入后，首屏不会退化成不可理解的型号长表。
同一个公开 Offering 在目录、详情、Playground、代码、Request 和账单中使用稳定身份。
个人用户不需要理解企业治理即可完成首次调用，企业用户又不需要迁移到另一套产品才能获得治理能力。
Center、Console 和 API 任一界面故障都不会改变另外两个入口的安全与运行边界。
页面展示的价格、可用状态和调用模式都有来源时间与明确语义。

当前不做

不在这一阶段决定视觉品牌、配色、字体或组件像素规范；
不绘制高保真界面，也不直接修改现有 Web 页面；
不把外部参考产品的信息架构原样复制到 OceanWay；
不提前创建尚未讨论完成的 Console AI 页面实现；
不通过界面设计改变双网关、Developer Access Domain 或 Billing 的所有权。

开发者平台产品与体验设计

On this page