统一开发者体验实施计划
Developer Center 合并后的分阶段交付、接口依赖与验收
归档内容,只读,不代表现行方案。现行文档见文档总览。
目标与范围
在既有 Console 增量实现CON-D01–10。原 Developer 的 DEV-01–06 全部迁入,不再启动独立仓库或部署。原 CON-P01–08 的既有成果、身份、账务与 Key 语义保留。
需求、设计与 API 文档
采用同站公开区与私有区;模型列表偏向发现和比较,调用/账单偏向可筛选表格。用 shadcn 和 OceanWay token 组织,先确定字段、权限、加载/空/错误状态,再进行视觉优化。首轮无需大型独立原型工程。
已有本人目录、报价、用量和订单接口沿用;新接口先由 Contracts 固定公开字段、响应与权限,再由 Core/Edge 实现。下表是接口需求,不假称路由已实现;精确路由在契约切片中确定。禁止将 /api/user/models 或本人报价改为匿名开放。
| 工作包 | 对应需求与交付 | API / 数据依赖 | 退出与验证条件 |
|---|---|---|---|
| CON-D01 | 移除独立 Developer 调度;迁移需求/旧文档路由;Console 公开快速开始、文档入口与登录跳转 | 静态公开内容不依赖身份;私有入口沿用现有会话 | 匿名/身份错误仍能阅读;Key/账单深链仍进登录;账户切换不泄漏;旧文档无死链;本地构建通过 |
| CON-D02 | 公开模型列表/分类/搜索与详情;本人价格链接;Admin 公开元数据发布 | Core 公开目录/详情白名单、发布状态/分页/版本;本人目录与价格接口保持独立 | 匿名与两个不同价格客户的响应隔离;隐藏模型与内部字段不外泄;停用、缺价与未知能力如实展示 |
| CON-D03 | 基于同一模型标识的多语言/多协议普通与流式示例、参数说明、客户端指南;首次调用进度 | Edge 已验证协议、Core 获准模型;Contracts 示例版本;真实成功调用状态 | 每种展示组合有验证记录;无真实 Key 写入例子;未配置地址不造假;创建 Key 不按同名或首条猜 ID |
| CON-D04 | 我的价格、单位、协议有效期与费用估算;Admin 价格展示规则 | 现有客户报价/快照;新增公开基准、规则来源、有效期字段需契约核实 | 零售/企业不同价格同模型正确;估算不宣称最终扣费;旧账单不随价格变动;充值优惠和消费优惠不混算 |
| CON-D05 | 请求与结算双状态、错误说明、耗时/首 Token 耗时、脱敏诊断 | Edge 观测与 Core 操作详情;只增加所需字段,不读取供应商秘密 | 普通/SSE/中断/结算待恢复场景可解释;不可用指标不造零;诊断不含 Key、请求正文与供应凭据 |
| CON-D06 | 消费分析、模型/Key/产品聚合、时区与 CSV | Core 服务端全量统计与受控导出;明确已删除 Key、未知来源归组 | 分页总额不变;导出与筛选汇总一致;大数据有上限/任务机制;CSV 公式注入防护;客户隔离 |
| CON-D07 | 正式充值、订单恢复、月度对账及企业账单资料 | Core 正式支付/签名回调/重复入账防护;商户和商业比例 | 沙箱与正式区分;人民币实付/积分正确;金额篡改、重复回调、丢响应、对账均验;税务发票不能冒充普通收据 |
| CON-D08 | 额度展示、通知偏好、阈值提醒、额度申请;Admin 处置 | Core 限额/提醒配置、Worker 去重与发送通道;额度变更审计 | 账户/Key 限额层级清晰;同事件不重复发;不把上游容量当客户承诺;发送失败可追踪 |
| CON-D09 | 总览新老用户分流、常用模型/失败入口、文档搜索、公告、跨产品导航 | 已有总览事实,新增能力状态、公开文档索引与公告 | 从总览到费用/问题记录可回溯;空态引导可执行;移动导航可用;跨产品仍按资源和 Admin 权限校验 |
| CON-D10 | 媒体结果、保留期限与费用查询;轻量调试器/Studio 深链 | Core 任务与结果授权;媒体链路实测后开放 | 模型执行、结果可用、结算三状态独立;过期下载不假成功;不无条件重发收费任务 |
实施顺序
- CON-D01 先建立统一入口;CON-D02 与 CON-D03 完成模型发现和真实接入。
- CON-D04 与 CON-D05 完成价格解释与故障定位;CON-D09 总览随后消费这些事实。
- CON-D06 分析/导出、CON-D08 限额/提醒与帮助导航继续补齐。
- CON-D07 是正式收费闸口;商户与比例未定时继续其他内容,不能把沙箱开放给客户。
- CON-D10 媒体实测和结果能力后置;不扩大成新的创作平台。
联合验收与发布
Console 页面完成、Core 接口完成、真实联调、生产发布分别记录。公开内容须覆盖无登录、身份故障、登录/退出、账户 A/B 切换;协议示例须覆盖模型准入、普通/SSE 与错误;费用以服务端事实核对。
Site 链接在 Console 对应路径发布后切换;旧 ai.oceanway.tech 需核对实际用途才作跳转,不能仅凭新产品决定覆盖域名上的既有服务。远端旧仓保留历史,退出执行清单,本地骨架归档可恢复。
待定项
首批公开模型与公开价格政策、人民币到积分比例、企业价格期限、支付商户、通知渠道和支持入口的正式值仍需业务确定;不影响静态指南和现有私有功能。模型元数据、示例语言内容与状态来自实际实现,不用参考站模型目录填充。
进度、验证与下一动作见合并执行记录与 coordination/workboard.json;本页不累积完成日志。