统一开发者体验与功能增量
Console 合并 Developer Center 后的公开入口、客户管理与功能优先级
归档内容,只读,不代表现行方案。现行文档见文档总览。
2026-09-22 用户确认:按 Higgsfield 对照形成的功能方向推进;Developer Center 不再作为独立项目,全部并入 Console。本页是已确认的产品范围,完成状态见合并执行记录,不把需求确定等同上线。
产品与访问边界
同一个 products/oceanway-console 工程和 Console 站点承担公开模型资料、API 文档、教程、快速开始及登录后管理。Site 保留品牌与产品入口;Studio、Drama、Commerce 保留独立创作流程。Core/Edge/Contracts/网关职责不变;Docs 继续维护内部架构、实施计划与接口来源,不成为另一个客户门户。
| 区域 | 内容 | 数据与权限 |
|---|---|---|
| 公开区 | 模型介绍、获准公开的参考价、参数与协议说明、快速开始、API 文档、教程 | 匿名可读;独立公开字段白名单;不请求本人模型、协议价、Key、账务或身份摘要来生成公开缓存 |
| 账户区 | 实际获准模型、Key、调用记录、用量分析、余额订单、安全 | Core/BFF 服务端授权;退出、账户切换清理私有缓存;不能只靠隐藏 UI 隔离 |
| 关联体验 | 模型详情跳接入示例或本人记录;登录后返回原阅读位置 | 仅白名单同站路径与非敏感模型标识;Key 不进链接、示例源码或分析埋点 |
现行路径(2026-09-27):/models 是公开 Explore 模型广场,/pricing 是公开可读的充值与订阅入口,包含充值、订阅套餐和模型价目表;/models/pricing 仅兼容跳转到 /pricing,不再提供个人报价工具。/quick-start、/docs 为公开接入内容;/keys、/usage、/wallet、/account、/security 仍要求账户身份。模型开放与正式计费继续由服务端确定。
功能要求
| ID | 优先级 | 需求与验收要点 |
|---|---|---|
| CON-D01 | P0 | 合并仓库职责、导航与路由;公开阅读不被登录或身份服务故障阻断;私有路径仍强制授权;旧 Developer 文档有准确跳转,无独立执行目标 |
| CON-D02 | P0 | 模型分类、搜索、能力/协议筛选、详情介绍、参数限制、适用场景、参考价格与状态;只有实际验证的能力才标可用;公开资料与本人权限/价格分开读取 |
| CON-D03 | P0 | 快速开始串联建 Key、选模型协议、复制 Base URL/示例、首次成功调用核对;提供 cURL/Python/TypeScript 与普通/流式例子,标记实际验证版本;支持常见客户端配置指南;不自动发起收费请求 |
| CON-D04 | P0 | 模型价目表展示计费单位与公开价格;充值与订阅展示人民币、到账积分、周期与权益。取消独立个人定价、当前个人报价和手动报价快照页面;企业协议配置保留在后台,调用历史仍按当时实际单价解释;缺价不显示免费 |
| CON-D05 | P0 | 调用状态与结算状态分别展示;费用与 Token 明细继续沿用;补错误分类、请求耗时/首 Token 耗时和脱敏诊断复制,未知指标显示不可用,不推断为零 |
| CON-D06 | P1 | 时间范围、模型/Key/产品来源聚合、消费排行、成功率与 CSV;图表/汇总/导出同一筛选与时区;不平均相加不同计量单位,不在前端只汇总当前页 |
| CON-D07 | 正式收费前 | 人民币实付、到账积分、订单恢复、优惠明细、月度对账、企业账单资料;易支付/微信/支付宝商户与验证就绪后开放;发票申请与正式开票能力分别验收 |
| CON-D08 | P1 | 展示账户与 Key 限额范围、限流/并发含义、额度申请入口;低余额、预算接近上限、协议价到期提醒;阈值/频率/偏好、去重与发送失败可追踪 |
| CON-D09 | P0 总览 / P1 导航 | 新用户接入进度取真实完成事实;老用户显示消费、失败、余额与常用模型;帮助、文档搜索、服务公告、跨产品导航。未开放产品不能显示可用,站点切换沿用全局身份 |
| CON-D10 | P2 | 媒体任务状态、预览下载、结果保存期限、失败与费用关联;轻量调试器预留,先参数/代码/Studio 跳转;真实媒体验证仍按用户决定后置 |
同步要求与非目标
- Admin 负责公开模型资料与发布状态、客户价格依据、额度、公告与提醒规则;供应渠道仍归网关维护。公开发布字段不得含供应凭据、采购价或私有路由。
- Core 是价格、余额、订单、调用、任务与权限的业务事实源;Edge 补必要请求观测并沿用现有计费链。前端不新建计价引擎或镜像钱包。
- 企业首期仍为专属账户与协议价,暂不加入团队协作。自动充值、复杂订阅促销、竞品价格比较、AI 助手均不作为本轮前置。
- Key 保持点击掩码旁按钮再次取回完整值的既定行为,不改成只显示一次。
- 视觉采用 shadcn/Base UI 与 OceanWay 品牌;参考信息组织与交互,不复制 Higgsfield 促销机制、美元钱包或创作产品独立余额。
参考证据与限制
已查看登录后的 Dashboard、Pricing、Analytics、Billing及模型详情。观察到接入清单、当前客户价、用量趋势/排行/CSV、充值/账单资料、模型代码/参数/请求入口。参考账户没有调用数据,未验证其有数据的请求详情或支付执行;上述 OceanWay 错误诊断、时延、提醒与权限要求是自身需求,不冒充参考站已验证能力。