Drama 开发与平台复用指南

Drama、Studio、Commerce平级消费独立 OceanWay Runtime，分别保留产品规则和数据作用域。Runtime目标工程runtime/oceanway-runtime尚未创建；产品UI可先同一Next.js应用部署，公共运行时独立归属。Platform 是三款产品共同的身份、调用授权、钱包、计费和商业权威。开发 Drama 时，应先复用这些边界和已有模块，再实现漫剧领域；平台尚未交接的能力保留明确端口和不可用状态。

适用对象是Drama与Platform/Runtime集成开发者。2026-10-15更新： 原文10-14源码路径与分步接口状态保留历史；新开发按Runtime目标架构和接入顺序执行，早期Drama-first已被替代。本文以现行决策、平台核心 PRD和漫剧标准 1.7.0为依据。新目标不表示已完成迁移；身份、计费、商业规则和接口类型继续在各自唯一源维护。

开发前先确定的约束

1. 独立运行时、平级产品。 产品采用Next.js与PostgreSQL，经SDK/领域适配接入Runtime；可同工程部署，公共引擎不长期归属Studio。Drama 当前 Vite、独立 Node 服务和 File 存储用于保留原型行为与验收参考，不能演变为另一套生产平台。
2. 同一平台身份与钱包。 Drama 不注册第二个平台账号，不持有余额、支付或权益核销权威，不绕过 Platform 调用网关。产品服务凭据只能证明产品和动作权限，不能替任意用户创建收费调用。
3. 公共代码独立。 当前shared/是抽离来源；新通用行为归Runtime，Drama仅提供上下文、领域工具与结果接收适配。剧本、分集、分镜、候选与采纳属于Drama，不import Studio内部模块、不直接写Runtime表，不搬原型执行器或本地预算。
4. 一次真实调用关联一次原操作。 模型预留和结算由 Platform 完成。只持原请求凭证的 Worker 只能恢复；持 Platform Run 授权才可以继续调用，每次由 Platform 自动选择适用资源并核对当时余额或权益。模型成功后保存或解析失败，只恢复原结果，不重新生成或在 Drama 再扣费。
5. Studio先消费，领域随后验证。 当前仅Studio为已交付创作产品；先证明Runtime独立与首消费闭环，再选择Drama或Commerce。Drama候选切片为文档→分镜→视频段候选→选择下载，最终剪辑交外部工具；仅使用已正式交接的媒体与Run授权，不预设Drama/Commerce开工顺序。

上述约束关联 PL-001/002/004/005/008/013/014/021、T-04/05/06/12/13 和适用 AC-01/02/04/05/07/11/15/16；不另建第二套需求编号。

系统组成与数据归属

产品领域任务、Runtime Job/Attempt与Agent/Workflow实例、Platform Run授权/Operation、供应原任务分别持有自己的身份和状态，以稳定引用关联；一个taskId不能同时代表这些对象。更多规则见总体架构与共用任务与媒体。

现有代码如何复用

仓库和共享目录

以下目录是10-14既有共享方案与当前抽离来源，保留源码定位用途；不再是新公共运行时的目标归属。新结构见独立Runtime目录与接入件：

web/src/
  app/                    页面与 HTTP 入口；proxy 按可信 Host 分流
  shared/
    platform/             Platform 客户端与适配器，唯一发起 Platform 请求的地方
    runtime/              原请求状态机、生成服务、租约、幂等、恢复、outbox
    agent/                标准工具调用引擎、Run 授权、基础工具、上下文
    media/                上传、授权读取、结果保存、引用保护
    documents/            通用富文档能力
    ui/                   基础控件、任务状态、金额格式化
  products/
    studio/               Studio 产品规则
    drama/                剧本、分集、分镜、视频段和候选规则
    commerce/             Commerce 产品规则

公共模块接收“产品、平台主体、创作资料”作用域三元组，只来自可信 Host 映射或持久化任务，没有默认值；它不是调用授权。products/* 彼此不能 import；shared/* 不能 import products/、app/ 或旧本地权威模块；lib、services、components 不能 import app/；只有 shared/platform 发起 Platform 请求。规则先以 ESLint warning 登记基线，稳定后升级 error。画布、提示词库在实际出现第二个产品复用时再提取。

新持久层只用PostgreSQL，不恢复文件数据库Provider。10-14直接设计schema的clean切片约定不适用于已上线任务/资产；Runtime抽离按版本兼容、原身份接管或排空，沿切换协议保护在途与未知单。生成任务显式保存调用权威，不能用 creator_profile_id IS NULL 推断。供应商协议、支付渠道、资金算法及旧本地账号/积分/退款代码不迁进共享层。

业务 UI 不直接依赖供应协议或平台原始响应。公共客户端负责鉴权、传输、错误和原操作信息；领域适配器负责将结果登记为各产品的文档、素材或候选。

复用优先级

跨仓迁移完成前，以不可变契约制品交接；不依赖开发者机器上的相对源码路径、分支 URL 或复制 DTO。迁入同一个产品工程后通过内部模块共享实现，不拆多个 npm 包或独立服务。

Drama 已有行为参考的具体入口：

当前 Drama 业务适配器只允许指定的 oceanway_session Cookie，与平台可配置 Cookie 名存在接入限制；迁入共用客户端时按实际部署契约处理，不在各产品继续写死名称。

现有 platformBinding、ensureProjectBinding 和 workspace/tenant 类型保留旧共享 Project 模型。迁入时映射为产品内部项目与资料绑定，不要求 Platform 新建 Project、workspace 或组织服务。

现有 Studio 接入配置

以下变量用于已实现的接入桥与显式 Platform 文本链路。接入桥默认关闭，已有统一登录、创作资料、单次非流式 Responses 和原结果恢复分项，见 Studio docs/verification/platform-login-text-20261013/report.md；不能将启用开关当成全部媒体、Agent、创作与商业权威已切换。

Studio 新身份入口已采用可配置 Cookie、独立 creator_profiles 和平台主体，不虚构本地密码、套餐或余额。旧显式用户绑定仍按稳定资料保留，不自动合并；Drama 迁入后须复验本域对象与部署作用域。业务 outbox 的既有配置独立于接入桥，关闭桥不等于停止全部摘要投递。

平台身份与产品授权

请求链路

浏览器先访问产品服务端。服务端以已登记 Host 确定 drama，选择对应产品凭据，向 Platform 确认当前平台会话，再核验 Drama 对象访问。客户端传来的 userId、product、Run.userId 或存储 owner 命名空间都不能成为身份依据。

平台当前服务端产品凭据为：

X-Platform-Product-Key: <key_id>.<secret>
Cookie: <configured_session_cookie>=<current_user_grant>
X-User-Origin: <registered_drama_origin>
Content-Type: application/json

这是产品后端到 Platform 的示意，不放入浏览器请求或前端包。只转发唯一指定的平台会话 Cookie，不透传整套 Cookie/Header；服务端核验浏览器 Origin，并由可信 Host 映射选择产品。X-User-Origin 仅在已通过产品凭据鉴权时受理。

身份响应中的 data.user.id 是平台用户引用，data.session.sid 是当前会话；产品用 product_roles 等投影判断界面可见性，服务端仍核动作和对象归属。平台管理员或产品运营角色不自动获得项目私密正文和媒体读取权限。

默认契约 Cookie 名为 oceanway_session；当前部署、测试实例可能采用独立 Cookie 名或 host-only 范围。交接时固定实际 Cookie 名、Domain、Path、API Origin、产品 Host/Origin、登录返回和跨域方案，不能仅因 Console 登录可用就宣布 Drama SSO 完成。域名由配置管理，Drama 正式子域名不在本文自行确定。

创作资料采用显式平台用户映射。旧本地用户如被项目、素材外键引用，保留其稳定资料 ID 后再解除认证与资金职责；不按同名邮箱或用户名自动合并。切号、退出和撤权清理旧查询缓存，长连接在继续释放私密数据前重验原用户和 SID。

三种调用授权和 Agent 配置

执行上下文与 activityGrant 分别只说明作用域和授权业务摘要，都不能充当调用授权。Run 授权与浏览器会话无关：退出登录、修改密码和安全重置不撤销已授权 Run，Worker 继续执行不调用 revalidatePlatformCreator；用户重新登录后再获准读取进度和结果。账号停用、产品访问/凭据撤销、停止或授权到期阻止新调用；余额或权益不足时按 Platform 返回的原因暂停。

shared/agent/engine 实现标准工具调用循环、步数、停止和事件流，并根据 Platform 的资源不足原因暂停；grant 管 Run 授权编号，tools 调用共享生成服务，context 处理会话/引用/摘要。Drama 只提供 products/drama/agent/profile.ts、context.ts、tools.ts、apply.ts：提示词/Skill/默认值、按权限读项目、领域候选与用户确认后的预期修订写回，profile 不提供建议预算或默认金额预算。模型输出不可信，领域工具使用与界面命令相同的校验，注入文本不能越权写项目。工具从 Platform /me/models 与 invocation_status 选当前可调用模型，不写死清单，不迁旧规划列表或本地预算。

2026-10-14 用户明确这些消费判断应由系统内部完成。Platform 自动选择当时适用资源，按现行每次调用预留/结算与原操作恢复执行；Drama 不提供填写、确认、追加 Run 预算、总金额上限、钱包支出上限或付费偏好表单，不绑定首次发起时的余额/权益库存。发起前余额或权益不足提示原因，运行中不足则暂停并保留已有结果；用户补足后主动继续原 Run，由 Platform 再核资源，不自动重发 UNKNOWN。UNKNOWN 保持原调用资源占用，只核对原操作。

停止后进入“停止中”，不再提交新调用，等待在途图像/视频结算并保存，随后“已停止”，已有结果保留。所有金额只显示 Platform 精确值，未知显示“未知”，调用明细以 Console 为准。P2/P3 尚待实现和交接，当前只做上下文、事件、工具声明和纯本地夹具，不接真实 Agent 调用。普通 Platform 单次调用的既有付费设置及独立 Key 预算规则保持各自范围，本次不改写。

模型目录与文本调用

目录不是执行许可

模型选择保存平台精确模型身份及适用规格；当前文本每模型一个渠道及明确接入绑定。产品不设置供应 baseUrl、apiKey 或 channelId，也不建立逐客户 Key 的模型白名单。客户有效 Key 可调用当前开放模型，账户、额度和调用限制仍由平台校验。

当前 PublicModel 的关键投影包括 id、model_name、model_type、supported_protocols、invocation_status 和 price。invocation_status=price_only 仅可列价；协议、价格和实际可调用组合分别校验。price 中的费率已经包含销售倍率，产品不能再次乘 sales_multiplier。明确配置的字符串 "0" 与缺价、unavailable、依赖用量估价的 usage_dependent 分开处理。

价格的 usage_schema 描述规格和计量输入，不是完整生成能力 schema。工具调用、结构化输出、参考图数量、首尾帧、图生视频和上下文限制都需要独立能力交接，不能从模型名或价目推断。

产品文本委托

Drama 单次文本目标复用 Studio 已验证的 POST /api/platform/v1/relay/responses，要求当前会话、model:invoke 产品动作和受控 Origin。当前仅支持纯文本、非流式请求，字段白名单不含 tools。已有受限 Chat 委托保留其历史范围，不能直接把公共 /v1 任意参数搬入产品请求。

最小请求示例只使用当前契约和解码实现共同支持的字段，模型名替换为该部署已交接的精确模型：

{
  "idempotency_key": "drama-call-0001",
  "business_task_id": "drama-task-0001",
  "request": {
    "model": "<published-text-model>",
    "input": "请根据已确认输入生成分镜草稿。",
    "stream": false
  }
}

用户和产品由会话及产品凭据推导，不发送任意用户扣费字段。原业务任务、幂等键与嵌套 request 不可变，费用与用量由 Platform 确认。工具调用、函数结果输入、参考图片、流式与文本中断依赖 P3，当前示例不表示这些能力已开放。

先持久保存业务请求、幂等键和完整输入，再提交。收到 X-Platform-Operation-ID 后尽快持久关联原操作；接入客户端需要区分首次原生 JSON/SSE、重复请求回读、202 execution_unknown 和错误。流开始之后的错误可能作为 SSE 事件返回，不能只检查 HTTP 200。

公共开发者路径 /v1/responses、/v1/messages 和 Gemini 原生路径，与产品委托是不同入口。原结果支持多协议，也不代表产品已经可以发起所有协议。Drama 工具调用和多步 Agent 新调用等待 P2/P3，不能借用户开发者 Key、摘要 grant 或无会话请求替代。

当前请求字段存在契约偏差，见下文“接口交接缺口”。不要把字段直接从 Swagger 表单扩散到产品参数面板。

唯一账务与非模型收费

模型调用已经在 Platform 内完成授权、预留、用量确认及结算。Drama 保留业务状态和费用引用，不再调用本地预算服务扣一次，也不为同一模型调用申请非模型预留。模型成功而解析失败、候选登记失败或素材保存失败，不等于应自动退款。

金额与单位分开处理：人民币使用整数分，内部 quota 使用平台整数单位，展示积分使用精确十进制字符串。产品只格式化 Platform 返回的精确费用，不计算或预估最终费用，不固定充值比例或单价；金额未知显示“未知”，调用明细以 Console 为准。

非模型收费仅用于已批准、已发布的独立收费项。Drama 标准明确最终剪辑在外部工具完成，不因存在收费接口而新增成片合成或下载收费。

表中缩写 /operations/... 的共同前缀是 /api/platform/v1。创建非模型操作的最小字段为 idempotency_key、business_task_id、kind: "non_model"、item 和整数 quantity；不要提交自行计算的费用。原操作动作分别使用自己的幂等身份，重复必须保持相同输入。

后台只处理原已授权操作，不能仅持产品凭据指定用户创建新消费。价格变化、登出或租约过期不重写已发生操作的原快照。账务规则见钱包与计费和权益。

原操作查询以及 fact/settle/release 是受限服务端能力，部分路由只有产品鉴权，没有浏览器 owner 校验。产品 BFF 暴露本人操作视图前必须重新校验用户与对象归属，不能将这些服务端路由裸代理给浏览器。

任务身份和原结果恢复

持久关联

以下是产品任务需要表达的语义，具体字段按既有领域类型和迁入后的 schema 映射，不是新增 Platform DTO：

网络重连或 Worker 接管沿用原 Attempt、payload 与幂等身份；用户明确发起新的生成才建立新业务尝试和新的调用身份。领域 requestId、HTTP 追踪请求 ID、平台操作 ID 和供应任务 ID 分开记录。

Drama 当前 Run 状态为 planning/running/paused/completed/failed/cancelled，Task 状态为 ready/running/completed/failed/cancelled；与平台执行状态和业务摘要状态分别映射，不统一改成同一个枚举。平台多个标识最大 128 字符，Drama 部分原型标识允许 160 字符；适配时用稳定映射并保存原编号，不能静默截断造成碰撞。

文本原结果接口

Worker reconcile 的请求：

{
  "business_task_id": "drama-task-0001",
  "idempotency_key": "drama-call-0001"
}

该请求不能携带平台会话 Cookie，也不能含 user_id 等用户选择字段。读结果的 reconcile 不执行生成、结算、释放或退款；需要核对执行或资金时使用对应原操作恢复接口，两者职责分开。

结果在 data 中分别给出 execution_state、funds_state、result_state、status、ready。ready=true 才读取 response；当前 schema 包含原生 Chat、Responses、Claude、Gemini JSON 或完整已存 SSE 的表达，实际可读组合仍须核对部署版本。pending、unknown 可返回 HTTP 202；unsupported、unavailable 或正文不完整不得当成空文本成功。

Platform 的 result_state=saved 只表示平台保存了原结果，Drama 仍须记录自己的解析、素材或文档保存状态。成功结果保存失败时，Worker 读取原结果并幂等登记，保持原输入指纹与费用。

图片视频和共用媒体

平台媒体接口现状

当前平台媒体契约源是 docs/openapi/platform-media.fragment.json，已合入 platform.json：

媒体主资源下包含 GET /requests/{request_id}、GET /{id}、POST /{id}/refresh 和 GET /{id}/outputs/{index}。GET 状态只读，refresh 查询原供应任务并恢复适用的原结算，不能新增生成。

Drama 的完整产品媒体提交、查询、结果读取和无会话恢复委托仍须交接。 现有客户接口不具备同样的产品主体和来源语义，不能绕到用户 Key 路径替代。当前真实媒体供给与可信计量/恢复仍有门槛，图片、音频各能力按单独验收开放；价格可见或预检成功不等于生成可用。

P1 要交接两种入口：当前用户调用凭据支持提交、按原请求找回、读取、refresh 和按序号读输出；只持原请求凭证的无会话 Worker 只能定位/核对原任务和读取原输出。复用现有媒体服务、原价格快照、唯一账务和恢复；不提供媒体取消接口或按钮。P1 未就绪只完成共享文本与 Drama 文档/分镜，视频段候选及选择下载等待交接。

当前媒体请求包含 request_id、精确 model、model_type、input、usage_budget 和 expected_price_version。input 已定义 prompt/specifications，但尚无完整参考资产、首尾帧或角色图契约；这些是 Drama 资产驱动生产的实际依赖，须随产品媒体委托补齐。平台状态响应通过原 operation_id 联查，outputs 当前提供 index/mime_type，由受限输出接口读取字节；产品不保存供应 URL 作为永久身份。

Drama 先保留生产媒体端口、任务快照和结果登记边界，并明确不可用状态。现有本地视频生成器具有测试媒体、音轨、尺寸、时长和 local provenance 约束；不能换一个外部 URL 就宣布生产适配完成。

长期素材的处理

1. 产品服务端确认用户、产品、项目及上传资格，创建受限上传记录。浏览器不持有存储长期密钥。
2. 上传完成后校验媒体类型、字节、尺寸/时长、存储引用和来源，再登记素材版本。未完成校验的上传不是可用资产。
3. 模型参考输入使用受限引用或该协议支持的受控媒体内容，不把存储密钥交给平台、网关或供应商。
4. 平台生成成功后，产品共用媒体模块获取原输出并登记长期素材，保存稳定引用、原任务、输入指纹与候选关联。
5. 保存失败只恢复同一个输出的读取与登记。是否复制物理对象、保存期限、原输出定位和部分成功计量以正式交接为准；供应临时 URL 不能充当永久资产。
6. 播放、下载和重新签发短期链接都重新校验作用域。删除业务引用、物理对象和停止 Run 分别处理，图像、视频任务不可取消；仍被候选、作品或在途任务引用的媒体不能提前清理。

产品视频输出遵循漫剧标准：结果先登记候选，正式选择由用户完成；下载原媒体后在剪映等外部工具剪辑。网关完成、平台结算、素材保存和用户选中分别表达，不能合并成一个“成功”。

全域摘要和可靠业务事件

Drama 保留项目和素材权威，Platform 聚合全域使用与消费。产品业务事务同时写入 outbox，Worker 获得平台持久回执后确认投递；断线、重启、重复或乱序投递不新增生成和资金动作。

当前事件基本字段是 event_id、business_task_id、activity_type、state、version、occurred_at；可关联 parent_run_id、activity_grant_id、真实 operation_ids、产品 source_call_ids 和 result_count。类型目前为 agent_run、generation、upload、import、save，不能自行新增 export 等枚举；导出可先保留本域审计，平台摘要扩展按契约交接。

occurred_at 使用 Unix 秒，version 单调增加。source_call_ids 是原 Run/Attempt 等产品编号，不是收费操作；没有真实平台模型操作的上传和保存不得伪造 operation_ids。摘要授权不是模型执行授权，后台多步 Agent 的下一次付费调用需要单独的正式授权依据。

平台按可信产品和 event ID 去重，再按对象版本更新。重复回执中的 adopted=false 要结合原事件身份与回读处理，不自动等于失败。后台发送前重验当前允许的产品凭据与原可信 admission，outbox 不保存 Cookie 或产品 Key。

一次 Agent Run 可以有规划、优化、生成多个模型操作，但仍是一条父业务任务。业务任务数、模型调用数、结果数量、标准价、实际积分支出和次数权益核销分别展示；费用未知不填零，读取失败不显示“未使用”。剧本正文、完整提示词、聊天记录、密钥和私密签名 URL 不进入全域摘要。

订阅资源和产品运营

三产品可以保留自己的套餐、活动、本域用量和后台运营页面。商品版本、订单、支付、履约、权益以及资金事实仍由 Platform 统一持有，产品不复制一份余额、订单或资源库存。

当前产品商业路由使用 /api/platform/v1/products/{product}，产品路径必须与凭据作用域一致：

产品订阅列表按运营 owner 过滤，不等于所有 Drama 可用资源：其他产品运营的共享订阅可能也适用 Drama，需另有最小适用资源投影，不把外域完整订单带进来。共享余额可以明确展示为全域值，本域消费必须调用受限本域查询。

只读消费预检不冻结资金，也不是执行许可；真正调用由 Platform 自动选择当时适用资源并重新原子核验。钱包不足时可能仍有适用次数或订阅资源，不用本地余额直接拒绝。发起前资源不足提示，运行中不足暂停并保留创作上下文和已有结果，按获准商品或 Console 充值入口补量后由用户继续原 Run；不自动重发 UNKNOWN。通用用量订阅、专项资源和功能资格分别展示，未验功能不能当会员权益售卖。

支付回跳不证明到账，支付成功不证明权益已交付；未知订单沿原订单查询，产品不重建第二订单。首期人工售后、现金退款和积分调整按平台规则分别办理。完整规则见产品运营和商业整体方案。

共享设计和用户界面

Drama 保留标准 1.7.0 已验证的导航、连续文档、资产区、助手和候选选择流程，迁移时逐步采用 OceanWay 的品牌、token、基础组件和状态规范。Studio 当前组件库与 Drama 原型不同，共享技术栈不要求立即重做全部页面。

设计源是 Design 仓库与工程设计规范。新公共 UI 按已确认的 shadcn/OceanWay 规范组织，同工程复用；跨仓采用明确版本制品，不直接引用本机 Design 相对源码。保留正式 Logo，不另建主题 token 权威。Design 内个别 Drama 页面仍保留独立项目描述，其视觉内容可参考，部署架构以现行合仓决策为准。

Design 当前 @oceanway/design-tokens 与 @oceanway/ui 两包仍为 private=true、版本 0.0.0，发布脚本阻断直接发布，不能当作已可安装的正式跨仓依赖。已有 OceanWorkspaceShell、素材/媒体浏览器、Agent 会话、OceanDramaEditor 和分镜卡片可评估复用，生成状态机和持久化仍由产品实现。采用前需交接版本化制品；Drama 稳定中性生产界面不因共享组件而整体继承 Studio 历史动态背景或材质。

建议先统一平台登录跳转、401/403/服务故障、任务状态、原操作恢复提示、金额单位、媒体授权过期和购买结果组件。加载、空数据、未支持、无权限、资源不足、部分成功、执行未知、可恢复保存失败、Run 停止中/已停止与结果过期要能区分；未支持不能呈现成零数据，不提供图像/视频取消。

开发时需要保留的公共端口

以下是产品工程内部的职责设计建议，不是已经发布的 HTTP 路由或可直接复制的 DTO。优先整理已有实现，避免为三个产品各写一套。

三产品后端使用同一平台客户端，允许每个产品独立的凭据、Host 映射和动作白名单。新增产品不应修改资金算法；接入新模型由 Platform/网关维护，产品只消费已发布能力。新产品共享素材、跨产品 Handoff 或增加业务事件类型，需要正式权限和兼容契约，不能靠“同仓”自动开放。

当前接口交接缺口

以下缺口影响实际开发，沿既有平台任务处理。实现中留出适配位置，缺口解决前不要建立替代认证、钱包或直连模型路径。

请求字段和响应需要对齐的项目

2026-10-13 工作树核对发现以下偏差，应在正式交接时同时修正 OpenAPI、实际解码、生成类型与 HTTP 测试；本节不改变产品需求。

现行源码依据是 Platform service/platform_relay.go、controller/platform_relay.go、controller/platform_operations.go、controller/platform_original_text_result.go 与 docs/openapi/platform.json。偏差被修正后更新本节，不维持永久例外或让产品绕过严格解码。

分批开发和验收

每批关联现有 PL/T/AC 的具名子项，记录实际部署/契约版本、通过场景和剩余范围。父任务不因一个切片完成而整体关闭。保留漫剧标准中的完整文档、用户选择候选和下载流程，平台接入不得改掉原业务要求。

最低联验包含：同用户 API 与 Drama 共用钱包、一次请求重复提交不重复执行、流或响应中断不重新付费、未知操作只核对、跨用户/产品拒绝、撤权后不新执行、生成成功但保存失败可恢复、事件事务回滚不漏发/多发、重复乱序不回退版本、媒体下载字节/来源可核对、仍被引用对象不提前删除。

交接材料与规范入口

给 Drama 开发者的每次接口交接至少包括：平台 API Origin 与部署版本、Cookie/域名与受控返回方案、Drama Host/Origin 和凭据动作、不可变 OpenAPI 制品及 SHA-256、实际开放模型/协议/规格、原调用与恢复示例、错误和未知处理、具名联验结果。Secret 通过受控配置交付，不进入本文、契约包或日志。

2026-10-13本机核对：Studio接入桥、业务事件及Commerce共享BFF已固化为本地提交 e18d1e6；Drama、Commerce仓库仍有未提交开发增量，不能只用各自Git HEAD表示本次接口内容。当前代码可供设计和联调，但本地提交不证明正式部署；对外接入需要固定契约制品和实际部署版本，转发快照通过manifest表达来源与指纹，不当作发布承诺。

现有 Drama docs/handoff.md、原型接入说明及部分 Design 页面保留了重建前的 Core/Contracts、平台 Project/IAM 或独立项目描述。采用其中的交互、版本和可靠提交行为时，领域归属与部署拓扑按本页链接的现行规则；不恢复已冻结的多仓平台方案。