oceanway-developer-center 实施计划

ai.oceanway.tech 公开模型、API 文档、价格与开发者转化 Surface 的实施计划

仓库：Oceanway-AI/oceanway-developer-center。目标 Surface：ai.oceanway.tech。

目标结果与当前基线

本仓只交付公开 Developer Center：模型能力、API 文档、公开价格、示例、SDK/CLI 入口、状态和 Changelog。目标仓库已经建立，公开内容与文档生成可以并行建设。

Apps、Environment、Service Account、DeveloperCredential、Playground 私有执行、API Usage、Logs 与 Webhook 全部位于 console.oceanway.tech/ai；机器调用只进入 api.oceanway.tech/v1。

范围边界

负责：公开模型目录、能力/限制、API 参考、教程、迁移指南、价格与状态说明、从公开内容到 Console 的转化。

不负责：登录后控制台、客户密钥展示、私有调用记录、钱包、Provider Channel/Supply、内部模型、管理后台和公共 API 执行。

codex-auto-review、内部规划、审核和评测模型没有公开 Offering 时，不能出现在本仓生成的目录或搜索索引中。

依赖与输出

类型	内容
上游	Contracts Public API/OpenAPI、Model Offering 公共投影、Pricing/Status Read Contract
生成	API Reference 与类型示例从固定 Contracts Release 生成，不手工复制 Schema
跳转	登录/创建 App 进入 Console；实际 API 请求示例指向 API Edge
输出	独立公共站制品、文档版本索引、断链与代码示例测试报告

仓库里程碑

DEV-1 公开信息架构：模型、API、价格、教程、状态、Changelog 与 Console CTA。
DEV-2 契约生成：从固定 OpenAPI/JSON Schema 生成 Reference，标明 API 版本和废弃状态。
DEV-3 模型目录：只消费 surface=api 的已发布 Offering，展示能力、计价单位与限制。
DEV-4 示例与搜索：验证示例可编译、链接可达、版本可切换，内部字段不可被索引。
DEV-5 正式迁移：将 oceanway-vozeb 中公开开发者内容迁出并建立 Redirect，旧页面停止继续演进。

验收与切换

未登录即可阅读全部公开内容；任何私有管理动作都会转到 Console。
公开模型集合与 API Surface 发布规则一致，web 或 internal 专属模型不能泄漏。
文档示例固定到已发布 API 版本；尚未开放的接口必须明确标记，不能因 Schema 存在就宣称上线。
公开站不可读取 DeveloperCredential、请求正文、客户 Usage/Logs 或 Provider Secret。
迁移完成后，旧开发者路由只保留可验证 Redirect，不维持第二套内容事实源。

产品定义见OceanWay Developer，私有控制面实施见Console。