文档

现行决策

所有仍然有效的决定、被替代的旧决定,以及待定事项

本页只列现在有效的决定。新增或修改决定时,在这里更新,并在进度记录里写明日期和原因;被替代的决定移到“已被替代”表,注明由谁替代。

2026-10-01 架构重建确定

编号决定
D-PLATFORM-NEWAPI新建 oceanway-platform:以最新版 new-api 为起点硬分叉,删掉不需要的代码,此后以自主维护为主,不再跟随上游
D-PLATFORM-SCOPE平台包含 Console、Admin 两个前端,以及覆盖 Site、Studio、Drama、Commerce、Console 的全局登录与权限
D-SINGLE-WALLET平台持有唯一的积分钱包。Studio、Drama、Commerce 不存余额,扣费都走平台;Console 能看到用户在所有产品的积分和使用记录。Studio 上线时必须已和 API 共用同一余额
D-UUMI-UPSTREAMuumi 保留,照常跟随 new-api 上游,不改代码;它继续服务模型对接客户,同时作为平台的文本上游
D-MEDIA-DIRECT视频请求走“平台 → 媒体网关 → 供应商”,不经过 uumi
D-SSO-SHARED-COOKIE统一平台账号与会话权威;2026-10-02用户明确Studio/Drama/Commerce/Console任意站退出须结束同浏览器所有平台登录,下一受保护请求即时拒绝,首期身份不缓存;Site/Admin同规则。首域 oceanway.tech 下共享Cookie。2026-10-02用户要求域名配置化、支持后续独立主域(如oceanway.ai)免重输密码跳转;跨主域需授权交接与各域Cookie,具体协议待T-04验证
D-CREATIVE-ONE-APPStudio、Drama、Commerce 合并到现有 oceanway-studio 仓库,做成一个 Next.js 应用,按子域名分成三个子站,一次部署;Drama、Commerce 原仓库迁移完成后归档
D-PRODUCT-STACK创作产品统一使用 Next.js 全栈 + PostgreSQL,以 Studio 为样板
D-DRAMA-REBUILDDrama 此前完成的是交互原型验证:保留已验证的页面和交互迁入 Next.js,样式逐步对齐 OceanWay 规范;后端整体按 Studio 的方式重写。产品规则以《漫剧工作台标准 1.7.0》为准
D-ADMIN-SPLITAdmin 是唯一管理入口,原生实现平台级管理(用户、钱包、价格、模型、订单、员工权限);产品级管理(作品治理、提示词、生成记录等)留在各产品自己的管理页,从 Admin 跳转进入
D-FIRST-LAUNCH-API首发开发者 API,目标客户是从 sub2api 迁来的零售客户
D-SITE-CONTENT-ADMIN官网内容在 Admin 中调整,可以是 Admin 的一个部分,也可以发展成运营中台;该事项后置,首发不做
D-CORE-EDGE-FROZEN自研 Core、API Edge、Contracts 冻结归档;Console、Admin 的前端迁入平台仓库后,原仓库归档
D-DOCS-REBUILD文档按“先总后分”重建;旧文档整体归档、只读

继续有效的旧决定

编号决定
D-DUAL-PRODUCT-LINES开发者线和创作者线都要完成,可以分批上线
D-GLOBAL-LOGIN在任一 OceanWay 产品登录,所有产品共享登录状态;登录和权限分开校验,普通用户不会因此获得管理权限
D-CONSOLE-DEVELOPER-MERGE不设独立的开发者门户;公开模型、文档、教程和登录后的客户管理都在 Console
D-ADMIN-PHASE1-BOUNDARYConsole 是客户自己的后台,不是员工后台;媒体网关的供应管理后台独立使用,不接入 Admin
D-CUSTOMER-SEGMENTS客户分零售、FDE、模型对接三类,见产品全景
D-UNIFIED-CUSTOMER-PLATFORM零售客户迁入平台并保留原价格待遇,之后 sub2api 退役;模型对接客户留在 uumi
D-CNY-CREDITS人民币充值,系统内使用积分;具体套餐后续确定
D-BILLING-CONFIG2026-10-02用户明确充值、订阅、支付相关内容及模型计费均后台配置,复用new-api现有能力;初始40元=100积分、模型倍率1可调整;周/月优惠订阅纳入首期;配置具体值不阻断开发,未配置完整的能力不上架
D-ENTERPRISE-ACCOUNT企业首期使用专属账户和协议价,不做多人协作
D-KEY-COPYAPI Key 列表中,掩码旁的复制按钮直接取回完整 Key 并复制
D-UI-SHADCN界面基于 shadcn/ui,沿用 OceanWay 品牌风格
D-UUMI-NO-CODE-CHANGE不修改 uumi 的代码

已被替代

旧决定原内容替代者
D-RESTORE-FIRST-POLYREPO、D-POLYREPO-NEWAPI-STACKCore、API Edge、Contracts 分仓的多仓平台D-PLATFORM-NEWAPI、D-CORE-EDGE-FROZEN
D-NEWAPI-REUSE-FIRST、D-CORE-EDGE-PRIORITY从 new-api 提取代码到 Core/Edge,以 Core/Edge 为开发重点D-PLATFORM-NEWAPI
D-CORE-EDGE-USAGE-BILLING-CONFIRMEDEdge 采集用量证据、Core 迁入 new-api 计价代码并结算D-PLATFORM-NEWAPI:平台本身就是 new-api,直接读取上游响应中的用量计费
D-CONTRACTS-CONTENT-REPLACEMENT整体替换 Contracts 仓库内容D-CORE-EDGE-FROZEN
D-GATEWAY-UPSTREAM-BOUNDARY(部分)所有模型请求统一经 new-api 网关D-MEDIA-DIRECT:视频不经过 uumi
D-ADMIN-WORKSPACES-STUDIO-BASE(部分)把 Studio 的 26 项管理模块拆进 AdminD-ADMIN-SPLIT:只迁平台级管理
D-DEVELOPER-PUBLIC独立的开发者门户D-CONSOLE-DEVELOPER-MERGE
D-PRODUCT-REPOS(2026-10-01 当天修改)Studio、Drama、Commerce 各自独立仓库D-CREATIVE-ONE-APP
D-DRAMA-V2(待定项关闭)Drama 是否负责最终成片合成《标准 1.7.0》:最终剪辑交给剪映等外部工具,Drama 不做成片合成

旧决定的原文见归档中的决策与待定事项,原始决策日志保存在文档仓库的 archive/coordination-2026-09/decisions.md。

2026-10-02 充值、订阅与退款方向

用户确定普通充值初始40元=100积分,模型初始倍率1,首期支持更优惠的周/月订阅;随后明确这些以及全部支付相关内容均应可配置,复用new-api已有管理和计费能力。具体套餐与商户填值不阻断编码,开发负责原生字段/内部单位映射、人民币订阅适配、权限及统一记账验证,未配置完整的套餐或渠道不上架。异常消费暂沿用原生计费规则,修复重复扣款、未知重发等审计缺陷并保留持久恢复。退款由管理员控制,首期不开发客户自助线上退款或自动支付渠道退款。细则与验收事项见钱包与计费和决策清单。

待定事项

2026-10-01 实施约束补充

本次根据用户“补齐缺失的内容”更新实施与验收约定,延续唯一钱包、共享登录和产品合仓的已确认决定,不表示代码已完成。模型与非模型统一记账、价格快照、持久恢复、产品委托作用域以及 Drama 项目/素材归产品工程,分别见钱包、身份、Drama 接入。第 1 阶段增加最小跨产品闭环,见验证清单。

图片和音频的供应入口尚未确认:建议经 uumi,但需先审计支持范围,不自动授权媒体网关扩展。产品长期结果的物理复制策略、网关保留期限同样待验证后定稿。目标归属见共用任务与媒体。

事项影响在哪里讨论
各产品子域名、其他受控主域接入与跨主域SSO交接首个主域已定oceanway.tech;共享Cookie范围、授权回调、统一撤销与部署配置身份与权限
产品调用平台时的凭据形式产品如何代表用户调用模型和扣费身份与权限
图片、音频的供应入口与首期能力建议经 uumi;未验证能力不开放,不绕过平台模型中转
结果复制、引用授权与存储保留期限网关供应对象与产品长期素材的交付边界共用任务与媒体
超额消费、部分成功与长期待核对政策原账务恢复、客户收费和异常处理钱包与计费
平台从 new-api 删除哪些模块平台的代码规模和后续维护量;需要先做代码审计new-api 基线
积分内部映射与周/月套餐上架配置初始40元=100积分;套餐后台配置,具体填值不阻断开发;内部单位与人民币订阅由开发验证钱包与计费
零售老客户旧价保护的模型范围和期限sub2api 迁移钱包与计费
Studio 现有短剧线和 Drama 子站的关系(保留、合并还是下线)两者功能重叠;Studio 短剧线带 FFmpeg 成片合成Drama
Commerce 八个工具的首期真实闭环Commerce 范围Commerce
官网内容管理采用 Admin 内的一个部分还是独立运营中台(已后置)Site 内容的管理方式Site
sub2api 零售客户的迁移时点和余额换算迁移计划路线图

On this page