现行决策
所有仍然有效的决定、被替代的旧决定，以及待定事项
2026-10-15：Artifact/ResultSink与持久Agent免费纵切
独立Runtime已实现共同Job→文本Artifact→真实文件→产品候选/inbox回执，并由新进程验证丢回执后恢复原身份；同轮加固Studio v1逐工具observation、授权与停止后原单恢复。代码分别在Runtime PR #2和Studio PR #41审查，不改变D-RUNTIME-INDEPENDENT职责边界。
本轮证据区分免费fixture、脚本Planner、真实产品与生产门禁；GO只在开发清单登记。没有真实LLM/供应生成/资金写入、产品数据迁移或业务生产Writer切换。SDK/Panel、真实Studio接线、完整Workflow及正式Platform适配仍按后续包交付。下方首批“产物后续”是较早时点的历史回执。
2026-10-15：授权实施独立 Runtime，首批先交核心
用户确认按计划开始执行，并接受新建仓库。已建立私有Oceanway-AI/oceanway-runtime，首批在runtime/oceanway-runtime实现独立client/server制品、中性会话/Job PG核心和ports，提交PR #1。工作包实际状态只在开发清单维护，测试与范围见实现证据。
本批不交接线上Writer、不迁移产品数据；Platform纯媒体Run v2仅形成草案。Artifact/ResultSink、真实Agent、SDK/UI和产品接线按后续包推进。生产镜像/未终态/DDL漂移/备份恢复保持未核验，不能据17项本机PG测试认定生产G0或首期MVP通过。下方同日早前“尚未创建”记载为方案制定时点。
2026-10-15：各平台可嵌入共用Agent对话
D-AGENT-EVERY-SURFACE：用户明确OceanWay任何平台都可以加入Agent对话入口，整体结合Higgsfield与Krea的Agent设计。Runtime提供中性的AgentSession/Thread/Message/AgentRun、共同Job/产物、薄SDK和可选Panel；产品通过AgentSurfaceDefinition绑定Profile、当前页面上下文、获准工具和ResultSink。完整工作区、Canvas侧栏及Console/Admin等入口使用同一能力，按正式范围逐批验收。
设计借鉴Higgsfield的工具/Job/工作台分层和已观察的异步生命周期，以及Krea客户端的Session/Thread/Run、工作台上下文、稳定受理身份和正式控制命令。消息、Agent结束、媒体完成、保存和领域采纳分别记录；竞品正文/费用/私有实现的未证实边界保持。新消费者需Platform正式调用方/作用域/动作委托，不借studio身份；同账号不自动混合跨产品聊天或素材。现行自动资源核对和停止/UNKNOWN规则保持。详情见跨平台Agent对话与接入设计，此为目标要求，未实施所有入口。
2026-10-15：公共执行能力独立为 OceanWay Runtime
D-RUNTIME-INDEPENDENT：用户进一步明确，共用Agent应抽离为独立部分，接入各组件或平台，不继续以Studio命名。本方案采用 OceanWay Runtime 作为中性工程名，目标独立工程 runtime/oceanway-runtime（尚未创建），涵盖直接任务、Workflow、Agent、Tool、Job/Attempt、产物、事件与可复用媒体模块。Studio是实现来源和首个消费者，Drama、Commerce及其他获准组件通过SDK与领域适配接入。
从B1建立独立代码/合同/构建边界，先可由Studio同进程加载；再分批交接Runtime API、Worker和执行数据唯一Writer。客户端SDK/UI不携带数据库、调度器或供应凭据，Runtime不反向导入Studio/Next App/产品领域。领域对象、上下文权限、业务引用与候选采纳留产品；Platform保留身份、能力准入、Run授权、唯一资金、Operation及原供应结果。管理端等新消费者必须正式定义调用方与动作授权，不能借用studio身份。
本决定替代D-HIGGS-STUDIO-BASELINE中“共享底座长期归Studio工程”的目标，以及D-AGENT-PRODUCT-PROFILE中共享引擎固定放在Studio的实现位置。D-CREATIVE-ONE-APP的产品UI共仓/共部署可继续作为过渡选择，不能解释为Runtime必须附属Studio；三个产品是否拆仓部署不由本决定直接确定。旧Core/Edge/Contracts仍冻结。
现有线上任务、资产和授权按版本保护；抽离时采用兼容接管或排空，不将旧clean-module的直接改schema约定用于运行中的数据。切换/回退均保持单Writer与派发屏障。Studio先验、原型未完成、旧Admin/Console废弃及所有身份/资金/UNKNOWN规则继续有效。正文与工作包见目标架构、演进顺序和开发任务。本次为方案修订，尚未创建Runtime工程、迁移数据或部署业务代码。
2026-10-15：以 Studio 为基座建设自己的 Higgs 类平台
D-HIGGS-STUDIO-BASELINE：用户明确旧 Admin、旧 Console 仓已经废弃，不再考虑其迁移；当前创作产品只有 Studio，Drama、Commerce 仍是原型，目标是高效复用 Studio 代码。旧文档中的成熟多平台迁移叙事不再作为本轮执行依据。现行 Platform 内 Console/Admin 继续维护，与废弃仓分开。
用户要求基于复盘形成完整架构升级方案并更新本站，随后要求重点使用 REA 深查已登录 Higgsfield 的服务架构。已登记服务证据、架构与边界、演进顺序、任务和验收。这是方案交付，不自动授权执行所有业务变更、收费实验、商业规则或原型上线。
目标保留 Platform 身份/资金/模型操作权威；公共工具、Job/JobSet、资产、Workflow 与事件的归属由同日后续 D-RUNTIME-INDEPENDENT 调整为独立Runtime，Studio首接入；Agent、直接工具和 Canvas 作为不同调用方式复用，不因对标直接拆微服务。Studio 已有对象provider、真实Canvas和耐久Agent；当前关键差距是共享任务/保存对Agent与Studio对话的耦合、大文件数据面和typed媒体能力。直接工具改变现行强制规划的适用范围时，须先同步对应产品和正式契约；本次没有实施该行为变更。
2026-10-14 Studio先完成共享Agent的成果与执行本意保留，不重新激活早期Drama-first，不预设原型开发先后。Run自动核资源、无独立预算、退出/改密不撤销已授权Run、UNKNOWN只恢复原单等规则保持；产品本域商业运营不迁走，仍经受限Platform接口管理。
10-15具名线上证据已有Studio图文视频和Canvas，原P1/P2/P3“待实现”段落按当时时点保留，不能再作为所有能力尚未交付的当前结论；剩余能力和父T/AC分别验收。Higgsfield域名和客户端接口只证明逻辑边界，不证明其私有数据库、队列或部署平台。
2026-10-14：Studio 优先完成共享 Agent
用户调整执行顺序：先把 Studio 接到现有本机 Platform，完成 P2 Run 委托、P3 产品 Responses 与共享 Agent，并启动供用户验证；暂不开展 Drama 开发。D-DRAMA-FIRST 的执行顺序由本条替代，已有 Drama 文档与分镜实现保留。首份 Agent 配置和端到端验收改由 Studio 承担，共享层仍按产品作用域隔离，后续产品通过配置接入。
本次沿用下方已经登记的 Run 身份与资金规则：当前会话签发或继续；后续逐次以产品凭据和 Run 授权核验，不依赖会话或 AuthVersion；不冻结整次 Run、不设置金额预算；文本正式中断缺少可信用量时保持 UNKNOWN。只修改本机接入配置，线上配置不变。
2026-10-13：创作共享层、独立 Agent 与 Drama 优先
以下九项已经定稿，2026-10-14 开始按切片执行；它们是目标与约束，不能据此认定代码或 Platform 前置接口已经完成。执行依据为工作区 _knowledge_base/plan-shared-agent-drama-first-20261013.md。
2026-10-14 用户明确 Run 的资源判断应由系统自动处理：有足够的余额或适用权益即可发起，不足则提示。以下 Run 规则据此修订，取消用户填写、确认、追加预算和 Run 钱包支出上限/付费偏好表单；不建立隐藏的 Run 金额上限或按启动余额固定库存。既有单次调用与 API Key 的预算规则不在此次变更范围。
| 编号 | 决定 |
|---|---|
| D-STUDIO-DRAMA-RETIRE | Studio 现有短剧生产线直接删除，不迁移到 Drama；关闭两者关系的待定项。指向独立 Drama 产品的 Host、作用域、摘要等引用保留 |
| D-CREATIVE-PG-ONLY（已上线数据兼容范围已调整） | 新代码只支持PostgreSQL，文件Provider随旧代码退出；早期clean切片可直接设计schema，2026-10-15 D-RUNTIME-INDEPENDENT要求已上线任务/资产按版本保留、排空或兼容接管 |
| D-AGENT-PRODUCT-PROFILE（工程归属已调整） | Agent引擎与产品解耦；2026-10-15 D-RUNTIME-INDEPENDENT将目标工程改为独立Runtime，现有shared/agent是提取来源；产品提供提示词/Skill、上下文、领域工具、候选写回规则和默认值 |
| D-DRAMA-FIRST | 下一步先完成 Drama 主流程和第一份 Agent 配置，再做 Commerce，随后迁移 Studio 自身并删除旧权威代码 |
| D-AGENT-RUN-GRANT | 用户在当前会话下发起 Run，Platform 自动核对余额或适用权益并签发授权；产品只持授权编号。后续每次调用在获准动作/模型、有效期和并发范围内由 Platform 原子核对资源、预留和扣费，不要求用户设置 Run 预算 |
| D-CREATIVE-MODEL-CATALOG | 模型由 Platform 陆续上架；工具从当前本人模型目录和 invocation_status 读取实际可调用能力，产品只提供默认值，不写死清单或迁入旧逻辑路由 |
| D-RUN-SESSION-INDEPENDENT | 用户退出登录不停止已授权 Run，Run 在授权有效期内继续执行，由 Platform 每次核对当时可用资源并扣费；修改密码和安全重置不撤销授权，余额或适用权益不足时暂停并保留结果 |
| D-CREATIVE-PLATFORM-BILLING | 计费、钱包、权益库存、定价和资源分配全部由 Platform 持有；产品与 shared 不保存资金权威、不计算费用或预算，只显示 Platform 返回的精确金额和状态，未知不填零，调用明细以 Console 为准 |
| D-CREATIVE-STOP-BY-CAPABILITY | 文本调用与整个 Run 可以通过正式命令停止，停止后不再提交新调用；图像、视频一旦提交不可取消，继续完成、扣费并保存。中途停止文本按 Platform 实际计费；P3 中断能力未就绪前，已发出的文本完整执行，停止只阻止后续调用 |
D-RUN-SESSION-INDEPENDENT 与 D-SSO-SHARED-COOKIE 同时生效。 退出仍结束同浏览器所有 Platform 登录会话，下一受保护读取重新校验；Run 授权是已绑定该用户的委托凭据，不依赖 platformLiveSession 或 AuthVersion。账号停用、产品访问或产品凭据撤销、用户停止和到期阻止 Run 新调用。资源不足是可恢复的暂停原因，补足后用户在当前会话下继续仍有效的原 Run；授权到期或撤销则需 Platform 重新签发。UNKNOWN 保留原操作占用并核对，不释放、不重发；整次 Run 不冻结资金，也没有剩余预算需要释放。
发起预检只判断当前执行条件，不保证未来未知的全部调用都有足够资源。每次调用由 Platform 按模型/规格/产品/有效期筛选适用资源，并在资金事务内重验实际可用量，覆盖并发消费、资源到期和后续充值。Console 展示 Run 状态、进度、暂停原因、关联调用的实际费用和资源来源，提供停止/资源补足后继续入口，没有 Run 预算编辑或追加界面。P2 先登记这些身份与资金规则，再实现正式契约；P3 中断缺少可信用量时保持 UNKNOWN 并显示“费用待确认”，不能补零或预估结算。
共用分层、三种授权和边界见共用任务与媒体。以下为10-13准备时点：P1产品媒体、P2 Run、P3产品Responses当时登记为待实现接口；10-15最新具名交接按本页首条与进度判断。P1 未交接先做文本和 Drama 文档/分镜；P2 或 P3 未交接，Agent 只做不涉及付费调用的准备，不借用户 API Key 或业务摘要授权继续调用。
2026-10-13：用户接受基础视频生成的验收范围
用户最新确认视频以“能够生成”认定可用。按这个范围，seedance-2.0-mini 的本次基础视频生成、原任务恢复、结果下载和统一记账已通过具名验证，不再把静音或精确像素/时长控制列为这项基础视频开放的阻断。原文件的非静音 AAC、864×496 和容器 5.088 秒事实保留；audio:false 被源 best-effort/StarFrame 省略的原因不变，基础可用不扩大为已保证静音或精确成片规格。
首批可按已验具名范围推进：gpt-image-2 单张1024×1024同步/异步及上述 Mini 基础视频。目录其余模型、图片编辑、Gemini原生、流式、更多素材/规格和实际秒/token销售计量是后续能力切片，不一概要求首批上线前全部完成。价格快照、唯一记账、原任务恢复、归属和结果授权仍须满足；目前需要完成正式媒体执行部署与发布、真实客户销售价、Admin/Console和标准HTTP调用贯通、生产媒体异常核对/原结果恢复及切换运维验证。
本条收敛 D-OCEANWAY-MEDIA-UPSTREAM 的视频验收范围，不改供应源或资金规则。现有真实证据和此前规格判断保留原时点；当前基础生成的通过结论以本条为准。尚未部署或启用生产媒体，PD-12旧资产政策及全量旧客户切换门槛保持开放；这与基础视频供给可用是分别判断的事项。证据入口为平台 docs/verification/T-06/oceanway-media-live-20261013/README.md。
2026-10-13：图像与视频统一接入 OceanWay 供应服务
D-OCEANWAY-MEDIA-UPSTREAM：用户要求开始图像、视频接入并先在本地调试，随后明确两类供应均使用 /Users/wangzihao/Projects/new-api-new-oceanway，服务部署在 pic-vps。对应服务为 new.ocean-way.top，源码与只读核对的运行 revision 均为 6484b5971ccb6c9c76ed78b6dfa2fe338bd992b0；文本继续走 uumi，不能混用另一 api.ocean-way.top 部署或旧独立媒体网关。该决定替代 D-MEDIA-DIRECT 中独立媒体网关作为本轮视频供应的安排，以及此前图片采用 uumi 的建议。
图像保留正常标准 POST /v1/images/generations：async 省略或 false 为同步，成功返回 200 Images 响应；显式 true 为异步受理 202，随后 GET 原任务。视频采用 POST /v1/videos、GET 原任务和 GET/HEAD 原内容。平台通过 image-openai、video-oceanway 执行器消费供应协议，客户操作、唯一记账、资金冻结、不可改写销售价快照与结果授权继续由平台负责；旧内部媒体任务契约可作为产品接入切片保留，不迫使普通 Images 客户端改成平台专用任务请求。
本轮视频只按成功且实际可交付的输出数量 count 计量，请求时长仅为供应参数，不冒充实际 seconds/token。没有原供应 ID 的未知执行不重新 POST，供应 failed 或一般 HTTP 错误没有明确无扣费证明时不释放。只读目录为图片 16、视频 5 个可见型号，完整服务 Key 仅本机私有保存，不进入自动测试；精确采购价、计费分组报价和公网 HTTPS 链路未确认。本地具名验证完成：媒体 service 140、媒体 controller 28 节点，迁移回归 147、文本 controller 回归 136 节点，各自 0 fail/skip，按各自套件范围引用，不累计为独立业务次数。真实生成、Admin 全工作流、UI 与生产切换未验。证据入口为平台 docs/verification/T-06/oceanway-media-local-20261013/README.md，本轮新增费用 ¥0，累计 ¥1.1679 / ¥30；PD-12 仍按用户决定后置，全量切生产仍 NO GO。
后续真实验收分项（同日）
D-OCEANWAY-MEDIA-UPSTREAM 不变。用户后续授权现有Key三笔真实生成：普通同步和异步 gpt-image-2 各一张1024×1024，seedance-2.0-mini 一笔480p/5秒/per_second；原任务/结果恢复、唯一资金和原账单具名通过。源管理员组无合同覆盖、两路由分组倍率1，按源人民币在线充值账面基准，两图各¥0.18、视频¥1.45，本轮¥1.81，累计 ¥2.9779 / ¥30、余¥27.0221。更底层现金采购/CRD成本未核；隔离销售每输出10quota是测试规则，非生产售价。
此验收没有改写生产开放条件。真实视频 audio:false 被源best-effort/StarFrame省略，结果有非静音AAC且为864×496、5.088秒；480p计费档位与5秒账单吻合不证明静音或精确像素/时长承诺。证据为平台 docs/verification/T-06/oceanway-media-live-20261013/README.md 及 README-video-parameters.md。live服务harness未启动Gin/Console，未部署或启用生产媒体；完整Admin/UI、其他组合和PD-12/旧迁移门槛继续开放，全量切换 NO GO。上段保留同日首次本地夹具时点。
2026-10-13：Studio 不再提供客户 API Key
用户要求开启 Studio 改造，并完全移除其中 API Key 功能。Studio 不再创建、取回、删除、认证、存储或迁入客户 Key，也不提供本地公开 /v1 中转；开发者 Key 和模型 SDK 入口统一由 Platform/Console 提供。产品保留本域创作和获准查询，使用当前用户授权及受限产品凭据接平台。当前迁移前生成所需的上游服务端凭据按对应模型切片交接，不将其当作客户 Key 或扩展产品权威。源码与验收范围见Studio 平台对接，不因 Key 删除关闭全部身份/创作/商业接入任务。
本页只列现在有效的决定。新增或修改决定时，在这里更新，并在进度记录里写明日期和原因；被替代的决定移到“已被替代”表，注明由谁替代。
2026-10-12：恢复 Studio 改造准备与分批接入
D-STUDIO-RESUME：用户确认 Platform 已调通且上线，允许开始考虑 Studio 改造。恢复 Studio 代码梳理、接入设计和首批切片准备，按身份与对象隔离 → 单次文本与原结果恢复 → 本域记录 → 媒体 → 资源/购买/运营的顺序推进。各切片使用已交接的正式产品契约，缺口归入对应平台接口任务；不再用一期全部平台待办作为 Studio 开工前置。
本决定替代 D-PLATFORM-BEFORE-STUDIO 中暂停 Studio 改造的执行安排。唯一身份、唯一账务及原请求恢复规则保持：接入桥开关不等于创作权威切换，切换须通过该切片的授权、账务和恢复联合验收。用户上线确认作为当前事实登记；既有部署记录及未验组合保留原时点和范围，不据此关闭全部 T-10 / AC-16。首批范围与源码交接点见Studio 平台对接。
2026-10-11：Platform 完成后再全面改造 Studio（执行安排已调整）
D-PLATFORM-BEFORE-STUDIO：用户要求优先完成 Platform，并准备好 Studio、Drama、Commerce 所需接口，再彻底改造 Studio。平台按已确认的一期范围收尾，完成 API、Console、Admin、身份、模型与计量、唯一账务、支付订阅、产品运营及恢复的适用验收；产品接入契约必须有正式实现、授权和故障恢复证据。企业等二期范围保持原安排。
当时先在 Platform 内用隔离测试产品验证受限调用、资源、运营与恢复接口，避免把 Studio 全面改造作为平台接口验收前置；Studio 默认关闭的接入桥、显式绑定和业务 outbox 保留为准备成果。平台交接清单见开发任务清单。暂停 Studio 的执行安排由上方 D-STUDIO-RESUME 调整，业务范围、既有证据及各能力实际开放条件保持。
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-PRODUCT-OPERATIONS | 用户要求Platform查看本人OceanWay全域业务使用、生成、消费、金额、订阅与活动；产品展示本域情况并独立运营专属套餐/活动，两处入口共用平台商业权威。运营归属、销售入口、权益范围和实际产品分开；产品保留项目/素材及可靠授权摘要。PL-021/T-13/AC-16，细则见产品运营；2026-10-10通用与专项编辑默认见D-COMMERCIAL-SHARED-USAGE |
| D-COMMERCIAL-SHARED-USAGE | 2026-10-10用户认可通用充值＋有限跨产品共享用量订阅＋按需专项商品，产品功能资格分别定义；管理端/用户侧按整体方案构建，新增PL-021.R08～12。可信收款/履约/售后分态，原资产/快照与PD-15/16保持；代码与业务验收未完成 |
| D-UUMI-UPSTREAM | uumi 保留，照常跟随 new-api 上游，不改代码；它继续服务模型对接客户，同时作为平台的文本上游 |
| D-MEDIA-DIRECT | 视频不经过 uumi；2026-10-13 的具体供应安排由 D-OCEANWAY-MEDIA-UPSTREAM 更新为平台 → pic-vps 的 OceanWay 供应服务 → 供应商，图像共用该服务 |
| 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-APP（Runtime归属已调整） | 原定三个产品共用现有Next.js产品宿主；2026-10-15 D-RUNTIME-INDEPENDENT确定公共执行工程独立，产品UI可暂共仓/共部署，后续各产品组织按具名切片决定；原型不是成熟平台迁移前置 |
| D-PRODUCT-STACK | 创作产品统一使用 Next.js 全栈 + PostgreSQL，以 Studio 为样板 |
| D-DRAMA-REBUILD | Drama 此前完成的是交互原型验证：保留已验证的页面和交互迁入 Next.js，样式逐步对齐 OceanWay 规范；后端整体按 Studio 的方式重写。产品规则以《漫剧工作台标准 1.7.0》为准 |
| D-ADMIN-SPLIT | Admin 是唯一管理入口，原生实现平台级管理（用户、钱包、价格、模型、订单、员工权限）；产品级管理（作品治理、提示词、生成记录等）留在各产品自己的管理页，从 Admin 跳转进入 |
| D-FIRST-LAUNCH-API | 首发开发者 API，目标客户是从 sub2api 迁来的零售客户 |
| D-SITE-CONTENT-ADMIN | 官网内容在 Admin 中调整，可以是 Admin 的一个部分，也可以发展成运营中台；该事项后置，首发不做 |
| D-FRONTEND-SOURCE | 2026-10-03 用户确认：用户端以已设计的 oceanway-console 为前端来源，保留设计与可用交互；管理端可基于官方 new-api 原有前端改造。旧 oceanway-admin 作为功能/工作流参照，不强制其界面迁入；两端接平台唯一会话、账务和接口，不恢复旧 BFF |
| D-CORE-EDGE-FROZEN | 自研 Core、API Edge、Contracts 冻结归档；Console迁入已设计前端、Admin按D-FRONTEND-SOURCE完成平台替换入口并验收后，原前端仓库归档 |
| D-DOCS-REBUILD | 文档按“先总后分”重建；旧文档整体归档、只读 |
继续有效的旧决定
2026-10-04新增文档治理决定 D-PLATFORM-PRODUCT-DRIVEN-DOCS：依据用户要求，平台补齐核心产品PRD，UI、交互、开发与测试围绕产品结果展开；沿用PL/T/AC、唯一模块规则和本仓OpenAPI/证据，补设计、追踪与缺口，代码不能反向定义需求。此决定不新增商业收费规则，不改变已有授权或业务完成状态。
| 编号 | 决定 |
|---|---|
| D-DUAL-PRODUCT-LINES | 开发者线和创作者线都要完成，可以分批上线 |
| D-GLOBAL-LOGIN | 在任一 OceanWay 产品登录，所有产品共享登录状态；登录和权限分开校验，普通用户不会因此获得管理权限 |
| D-CONSOLE-DEVELOPER-MERGE | 公开模型、价格和登录后的客户管理保留在 Console；文档与教程的归属由2026-10-04的D-API-DOCS-SEPARATE调整 |
| D-API-DOCS-SEPARATE | 2026-10-04用户要求Console不再内置接入文档，后续建设独立、详细完整的接入文档站；当前移除文档页面与入口，旧地址兼容跳转至Playground；文档站域名、上线及完整内容另行实施 |
| D-ADMIN-PHASE1-BOUNDARY | Console 是客户自己的后台，不是员工后台；媒体网关的供应管理后台独立使用，不接入 Admin |
| D-CUSTOMER-SEGMENTS | 客户分零售、FDE、模型对接三类，见产品全景 |
| D-UNIFIED-CUSTOMER-PLATFORM | 零售客户迁入平台并保留原价格待遇，之后 sub2api 退役；模型对接客户留在 uumi |
| D-CNY-CREDITS | 人民币充值，系统内使用积分；具体套餐后续确定 |
| D-BILLING-CONFIG | 2026-10-02用户明确充值、订阅、支付及模型计费均后台配置，复用new-api；周/月优惠订阅纳入首期，未配置完整的能力不上架。2026-10-08新销售方向由D-STANDARD-SERIES-PRICING规定，旧40元=100积分只保留为原时点值，不重估已有资金 |
| D-STANDARD-SERIES-PRICING | 2026-10-08：接入模型从真正提供商官方USD来源读取当前基价，默认名义1 USD=1 RMB=100积分；可调充值/报价换算及具名明确成员模型组倍率，0.4四折/1.5倍；同型号一组、未分组1，旧系列兼容但不叠乘。移除目录外、历史价格版本管理和价格对比；并发标识内部使用，已发生资金金额/快照不重估；细则见钱包与计费 |
| D-MULTI-RESOURCE-ENTITLEMENTS | 2026-10-07用户要求活动积分、可限定模型/规格的限时图片视频次数、邀请积分、订阅并行周/月积分限额和媒体次数，并完整承接旧sub2api用户数据及订阅权益；同平台统一记账/原操作，新增PL-020/T-12/AC-15；PD-15/16的分配/回退/可信结果计量/到期与原资源退款已按本轮继续实现要求确定；PD-12真实转换与旧客户运营承接仍需显式核对 |
| D-ENTERPRISE-ACCOUNT | 2026-10-02用户调整：一期全部个人用户；企业/FDE专属账户、逐客户基础/覆盖方案、协议价及绑定有效期移至二期，当前不开发；员工和产品角色、个人价格/充值/周月订阅照常完成 |
| D-TEXT-SINGLE-CHANNEL-MEDIA-PROTOCOL | 2026-10-07：文本同名多渠道/版本选择暂时搁置，每个文本模型仅一个渠道及接入绑定，保留标准模型名和协议；媒体能力与次/张/秒/token等计量单位分离。2026-10-13 普通 Images 与 Videos 入口按 D-OCEANWAY-MEDIA-UPSTREAM 接入，产品内部媒体任务契约保留，具体组合经 T-06/G-07 验收后开放 |
| D-KEY-ALL-MODELS | 2026-10-05：客户Key无分组、无逐Key模型白名单；一个有效Key调用全部已上架且开放的模型，按模型/规格/用量和个人标准销售价计费；上游凭据由后台配置，账户/Key有效性与资金限制仍校验 |
| D-ADMIN-ADJUSTMENT-SIMPLE | 2026-10-06用户要求账户资金的积分调整无需凭证编号和原因；表单/确认/结果只保留所选用户、方向及积分等必要信息，服务端自动留操作者/原请求/调整审计，旧显式字段与回执兼容；补单和退款继续核对原交易证据，权限/幂等/唯一记账不变 |
| D-KEY-COPY | API Key 列表中，掩码旁的复制按钮直接取回完整 Key 并复制 |
| D-UI-SHADCN | 界面基于 shadcn/ui，沿用 OceanWay 品牌风格 |
| D-UUMI-NO-CODE-CHANGE | 不修改 uumi 的代码 |
| D-UUMI-MULTI-KEY | 2026-10-05用户要求本站多个专用上游Key分别拉取不同类型模型；管理员动态新增/编辑/启停/轮换具名模型接入配置，页面不显示uumi品牌，不按每个Key写环境变量。服务Key密文持久化且只写不回显，首次动态保存明确接管旧部署配置，停用/解密错不回退；目录按模型显式绑定，发现/报价/调用共用该配置，客户Key仍不分组，未知执行不因换Key重发 |
已被替代
| 旧决定 | 原内容 | 替代者 |
|---|---|---|
| D-HIGGS-STUDIO-BASELINE / D-AGENT-PRODUCT-PROFILE（公共运行时固定归Studio部分） | Studio工程长期承载共用引擎与执行基础 | 2026-10-15 D-RUNTIME-INDEPENDENT：独立OceanWay Runtime，Studio首接入；历史实现与优先顺序保留 |
| D-MEDIA-DIRECT（独立媒体网关作为本轮视频供应部分）及图片采用 uumi 的建议 | 平台视频接旧独立媒体网关，图片建议走 uumi；开发者媒体仅使用内部任务协议 | 2026-10-13 D-OCEANWAY-MEDIA-UPSTREAM：图像、视频都接指定 pic-vps OceanWay 供应服务，并保留标准同步 Images 与异步入口；唯一账务与原任务恢复规则保持 |
| D-MODEL-SALES-PRICE（文本不同版本使用独立精确API模型名部分） | 2026-10-06提出Claude Kiro/官方Key等分别销售及不同模型名 | 2026-10-07 D-TEXT-SINGLE-CHANNEL-MEDIA-PROTOCOL暂时搁置文本多版本；模型价格透明度、媒体规格计价和默认全部开放规则继续有效 |
| D-GROUP-DOMAINS-SEPARATE（Key组与分组模型许可部分） | 2026-10-03要求独立Key组、获准关系及Key绑定，并以UG/KG/Key模型限制取交集 | D-KEY-ALL-MODELS：取消客户Key组与逐Key模型白名单，用户组不控制个人模型可用范围；价格/角色/充值/路由解耦仍有效 |
| D-RESTORE-FIRST-POLYREPO、D-POLYREPO-NEWAPI-STACK | Core、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-CONFIRMED | Edge 采集用量证据、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 项管理模块拆进 Admin | D-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-02 原生分组职责拆分
用户指出new-api将多种分组职责混入同一概念，源码确认会影响当前模型报价、充值优惠及后续订阅。登记 D-GROUP-DOMAINS-SEPARATE：平台客户分类、平台/产品角色、消费价格方案、销售许可、充值/订阅权益、网关路由及服务策略须独立管理；保留原生计费计算与配置基础，不沿用原生group共同命名空间作为价格和授权权威。改客户分类、Key策略或供应选路不能暗改同一销售规格的合同价，订阅购买/到期不能覆盖企业合同或员工权限。此为现行改造约束，未实现；完整边界与迁移验收见钱包与计费。
待定事项
2026-10-01 实施约束补充
本次根据用户“补齐缺失的内容”更新实施与验收约定，延续唯一钱包、共享登录和产品合仓的已确认决定，不表示代码已完成。模型与非模型统一记账、价格快照、持久恢复、产品委托作用域以及 Drama 项目/素材归产品工程，分别见钱包、身份、Drama 接入。第 1 阶段增加最小跨产品闭环，见验证清单。
图片和音频的供应入口尚未确认：建议经 uumi，但需先审计支持范围，不自动授权媒体网关扩展。产品长期结果的物理复制策略、网关保留期限同样待验证后定稿。目标归属见共用任务与媒体。
| 事项 | 影响 | 在哪里讨论 |
|---|---|---|
| 各产品子域名、其他受控主域接入与跨主域SSO交接 | 首个主域已定oceanway.tech；共享Cookie范围、授权回调、统一撤销与部署配置 | 身份与权限 |
| 产品服务凭据与实际部署身份交接 | 凭据头已采用key_id.secret；待各切片核对部署Cookie/Origin、用户首次授权、动作/协议及原操作丢失定位，服务凭据不能替代本人授权 | 身份与权限 |
| 图片、音频的供应入口与首期能力 | 建议经 uumi；未验证能力不开放，不绕过平台 | 模型中转 |
| 结果复制、引用授权与存储保留期限 | 网关供应对象与产品长期素材的交付边界 | 共用任务与媒体 |
| 超额、部分输出与长期核对的剩余验收/经营例外 | PD-15/16的资源分配、可信部分输出及UNKNOWN保留原占用规则已确定；具体真实供给、处理期限/负责人、运营例外和未覆盖组合继续分项核对 | 钱包与计费、资源权益 |
| 平台从 new-api 删除哪些模块 | 平台的代码规模和后续维护量；需要先做代码审计 | new-api 基线 |
| 积分内部映射与周/月套餐上架配置 | 2026-10-08目标充值1:100可调，标准价换算与系列倍率见D-STANDARD-SERIES-PRICING；旧40元=100积分保留历史，不重估余额；套餐配置不阻断开发 | 钱包与计费 |
| 零售老客户旧价保护的模型范围和期限 | sub2api 迁移 | 钱包与计费 |
| Commerce 八个工具的首期真实闭环 | Commerce 范围 | Commerce |
| 官网内容管理采用 Admin 内的一个部分还是独立运营中台（已后置） | Site 内容的管理方式 | Site |
| sub2api 零售客户的迁移时点和余额换算 | 迁移计划 | 路线图 |
2026-10-03 用户组与Key组一期独立管理（历史决定，Key组部分已被替代）
用户明确这是本期必须完成的内容，补充D-GROUP-DOMAINS-SEPARATE：用户组与Key组采用独立定义、引用、管理入口、绑定授权及审计，不以同名或空Key组继承用户组维持原生耦合。登记一期P0 PL-018与AC-13，关联T-04～T-09；一期全为个人用户，企业方案二期的决定不影响这项交付。计价、充值、订阅与迁移规则见钱包与计费。本次确认需求，尚未完成代码或业务验收。
2026-10-04：平台管理端与客户端同等重点
用户指出上一版核心PRD对管理端定义不足，补充D-PLATFORM-PRODUCT-DRIVEN-DOCS：Admin作为独立产品主线，完整定义员工职责、运营/用户/授权/销售/财务/订阅/异常/审计/配置工作流及独立验收；不能仅靠客户回读、原生接口存在或几张配置页宣布完成。总PRD增加23条管理端子行为，设计及AC-10专项同步，既有业务边界/任务状态保持。
2026-10-05 一个客户Key调用全部开放模型
2026-10-05用户确认：客户API Key没有分组，也不配置逐Key模型白名单；每个有效Key均可调用平台全部已上架、已开放且有有效价格的模型。同一模型/规格使用相同个人标准销售价，按实际用量结算。账户状态、Key归属/启停/额度/有效期、钱包与必要调用限制仍校验；用户组只作账户归属管理，不筛选个人用户的模型或售价。上游Key由后台按模型接入配置选择，供应渠道及采购价格留在uumi（文本）或媒体网关（视频）。未验收能力不开放。
D-KEY-ALL-MODELS替代2026-10-03的Key组/获准关系/绑定及分组模型许可要求。PL-003与PL-018、AC-03/13、UI-C05与UI-A07/A08及T-04～T-09同步调整；旧组和模型限制数据的兼容处理、契约与代码改造仍待实现验证，不以历史组测试证明新行为通过，原账务与价格快照保留。
2026-10-06：模型价格与销售版本
D-MODEL-SALES-PRICE：用户确认所有已开放模型默认对全部用户可用，当前订阅不解锁模型。保留独立模型价格页用于透明展示各模型价格；探索模型负责能力、示例和接入，充值与订阅负责资金购买。文本、视频、图像、音频按实际类型/计量及规格展示标准售价；Claude的Kiro、官方Key等不同售价作为明确销售版本并使用不同精确API模型名，不让隐藏供给切换暗改价格。管理员配置类型、系列、版本、公开列价与原生规格规则，保存后核对客户回读；仅列价不扩大媒体调用能力。关联PL-010.R01、PL-006.R01～02、PL-011.R08～12，T-07/08/09；媒体实际生成仍按G-07逐组合验收。
2026-10-07：文本单渠道与媒体内部协议
D-TEXT-SINGLE-CHANNEL-MEDIA-PROTOCOL：用户暂停此前文本同名多渠道及版本选择讨论，当前每个文本模型只提供一个渠道，避免在标准协议中新增版本选择。此前讨论的请求头、模型别名、多个入口及账户/Key调用偏好均不实施；具名上游接入配置仍可用于不同文本模型，不恢复客户Key分组。
图片和视频可以使用平台内部自定义协议。图片生成/编辑、视频生成、任务查询是能力或动作；按次、按张、按秒、按token是计量单位，不能互相代替。适用规则及规格由管理员发布，客户选择已发布规格，实际计量由后端从可信结果核对；token计量不意味着该模型是文本模型。管理员配置与客户估价/价格展示复用同一价格版本和单位，原操作快照及未知只查原任务保持。自定义客户端契约不改变上游供给边界：视频仍经媒体网关，图片仍待审计，不授权直接供应调用。关联PL-004.R01、PL-006.R01～02、PL-011.R08/R10、PL-013/014与T-06/07/08；具体媒体契约及执行验收仍属G-07，本次仅同步决定。
2026-10-07：D-USAGE-ANALYSIS 使用分析独立入口
用户确认记录页只呈现记录内容；消耗积分、次数等聚合统计移至独立“使用分析”页面。使用分析以每日消耗、调用次数两张图表为主体，合计置于图内，周期直接切换，详细筛选收进图标面板。沿平台本人使用记录与每日聚合只读接口，保持相同时间/模型/Key/调用方式/状态条件和UTC创建时间口径；费用只统计已结算，不将待确认任务视为零费用。新增Console侧栏入口，不改变产品归属、资金路径或任务恢复权限。关联PL-012.R01、UI-C07/C11/C13、T-07。
2026-10-07：统一多资源权益与旧sub2api保全
D-MULTI-RESOURCE-ENTITLEMENTS：用户明确钱包所展示的资源不止购买余额，还包括活动赠送的限时且可限定模型的图片/视频生成次数、活动积分、邀请返利积分、订阅积分的并行周/月限额及订阅媒体次数。平台须同时保全旧sub2api用户所有关联数据与订阅待遇，来源为用户指明的本地项目和la-vps2运行部署；本地版本/schema不能替代线上漂移后的事实。
这项范围扩展登记PL-020.R01～07 / T-12 / AC-15，详细规则见多资源权益。不同单位不相加，同订阅周/月共同限额不当作两份积分；模型限定福利只是其抵扣范围，不恢复Key模型白名单。继续单Go平台、唯一金钱钱包/统一原操作和来源快照，不在各产品另扣资源或按未知任务重做收费模型。此前“其他赠送/营销后置”不再排除本轮明确权益，官网CMS、现金提现和其余未确认营销保持原范围。
用户随后要求“按照这个逻辑继续完成”，按本轮提出的跨资源先到期、明确钱包上限/仅权益禁止钱包、Key标准价等值、可信成功输出计次、UNKNOWN原占用、原grant/窗口返还与续期不重置旧窗口策略实施；PD-15/16据此确定，完整规则仅在多资源权益维护。PD-12真实余额/待遇转换仍需显式批次政策，测试比例或审计字段不能替用户决定。旧7/30天并行窗口、已用量和原期限必须保全，旧已入钱包赠金不能重复转成grant；旧独立现金返利须保存原币种/状态，不能自动改为本期邀请积分。字段名USD不是美元结算证明，新40元=100积分销售比例不是旧全部余额的事实换算率。
本轮已有真实本地规则/消费/两端/订阅履约与受控迁移工具实现，隔离验收范围见平台 docs/verification/T-12/entitlements-implementation-20261007/report.md。本地授予和导入仅测试夹具，未迁移客户、真实兑换、收费调用或生产发布；T-12/G-16仍保留生产与完整运营阻断，原PL/T/AC按各自证据判断。
2026-10-10：D-COMMERCIAL-SHARED-USAGE 全域商业商品结构
用户认可“通用充值＋有限跨产品共享用量订阅＋按需产品专项商品，产品功能权益分别定义”，并要求整理全部订阅、支付、消费、积分和管理端/用户侧，作为代码构建依据。Platform统一交易、资源与记录，各产品继续本域经营；普通充值长期灵活，订阅提供期限内优惠用量，专项商品提供具体模型/规格/制作资源或真实功能价值。
端到端阅读入口为商业整体方案。首期构建默认：通用订阅一个30天有限额度覆盖段，API及获准产品共同消费；产品专项默认本域、跨域显式发布；同族当前单档、同档续购接续已付段、下期换档，周期刷新不等于自动扣款。原7/30并行上限、PD-15/16和既有订单/资源快照保持。具体价格/额度/范围仍配置化，不把研究案例或测试数字作为商品值。
新增PL-021.R08～12 / AC-16.A08～12，沿T-05/07/08/09/12/13构建，补商品类型与归属、独立可信收款/持久履约、真实订阅覆盖段、本人消费预检、次数/积分分摊差距、人工现金售后及两端闭环。支付、履约、退款分别可观察；现金退回、原使用冲销、权益回收和积分调整各自有原对象与权限。
本轮完成文档方案和追踪，新增业务代码及验收未完成。产品功能会员、自动续费、即时补差、复杂优惠叠加、无限量和未明确退款折算不因此开放；商户/供给真实验证、发布与客户迁移仍分别判断。