games-development-ai/docs/agent-specs/2026-06-17-开闸-一句话入口接线-review.md

开闸 · 一句话入口接线 + 放种子(review 版)

状态:review 版(待创始人 2 轮评审)· 2026-06-17 · 6c6g 出 · 开闸路径首件(创始人裁定开闸优先于产品主线 P)。 目标读者:创始人决策。结论先行,低认知负荷;不含代码级细节(execution 版再展开)。 分工:6c6g 出 spec + 独立 review + mini-desktop 真机验;Mac 实现后端接线;studio session 接 Create.vue(见 2026-06-17-多session分工与任务总账.md)。

---

1. 结论先行

• 后端生成引擎 + feed 已就绪并真验:submitGenerate + D12 控制面 + GP9 合规 + SAA 一句话生成(R3 真库验)+ admin 审核台 + feed 翻转(B1)全链已通。开闸的唯一工程堵点 = 创作页"迁移空窗"。
• 病根:Create.vue 整条创作流硬门控在"先选模板"——canSubmit = 选了模板 ∧ prompt非空,onSubmit 先建草稿(templateId 必填)再 generate(带 templateId)。而 W-CLEAN 已废玩法模板层 → template/list 返空 → 无模板可选 → 「开始生成」永禁用 → 一句话创作主链结构性断。
• 接线 = 把创作流从「模板驱动」改成「一句话驱动(generic 生成路)」:三处协同——契约 templateId 改可选/默认 generic、Create.vue 去模板门、后端 project.create/submitGenerate 接无模板(generic 路已 template-free 且 R3 真验)。改动小、向后兼容、风险低。
• 放种子三件齐:本接线(studio+backend)∧ 2 安全洞收内网(ops)∧ labels.json(founder 亲玩)——各属一资源类,缺一不可。

2. 现状(已接地 · file:line)

环节	现状	出处
创作页	canSubmit = 选了模板 ∧ prompt非空;onSubmit 先 project.create({title,templateId})(必填)再 generate(prompt,templateId)	game-studio/src/views/create/Create.vue:53,104-116
W-CLEAN 空窗	template/list 返空 → 走"升级中"空态、无模板可选 → 提交禁用(诚实区分了"升级中"vs"加载失败")	Create.vue:162-169
契约	/aigc/generate 要 prompt非空 + templateId 存在;AigcGenerateReqVO=prompt+templateId;ProjectCreateReqVO required:[title,templateId]	contracts/api-schemas/aigc.yaml:38
后端生成路	generic/SAA = template-free(agent 写码,W-CLEAN 后主线),R3 真库验(dispatcher=saa 一句话→trace/readiness 落库)	R3 verdict
进度/发布	进度页 /create/task/:taskId 轮询已接(/aigc/task/{id});发布→feed 走 admin 审核台(链路② B1 已验)	aigc.yaml:55

一句话:不是要造新东西,是要拆掉一道已经没有钥匙的门(模板门)。

3. 目标 / 非目标

• 目标:种子创作者(白名单)输入一句话(无需选模板)→ 生成可玩游戏 → 入 feed 可刷可玩——护城河闭环对种子开放、可演示。
• 非目标(各自 spec,不混入):对话式修改 / 素材上传(= 产品主线 P)· 渠道发行 · 真实计费 · streaming SSE 进度(P2 增强,现轮询够用)· 玩法模板体系复活(W-CLEAN 已废,不回头)。

4. 推荐方案(最小接线集)

flowchart LR
  A[创作页·一句话输入<br/>去模板门] -->|prompt非空即可提交| B[POST /aigc/generate<br/>templateId 省略=generic]
  B --> C[submitGenerate<br/>配额/并发/GP9合规门]
  C --> D[generic·SAA 生成路<br/>R3 已真验·template-free]
  D --> E[轮询 /aigc/task/:id<br/>进度页已接]
  E -->|succeeded·gameId/versionId| F{发布门<br/>待确认 C1}
  F -->|admin 审核台·建议| G[PUBLISHED → feed]
  G --> H[种子用户刷 feed·真人试玩]

三处协同(契约先行):

• 契约(6c6g 轻 dev):AigcGenerateReqVO.templateId 与 ProjectCreateReqVO.templateId 改可选,缺省 = generic;/generate 描述 "templateId 存在" → "省略则走 generic 一句话生成"。向后兼容(老调用带 templateId 仍可)。
• 后端(Mac@game-cloud):project.create / submitGenerate 接无 templateId → 落 generic;复用已验 generic/SAA 生成路;控制面/合规门不动。
• 前端(studio session):Create.vue canSubmit = prompt非空(去模板门);模板区降级为可选品类/风格轻提示或暂隐;onSubmit 不再强带 templateId。

5. 关键权衡 / 待确认(请创始人拍)

• C1 发布门:种子创作者生成后 admin 审核台把关后入 feed(现状 B1,合规+质量兜底)vs 自助直发?建议种子期 admin-gated——GP9 已在生成前挡违规 prompt,审核台再过一道人/质门,放种子最稳;后续可加"就绪分达标自助发"。
• C2 templateId 去留:可选默认 generic(最小改、向后兼容)vs 彻底移除(契约破坏性大)。建议可选默认。
• C3 一句话之外:保留可选的品类/风格轻提示(非模板,纯 prompt 增强,帮用户起步、降空白焦虑)?还是纯一句话最简?建议留可选轻提示(不强制)。
• C4 创作者白名单:submitGenerate 现有创作者白名单校验(鉴权件 §6.3)——种子放量"谁能创作"的白名单口径?

6. 爆炸半径 / 兼容 / 风险

• 契约 templateId 可选 = 向后兼容(老调用不破);generic 路已 R3 真验,后端改动小、不碰控制面/合规门。
• 前端 Create.vue 属 studio session → 需契约协调(本 spec 定契约,studio 接线、设计体系 token 已就绪)。
• 风险低:无新生成机制,仅"解开模板门 + 走已验 generic 路 + 契约 templateId 可选"。回滚 = 契约/前端各自 revert。

7. 验收(6c6g mini-desktop 真机验 · money-shot)

• 主验:种子创作者输入一句话 → 真生成(generic/SAA)→ admin 发布 → 真入 feed → 真人浏览器试玩(e2e 全链,护城河可演示)。
• 门验:GP9 违规 prompt 被阻断;配额超限被拒;失败路用户可读提示 + 可重试。
• 兼容验:带 templateId 的老调用(若有)仍工作。

8. 分工 / 后续

角色	职责
6c6g	本 review 版 → 2 轮评审 → execution 版(file:line)→ 独立 review Mac 实现 → mini-desktop 真机验 + UI 走查
Mac	后端接线(契约 + project.create/submitGenerate generic 默认)
studio session	Create.vue 去模板门 + 结果/发布入口(契约协调)
配套(并行·非本 spec)	2 安全洞收内网(ops)· labels.json(founder 亲玩)

待创始人:拍 C1-C4 + 批 review 版进 execution。