diff --git a/docs/architecture/架构/生成引擎/OpenGame对照.md b/docs/architecture/架构/生成引擎/OpenGame对照.md index dc8d2c05..80e57bbc 100644 --- a/docs/architecture/架构/生成引擎/OpenGame对照.md +++ b/docs/architecture/架构/生成引擎/OpenGame对照.md @@ -375,7 +375,7 @@ flowchart TB 上面 §3.1–§3.4 把"OpenGame 哪些设计值得抄、怎么落进 SAA 节点"按价值分了四类,那是**对照分析**。2026-06-22 把另一份决策记录(`docs/plans/2026-06-20-关闭九门判定-全面参考OpenGame-决策与Phase0-4.md`,创始人当天拍板、当天把 gamedef 做到 91.7%)的 Phase 路线回收进来,补的是分析之外的另一半——**一条有编号、有消融杠杆量化、有达标 flip 条件的执行序列**。两份口径不同:对照档回答"抄什么",这条路线回答"按什么顺序抄、每步能抬多少、抬到什么程度就切默认"。 -这条路线的**起跑线**,是验收口径的一次收窄,得先讲清,否则后面的 Phase 没有立足点:生成环的硬门已从"九门全过"收窄成"只认五道客观健康门 A–E"(A_boot/B_uncaught/C_frame/D_render/E_live),G_input/H_progress/I_control 三道 driver 依赖门降为不否决生成的参考门,F_wiring 移出客观硬门、改由 VLM 看截图判其"真用引擎/有特效"的语义。这一收窄是 gamedef 从 all-9 口径下约 50% 做到 **91.7%** 的直接原因之一(细节见 [验收门-W-G1 §2.4](验收门-W-G1.md))。把九门里"靠 driver 才判得了"的那几道暂时摘出生成环的否决权之后,Phase 路线要补的就是"用别的、更对的东西把那几道门的语义重新接回来"——这正是下面几个 Phase 的主线。 +这条路线的**起跑线**,是验收口径的一次收窄,得先讲清,否则后面的 Phase 没有立足点:生成环的硬门已从"九门全过"收窄成"只认五道客观健康门 A–E"(A_boot/B_uncaught/C_frame/D_render/E_live),G_input/H_progress/I_control 三道 driver 依赖门降为不否决生成的参考门,F_wiring 移出客观硬门、改由 VLM 看截图判其"真用引擎/有特效"的语义。这一收窄是 gamedef 从 all-9 口径下约 50% 做到 **91.7%** 的直接原因之一(细节见 [验收门-W-G1 §2.4](验收门.md))。把九门里"靠 driver 才判得了"的那几道暂时摘出生成环的否决权之后,Phase 路线要补的就是"用别的、更对的东西把那几道门的语义重新接回来"——这正是下面几个 Phase 的主线。 各 Phase 与它们各自的消融杠杆(数字是 06-20 当天实测的 Build-Health 增量贡献): diff --git a/docs/architecture/架构/生成引擎/WG1基准.md b/docs/architecture/架构/生成引擎/WG1基准.md index b33792ce..d4638be0 100644 --- a/docs/architecture/架构/生成引擎/WG1基准.md +++ b/docs/architecture/架构/生成引擎/WG1基准.md @@ -8,7 +8,7 @@ > > **W-G1 是什么**:它是"便宜模型造游戏"这条路线第一批真刀真枪的实测靶集(W = Wave 批次,G1 = Game 第一批)。这份文档是它的策展层主档,把一份调研产出整理成给人读的全景;它本身**未改任何运行时代码**,是一次只读的能力盘点。 -生成引擎主文档([README.md](README.md))讲的是"一句话怎么变成一款游戏"那条技术主线,验收门文档([验收门-W-G1.md](验收门-W-G1.md))讲的是"那条主线怎么对真实用户安全开闸"。本文讲的是第三件事:**开闸之后,我们到底拿什么去喂这台机器、又该期待它产出什么质量**。20 款经典游戏就是那批"考题",它们的覆盖判定和暴露的缺口,直接决定了批量放量时该先做哪些品类、又该先补哪层能力。 +生成引擎主文档([README.md](README.md))讲的是"一句话怎么变成一款游戏"那条技术主线,验收门文档([验收门.md](验收门.md))讲的是"那条主线怎么对真实用户安全开闸"。本文讲的是第三件事:**开闸之后,我们到底拿什么去喂这台机器、又该期待它产出什么质量**。20 款经典游戏就是那批"考题",它们的覆盖判定和暴露的缺口,直接决定了批量放量时该先做哪些品类、又该先补哪层能力。 > ## ⚠️ 实测后修订(2026-06-14 / 06-15 放量已跑完,务必先读) > **本档 §3 / §4 的覆盖判定与"4 类门面缺口"是一份 *实测前预判*;放量实测(scale-20,14 款真跑)已把其中的门面缺口判断几乎全部证伪。** 现行结论以 [`.agents/skills/cheap-model-game-generation.md`](../../../../.agents/skills/cheap-model-game-generation.md) §8–§9 与 [scale-20 短板量化报告](../../../agent-specs/_archive/2026-06-14-WG1-scale20-短板量化报告.md) 为准。三条要点: @@ -326,7 +326,7 @@ flowchart LR | `.agents/skills/cheap-model-game-generation.md` | 便宜模型造游戏的 worker loop、九门真玩 harness、design-agent 自产 gatespec、成本与模型选择、5 个坑(深落地权威源) | | `.agents/skills/game-e2e-cdp-harness.md` | Canvas 游戏 e2e 证据 harness:编排形态、driver 六规则、ship 红线、四件套证据(W-G1 复用) | | [生成引擎主文档](README.md) | "一句话怎么变成一款游戏"的生成主线全景(本文的上游) | -| [验收门-W-G1](验收门-W-G1.md) | 这条主线"对外开闸"要先架的 6 道门 + 两道开闸前置验证 | +| [验收门-W-G1](验收门.md) | 这条主线"对外开闸"要先架的 6 道门 + 两道开闸前置验证 | | [引擎与运行时](引擎与运行时.md) | LittleJS 增强发行版、插件库分层、运行时沙箱与边界模型 | > **纪律**:本档是 W-G1 基准的策展层 SoT——读它 = 当前真相。逐款落地与证据链在 `.agents/skills/`,决策史在 git 与带日期的源档里;两者职责不同,不互相重复。当现行真相与某份带日期的源档冲突时,以本档与它引用的最新裁定为准。 diff --git a/docs/architecture/架构/生成引擎/agentic运行时架构图说.md b/docs/architecture/架构/生成引擎/agentic运行时架构图说.md index 14cb9a5a..2c414259 100644 --- a/docs/architecture/架构/生成引擎/agentic运行时架构图说.md +++ b/docs/architecture/架构/生成引擎/agentic运行时架构图说.md @@ -234,7 +234,7 @@ L1 的主体是九门,每门在真浏览器里真玩一局取确定性证据:A_b spike 第二段放开让 agent 自产或扩展 driver 时,会撞上一个 Goodhart 雷:**写者不能写判自己游戏的那张卷子**——agent 既造游戏又造判它的 driver,会把 driver 写成只走它走过的路、只读不暴露真实力的字段,然后全绿假绿。隔离办法是拆开写卷人与判卷人,走三层:平台先按 schema 加白名单编译(非白名单或越界字段直接拒)、再交一个不向着被评对象、专找漏洞的独立 adversarial 评审(查它是否覆盖真实玩家路径、是否读了作弊字段)、三层全过才入验收。配套采两个指标:自产 driver 被独立评审打回的比例、driver 被修改的次数(防靠反复改 driver 逃避卡死探测)。 -> **本节是运行时视角的门与判定**;确定性验收门作为护城河的完整命题(机器判、禁自评、出题≠被考、W-G1 批跑、per-tier verdict 元协议)是独立 SoT,见 [`验收门.md`](验收门.md)。 +> **本节是运行时视角的九门与三层校验,确定性验收的护城河命题(机器判、禁自评、出题≠被考、per-tier verdict 元协议)即落在此节与 §三 A5**;另有一层"对外开闸放行"的 6 道门(D12 控制平面、GP9 合规先行、落库观测三门、首局体验门、G0/G1 前置)坐在九门机制地板之上,是独立 SoT,见 [`验收门.md`](验收门.md),其基准靶集见 [`WG1基准.md`](WG1基准.md)。 > **现 / 建**:廉价线九门现行已落、判过大量游戏;三层校验框架、tier2 三道专属门、Phaser 探针重写、自产 driver 三层隔离全部待建。 > 图:`assets/t2-D-01-三层校验全景.svg`、`assets/t2-D-02-九门逐门.svg`、`assets/t2-D-03-富游戏专属门.svg`、`assets/t2-D-04-advisory分级与Goodhart隔离.svg`、`assets/t2-D-05-CDP探针Phaser重写.svg`。 @@ -294,4 +294,4 @@ tier2 与 A-model(廉价线那条 LittleJS 轻量经营档)**两线分立、运 > **同步纪律**:本文是生成运行时架构唯一 SoT。设计一变动,本文与对应 svg 必须同步更新(并入 wave 收口清单)。被本文收敛、已退役的原文档在各自 tombstone 指针处指回本文。 > -> **相邻 SoT**:prompt / 配置治理 → [`prompt治理.md`](prompt治理.md);确定性验收门 → [`验收门.md`](验收门.md);数据护城河 → [`数据飞轮.md`](数据飞轮.md);能力框架调研对照 → [`OpenGame对照.md`](OpenGame对照.md);执行序列 → `docs/plans/` 下生成线执行 plan。 +> **相邻 SoT**:prompt / 配置治理 → [`prompt治理.md`](prompt治理.md);对外开闸放行 6 门 → [`验收门.md`](验收门.md)(基准靶集 [`WG1基准.md`](WG1基准.md));数据护城河 → [`数据飞轮.md`](数据飞轮.md);能力框架调研对照 → [`OpenGame对照.md`](OpenGame对照.md);执行序列 → `docs/plans/` 下生成线执行 plan。 diff --git a/docs/architecture/架构/生成引擎/prompt治理.md b/docs/architecture/架构/生成引擎/prompt治理.md index a8df336d..985a408a 100644 --- a/docs/architecture/架构/生成引擎/prompt治理.md +++ b/docs/architecture/架构/生成引擎/prompt治理.md @@ -1,3 +1,9 @@ +--- +topic: prompt-配置治理 +canonical: true +date: 2026-06-24 +--- + # Prompt 治理 · 生成引擎设计文档 > 🚧 **架构演进中** —— 生成引擎子树正处于 gameDefinition→`src/` 终态迁移 + 产线化(plan `2026-06-18-001` U1–U4)中,文中标注的现行结论可能随推进变化;以子树 [README](README.md) 与最新裁定 / plan 为准。 @@ -179,6 +185,8 @@ boolean validate(PromptTemplate) # 校验 frontmatter 与 sche **现行加载策略是"构建期快照、缺失即自禁用"**(对应实现 `PromptResourceLoader`,方案 A):构建时由 maven-resources 插件把 `contracts/prompts/` 与对应 schema 复制进 jar 的 `classpath:wanxiang-contracts/`(jar 内只是构建快照,**git `contracts/` 仍是唯一事实源**——改 prompt = 改原文件 + 升 version + 过四道闸,下次构建部署自动携带新版)。加载器启动时**逐模板自检**,任一模板的 prompt/schema 资源缺失或形态非法,就把整体 `ready` 置为 `false`(自禁用信号),执行器据此永不带病认领任务——不抛异常、不崩进程。 +**目标态:采 Langfuse 式的运行时热取,替掉构建期快照。** 对标 2025 收敛的 prompt 热管理标准,"改 prompt 要改原文件、升版本、过四道闸、再重新构建部署才生效"是把一份本该热改的配置钉死在构建期的反模式。目标加载策略是把注册表做成运行时可热取:加载器按 `id@label` 在运行时拉取文本、带缓存 TTL(约 60 秒)与后台刷新、取不到时回落到上一次缓存或内置默认,配置当数据(config-as-data)热改、不重新构建部署。四道闸的治理纪律一条不动——版本化、改动可自动回归、人在关键节点把关全保留,变的只是新版怎么到达运行时:从构建期注入快照,改成运行时按 label 拉取。这与生成运行时架构的 A13 配置注册表(同采 Langfuse 式运行时热取)是同一口径,见 [agentic运行时架构图说 §5.2](agentic运行时架构图说.md);tier2 那条 Python 线的 genconfig 已是雏形,要推广到后端主线。 + > 这里不存在"数据库只读镜像",也没有"运行时回源 git checkout":那是早期设计期契约里设想的载体,工程落地改走了更简单的构建期快照路。`registry.yaml` 与文件是否一致的对账是 §4 四道闸 CI 的职责,加载器不复制治理逻辑。 第二组契约值得专门点名,因为它把"prompt 治理"和"产物质量"接到了一起——这就是 **T-AGC-09 测试脚本原子**(原子 = 生成流水线里一个不可再分的处理单元;T-AGC-09 是它的工序编号)。**注意它当前是设计/规划态契约,尚未实现**(game-cloud 内暂无对应实现);其规划接口形态如下: diff --git a/docs/architecture/架构/生成引擎/数据飞轮.md b/docs/architecture/架构/生成引擎/数据飞轮.md index ba6f3097..82de5b66 100644 --- a/docs/architecture/架构/生成引擎/数据飞轮.md +++ b/docs/architecture/架构/生成引擎/数据飞轮.md @@ -1,3 +1,9 @@ +--- +topic: 数据飞轮-数据护城河 +canonical: true +date: 2026-06-24 +--- + # 数据飞轮:生成侧的护城河机制 > 🚧 **设计稿 · 待落地** —— 创始人 2026-06-21 立位、[README §10](README.md) 挂出的"数据飞轮生成侧落点"的正式设计。三条飞轮有先后依赖:溯源链 + 同款创作先落,资产市场依赖素材中心与支付,收益回流依赖数据线成型。代码执行归 Mac,前端入口与 admin 落点随本稿一并定。 diff --git a/docs/architecture/架构/生成引擎/生成引擎图说.md b/docs/architecture/架构/生成引擎/生成引擎图说.md index cc461501..69525431 100644 --- a/docs/architecture/架构/生成引擎/生成引擎图说.md +++ b/docs/architecture/架构/生成引擎/生成引擎图说.md @@ -46,7 +46,7 @@ |---|---|---| | 廉价线编排 | `SAA编排.md` | 16 节点拓扑（四泳道）、工作负载→编排映射 | | 固定架构 | `固定游戏架构.md` | 工作室链路 / 固定vs可填 / 游戏定义→适配器 / 8 契约 / 事务边界 / 救场阶梯 / 缓存三段式（7 张） | -| 验收 | `验收门-W-G1.md` | 六门全景 / D12 门序 / GP9 判定 / 首局子门 / 9d trace / 开闸前置（6 张） | +| 验收 | `验收门.md` | 六门全景 / D12 门序 / GP9 判定 / 首局子门 / 9d trace / 开闸前置（6 张） | | prompt 治理 | `prompt治理.md` | 治理数据流 / 四道闸 + HITL | | 开闸 | `开闸接线.md` | 一句话→首局接线 / 三处协同 | | 便宜模型基准 | `WG1基准.md` | 靶集三分档 / 缺口分流 / 三批执行（4 张） | diff --git a/docs/architecture/架构/生成引擎/验收门-W-G1.md b/docs/architecture/架构/生成引擎/验收门.md similarity index 99% rename from docs/architecture/架构/生成引擎/验收门-W-G1.md rename to docs/architecture/架构/生成引擎/验收门.md index 018fc47f..1a4d6881 100644 --- a/docs/architecture/架构/生成引擎/验收门-W-G1.md +++ b/docs/architecture/架构/生成引擎/验收门.md @@ -1,3 +1,9 @@ +--- +topic: 验收门-对外开闸放行 +canonical: true +date: 2026-06-24 +--- + # 开闸验收门 W-G1 · 生成对外放行的 6 道门 > 🚧 **架构演进中** —— 生成引擎子树正处于 gameDefinition→`src/` 终态迁移 + 产线化(plan `2026-06-18-001` U1–U4)中,文中标注的现行结论可能随推进变化;以子树 [README](README.md) 与最新裁定 / plan 为准。