From 0000ade12d69cd3a91cb5af317b2b558b10aac42 Mon Sep 17 00:00:00 2001 From: lili Date: Thu, 25 Jun 2026 13:07:49 -0700 Subject: [PATCH] =?UTF-8?q?docs(svg):=20=E5=85=A8=E5=9F=9F=20SVG=20reframe?= =?UTF-8?q?=20doc-sync=20=E2=80=94=20=E9=85=8D=E5=9B=BE=E4=B8=A4=E7=BA=BF?= =?UTF-8?q?=E2=86=92=E4=B8=89=E6=A1=A3=20+=20=E8=84=9A=E6=B3=A8=E6=AD=BB?= =?UTF-8?q?=E9=93=BE=20repoint?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 结构重画:03-两条生成轨边界 / 07-全局两线与tier体系(两泳道→三档统一 AgentScope、引擎随复杂度选 LittleJS/Phaser)。 - 文字/framing(全域 SVG):两线→三档、SAA 廉价线→便宜档、AgentScope premium 独立轨→统一框架、超休闲档→轻量、tier2 远期/待 spike→accept(实线)。 - 脚注死链:自治富游戏引擎.md / agentic集成架构.md / tier2实现详设.md / tier2四层工程架构.md(均已并入 SoT)→ agentic运行时架构图说.md;全域 SVG 零死链。 - 07-泳道 tier2 框 紫虚线→实线现行(accept、核心已落)。 - MD doc-sync:删 4 处"待重绘 mini-desktop"注(图已重画)、①③ §0 / README / SoT 注脚去 mini-desktop(全归本机)。 - atlas house-style 复验:良构 / 界内 / 脚注全角「:」/ 无裸& 全绿;t2-E-04「两线分立(06-23)」已加注 06-25 reframe 取代之、作留痕。 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/architecture/00-系统总览图说.md | 4 - docs/architecture/01-产品图说.md | 4 - .../architecture/assets/03-两条生成轨边界.svg | 237 ++++++++++-------- .../architecture/assets/07-端到端全链泳道.svg | 16 +- .../产品/assets/02-19产品域五大块.svg | 6 +- .../产品/assets/05-需求模块映射RTM.svg | 4 +- docs/architecture/架构/生成引擎/README.md | 2 - .../架构/生成引擎/agentic运行时架构图说.md | 2 +- .../架构/生成引擎/assets/00-生成两阶段.svg | 2 +- .../架构/生成引擎/assets/01-系统全景.svg | 14 +- .../架构/生成引擎/assets/02-调用时序.svg | 2 +- .../生成引擎/assets/03-运行时内部架构.svg | 2 +- .../架构/生成引擎/assets/04-ReAct循环流程.svg | 2 +- .../架构/生成引擎/assets/06-reuse边界全景.svg | 10 +- .../生成引擎/assets/07-全局两线与tier体系.svg | 140 +++++++---- .../架构/生成引擎/assets/10-数据飞轮全景.svg | 2 +- .../assets/t2-A-01-AgentService与session三路.svg | 2 +- .../assets/t2-A-02-Agent非常驻与AgentState.svg | 2 +- .../assets/t2-A-03-Workspace双轴注入.svg | 2 +- .../生成引擎/assets/t2-A-04-Middleware洋葱.svg | 2 +- .../生成引擎/assets/t2-B-01-控制面四组件.svg | 30 +-- .../生成引擎/assets/t2-B-02-反锁死五协议.svg | 26 +- .../生成引擎/assets/t2-B-03-预算三层强制.svg | 2 +- .../生成引擎/assets/t2-B-04-管理面三phase.svg | 8 +- .../生成引擎/assets/t2-C-01-单写ReAct循环.svg | 12 +- .../生成引擎/assets/t2-C-02-M3原生接法.svg | 2 +- .../架构/生成引擎/assets/t2-C-03-四道熔断.svg | 6 +- .../assets/t2-C-04-多轮范式承amodel.svg | 8 +- .../生成引擎/assets/t2-D-01-三层校验全景.svg | 2 +- .../架构/生成引擎/assets/t2-D-02-九门逐门.svg | 2 +- .../生成引擎/assets/t2-D-03-富游戏专属门.svg | 22 +- .../assets/t2-D-04-advisory分级与Goodhart隔离.svg | 2 +- .../assets/t2-D-05-CDP探针Phaser重写.svg | 4 +- .../生成引擎/assets/t2-E-01-skills清单.svg | 2 +- .../assets/t2-E-02-引擎能力包manifest.svg | 2 +- .../assets/t2-E-03-prompt两阶段角色.svg | 2 +- .../生成引擎/assets/t2-E-04-Amodel插件复用.svg | 6 +- .../assets/t2-F-01-源项目契约七要素.svg | 2 +- .../生成引擎/assets/t2-F-02-第二装载分支.svg | 2 +- .../assets/t2-F-03-finish共用schema.svg | 2 +- .../assets/t2-G-01-建设五步与spike门.svg | 6 +- .../生成引擎/assets/t2-G-02-mini肥鹅靶子.svg | 2 +- .../生成引擎/assets/t2-G-03-模型矩阵与跑序.svg | 2 +- .../assets/t2-G-04-过门阈值与采集字段.svg | 2 +- .../assets/t2-G-05-两段实施与退路树.svg | 2 +- .../生成引擎/assets/t2-H-01-trace统一契约.svg | 6 +- .../架构/生成引擎/assets/t2-H-02-观测管道.svg | 14 +- .../架构/生成引擎/assets/t2-H-03-成本台账.svg | 2 +- docs/mvp/可行性方案16周-波次映射.md | 2 +- ...”Ÿ成引擎统一执行计划-AgentScope三档-plan.md | 2 +- 50 files changed, 342 insertions(+), 299 deletions(-) diff --git a/docs/architecture/00-系统总览图说.md b/docs/architecture/00-系统总览图说.md index c7e249f6..e0cd49f4 100644 --- a/docs/architecture/00-系统总览图说.md +++ b/docs/architecture/00-系统总览图说.md @@ -91,8 +91,6 @@ status: 现行为主(系统级 9 图)· 架构图集入口 · 通用图例与按 ![图 3 三档生成与引擎选型](assets/03-两条生成轨边界.svg) -> ⚠️ 配图 `assets/03-两条生成轨边界.svg` 待按本次 reframe 重绘(出图归 mini-desktop):原图按「现行 SAA 廉价线 ‖ 远期 tier2 自治轨」二分,现应改画三档按 AI 参与深度统一在 AgentScope 框架下、引擎随复杂度选 LittleJS / Phaser。 - 这张图是看清「生成引擎怎么组织」的**总闸**。绘境AI 把生成收敛到 **AgentScope 一套框架**,按 **AI 参与深度**分 Tier0/1/2 三档——不是「SAA 现行 ‖ tier2 远期」那种按基建分裂的两轨。三档**全高度模板化**(玩法模板 + 工程骨架,不是从零生成),区别在 AI 介入多深:浅介入档照模板填,深介入档让 agent 自治造多系统富交互。**引擎是按复杂度选的实现变体、不是分档轴**:轻-中复杂度用 LittleJS,最高复杂度用 Phaser(纯代码全无头可构建,适配 agent 自治 loop)。生成产物的终态统一是 `src/` 多文件源项目——**gameDefinition 已废(判错误路线),现行直接由 A-model 写真 src/**,既无 factory/gamedef 双轨、也无 cutover 切换。SAA / Dify / Coze 在这套框架里降到**最低优先级**,留作「远期适配验证可插拔」的目标,不是现行主轴。各档**只经公共件交汇**:计费平面、送审 + feed、验收基线 + 执行沙箱、控制 / 管理面治理层。 读这张图有三层意思必须读到。其一,**tier2 富游戏档的状态要说准**:它走 AgentScope(Python)的自治 ReAct agent、用 Phaser 全无头引擎、靠三层校验当确定性地板加人工终审兜底,产物是 Phaser 的 `src/` 源工程;**0 号 spike 已过 accept、核心代码已落**,验证走 **n=5 收敛环**(并发跑 5、有错追加 5、收敛即 go),产品化排期待定——它不是「远期待 spike、尚未落代码」。其二,**三档共用一套框架而非两套正交范式**:统一在 AgentScope 下按 AI 深度调档,避免「声明式有向图 ‖ 命令式循环」硬塞成项目明令反对的「缝合设计」。其三,**per-gen 预算硬闸**:便宜档每次生成 < ¥10、复杂档 < ¥50(图、音另算),这条成本闸是三档共守的硬边界。生成引擎的深度(运行时架构、加节点法、救场阶梯、引擎运行时、tier2 详设)在生成引擎子树,运行时单一真相 SoT 见 [`生成引擎/agentic运行时架构图说.md`](架构/生成引擎/agentic运行时架构图说.md),本图只画三档与引擎选型的硬边界。 @@ -165,8 +163,6 @@ flowchart TB 新人能从这张图看出几件单看任何一张领域图都看不全的事。其一,**判断「系统有没有缝」,就是看相邻泳道的交接处对不对得上**——出包能不能落成草稿、草稿能不能提审、裁决能不能控制入流、互动能不能回流成排序,任何一处接不上,闭环就断了;这张图把所有交接点都画在了一条线上,据图就能逐个核对。其二,**合规门是整条链的上线总闸**:图上那条红线写着「pass 才入流」,游戏造得再好,过不了锁风门也进不了 feed,这是平台不碰红线的硬约束。其三,**现状必须诚实地读**,不能因为画出来了就当全是实的:图里用橙色虚线小标点出了两处现状桩——feed 的游标分页现在恒返第一页、Redis 候选集还是增长期形态,广告侧的 `provider` 还是 mock、真广告 SDK 要等渠道落地才接;提现打款那一格更标了红线,缺渠道时必须 fail-fast、绝不发假钱。其四,右上角那个虚线框是 **tier2 富游戏档**——它走的是 AgentScope 自治加 Phaser 无头的更深 AI 介入档,**0 号 spike 已过 accept、核心代码已落**(验证走 n=5 收敛环),产品化排期待定;它**不在这条现行链上跑同一条装载路**,换的只是「游戏内容怎么造出来」,造出来之后仍旧汇进同一条上线与发行的公共件。把这些边界一眼标清,正是为了让据图做评审的人,既能顺着主链确认闭环跑得通,又不会把桩误当成已经建好的现行。 -> ⚠️ 配图 `assets/07-端到端全链泳道.svg` 待按本次 reframe 重绘(出图归 mini-desktop):tier2 档不再按「远期虚线轨」画,改标「核心已落、产品化排期待定」。 - ### 图 9 · 系统上下文与外部依赖边界〔SVG·架·现 + 接〕 ![图 9 系统上下文与外部依赖边界](assets/08-系统上下文.svg) diff --git a/docs/architecture/01-产品图说.md b/docs/architecture/01-产品图说.md index 61588e9a..aa5978ed 100644 --- a/docs/architecture/01-产品图说.md +++ b/docs/architecture/01-产品图说.md @@ -50,8 +50,6 @@ flowchart LR 读这张图要抓住三个细节。其一,图上用蓝色高亮块钉死了 **⭐ 三个 P0 最密集的域**:自定义创作、发布分发、游戏信息流——它们是 MVP 闭环的关键环节,「能生成、能发、能刷到」这条最小链全靠它们撑起;其余域多为 P1/P2 的后续加厚。其二,每个域卡片右上角标了该域的优先级密度(P0 / P1 / P0-P1 混合),让人快速判断哪些域是 MVP 必交、哪些是远期。其三,也是本图最该让人看清的**设计缝**:创作侧底部那个紫色虚线框——**tier2 富游戏档**。生成框架按 AI 参与深度分三档,当前 19 个域承载的是浅-中介入档;经营、合成、挂机这类多系统的富游戏品类由 tier2 深介入档承载,面向价值更高、产量更低的场景。tier2 的 **0 号 spike 已过 accept、核心代码已落**(验证走 n=5 收敛环、有错追加 5),产品化排期待定,但**不在 MVP 的 P0 范围、也不单列正式 P-id**——所以图上必须用虚线把它和 19 个实心域块严格区分(虚线标的是「未进 MVP P0 范围」,不是「还没落代码」),绝不能让人误以为它已是 MVP 的一部分。它的完整设计在架构域生成引擎子树,本图只挂一个边界注脚。 -> ⚠️ 配图 `assets/02-19产品域五大块.svg` 待按本次 reframe 重绘(出图归 mini-desktop):tier2 虚线框小标从「premium 远期轨」改标「未进 MVP P0、核心已落」。 - ### 产品图 3 · 155 → 55 P0 收敛〔引·现〕 这张图回答「MVP 到底做多少」。完整产品有 155 条需求分布在 19 个域,MVP 阶段不全做,而是聚焦其中 **55 条 P0**——它们刚好串起一条「种子用户可试用的全链路」:创建 → 生成 → 预览 → 发布 → 信息流 → 游玩 → 互动 → 广告 → 收益。这张图最该让人记住的,是它背后那条产品哲学:**MVP 不追求功能多,而追求这条闭环每一环都能真实跑通**;P1/P2 是闭环跑通之后的加厚,不是 MVP 的考核项。 @@ -93,8 +91,6 @@ flowchart TB 读这张图要抓住三层意思。其一,**三个读法标记**:每行一条 P-id,标了它的「首要 owner」(主要负责的那一个模块,问责与排期归属)、「★主」(主要实现这条需求的技术功能,可以是多个 T-id)、「辅」(支撑或兜底的技术功能,常跨模块)。图中央用一行放大的样例把这三层讲透——产品需求「生成结果实时预览试玩」(P-CRT-08)首要 owner 是 runtime 模块,★主靠 T-RT-01 编译 / T-RT-06 渲染容器 / T-RT-07 注入 / T-RT-04 沙箱四个技术功能,辅以 T-STU-07 的 SSE;产品侧完全不需要知道这些 T-id,技术侧也不需要知道 P-id,只有这张表两边都认识。其二,**多对多是双向的**:一个产品域会连多个技术模块,一个技术模块也会被多个产品域连——图上的交叉连线刻意画出这种「网状」而非「一一对应」的关系,这正是为什么必须用一张专门的矩阵、而不能把映射塞进任何一侧。其三,本图最该让人看清的**设计缝**画在中间表底部那个紫色虚线框里:**两块尚未进 RTM 的映射**——tier2 富游戏档和控制面/管理面治理层。它们先在 RTM 里挂上指针、免得在产品与技术之间悬空;但都**还没有正式的 T-id 与映射行**。两块的现状并不相同:tier2 的 **0 号 spike 已过 accept、核心代码已落**(验证走 n=5 收敛环、有错追加 5),产品化排期待定、仍未单列 P-id 与映射;控制面/管理面治理层则是部分有地基、整体待建。所以图上用虚线把这两块和 19 个域的实心映射严格分开——它们是「已挂指针、未进矩阵」,不是「已映射、已实现」。 -> ⚠️ 配图 `assets/05-需求模块映射RTM.svg` 待按本次 reframe 重绘(出图归 mini-desktop):tier2 虚线小标从「premium 远期」改标「核心已落、未进 RTM」。 - ### 产品图 6 · 五大块产品域关系〔Mer新·架·现〕 这张图把图 2 里五大块之间那几根块顶箭头单独放大,讲清「产物在五大块之间怎么流转」。如果说图 2 是「五大块各装了哪些域」的静态全貌,这张图就是「五大块之间动态怎么咬合」的流转图:创作侧产出可玩游戏,是整条链的源头;玩家侧消费这些游戏,把「有人玩」坐实;玩家的游玩与互动触发变现侧把钱赚回来;赚到的收益与沉淀的数据反哺成长侧,让创作者看到回报、愿意留下来继续创作;而平台侧作为底座,一边给生态提供 IP/B 端/运营/合规的支撑,一边把数据与收益的回流闭合回创作侧——形成「创作产出 → 玩家消费 → 变现回流 → 创作者留存 → 再创作」的飞轮。 diff --git a/docs/architecture/assets/03-两条生成轨边界.svg b/docs/architecture/assets/03-两条生成轨边界.svg index 18dec276..446c403e 100644 --- a/docs/architecture/assets/03-两条生成轨边界.svg +++ b/docs/architecture/assets/03-两条生成轨边界.svg @@ -1,7 +1,6 @@ - + - - - 图 3 · 现行 SAA 廉价线 ‖ 远期 tier2 自治轨 边界 - 看清"生成引擎现行 vs 远期"的总闸:左轨现行已建并合入主干,右轨待 0 号 spike、未落代码。两轨只经公共件交汇。生成引擎深度链接子树,本图只画两轨硬边界。 + + 图 3 · 三档生成(按 AI 参与深度统一框架)与引擎选型 + 生成收敛到 AgentScope 一套自治 agent 框架,按 AI 参与深度分 Tier0/1/2 三档;级别越高 AI 写得越多。三档全高度模板化(玩法模板 + 工程脚手架,非从零),引擎随表现复杂度选 LittleJS / Phaser。各档运行期零耦合,只经公共件交汇。 - - - 状态约定: - 左轨实心 = 现行已实测合入主干(SAA 16 节点 + 便宜模型 + 九门);右轨紫色虚线框 + 「远期·待 spike」= 仅有设计、未落代码,绝不是现行已建。两轨各服务不同品类,解耦并存。 + + + 统一编排框架 · AgentScope 一套自治 agent(Python)——三档共用,按 AI 参与深度调档 + 分档的轴只有「AI 参与深度」一条;引擎只是按复杂度选的实现变体、不是分档轴。三档全模板化:在玩法模板 + 工程脚手架上,按档位深浅填数值 / 写逻辑 / 写表现层。最低档也要能商业闭环,不做无法变现的超休闲玩具。 - - - 现行轨 · SAA 廉价线(已建 · MVP 主线) - 承载:超休闲档(Tier0/1)—— 打砖块 / 合成 / 挂机 / 答题 / 网格点选 + + + 用户一句话 brief + play_spec + 按 AI 参与深度分档(Tier0 → Tier1 → Tier2,渐深) + + + - - 入口:创作者一句话 + 选风格 + 素材 - aigc 模块 GenerationDispatcher 派发(202 + taskId 异步,生成态藏契约后) - + + + Tier0 · 浅介入档(已落) + 承载:轻量单局 —— 点选 / 合成 / 答题 / 躲避(照模板填,AI 介入最浅) - - SAA 裸 StateGraph 编排(16 节点 / 7 条件边) - render→classify→design→generate→…→play/player→emit - 控制流由图预先固定,非模型临场决定;唯一布线源 SaaStudioGraph.assemble() - + + AI 职责:照玩法模板填数值 / 文案 / 资产变体 + 填空式生成,把开放题收敛成填空题,跑飞面最小 - - new-api 网关(OpenAI 兼容 · 多模型) - 换模型 / 多通道兜底 = 网关配置事,业务无感;单 key 自动入计费台账(baseUrl 剥 /v1) - + + 引擎:LittleJS 增强发行版(轻量档) + 引擎 + 能力插件库;按表现复杂度选,非分档轴 - - 便宜 LLM(DeepSeek-v4 · MiniMax-M2.7 / M3) - 11 角色映射模型;质量缺口靠模板约束 + 门兜底,不靠训专用大模型 - + + 模型:便宜档(DeepSeek-v4 / MiniMax-M3) + 质量缺口靠模板约束 + 门兜底,不训专用大模型 - - harness 九门兜底(机制地板 · 确定性) - 能装载 / 跑帧 / 响应输入 / 到终态…done 由确定性门定,不让 LLM 自评 - 不过则 repair→escalate→giveup 救场阶梯;"宁可显式失败,不交付坏游戏" - + + 验收:九门 harness(真浏览器真玩 · 确定性地板) + done 由确定性门定,不让 LLM 自评;不过则 repair → escalate → giveup - - emit:GamePackage 出包 → 回写 project 草稿版本 + + 产物:A-model 写真 src/ 多文件源工程 + gameDefinition 已废、改源不改包;无 factory / cutover 双轨 - - - 现行真实状态(诚实说清,别读成"全好了"): - 骨架立住、控制流确定、九门很硬已合入主干;但 ① 生成质量尚未稳定到 80% 门 - (难门 I_control / F_wiring / H_progress 是便宜模型天花板,实测约 60%);② 一部分本该 - 可替换的"策略"被焊进了机制代码;③ gameDefinition→src/ 终态那段产物侧尚缺。 - 默认产线切换交 W-G1 把质量做到 80%(dispatcher flag 已存在,一行 flip)。 + + 现状:骨架 + 控制流 + 九门已合入主干; + 生成质量尚未稳定到 80% 门(W-G1 攻坚),部分策略仍焊在机制层待外置。 + per-gen 预算硬闸:便宜档 < ¥10 / 次(图、音另算) - - - 远期轨 · tier2 富游戏自治轨 - 远期·待 spike - 承载:premium 富游戏 —— 经营 / 合成 / 多系统富交互 + + + Tier1 · 中介入档(已落) + 承载:中等复杂单局 —— 跑酷 / 弹球 / 多机制小游戏(AI 写更多逻辑) - - 入口:创作端第二轨(premium 线 · 待建) - 归前端域,钉归属、不预先设计;前端图说图 9 - + + AI 职责:在模板上写玩法逻辑 + 受控改码 + 介入比 Tier0 深;数值进配置、只用模板已有行为 - - 命令式自主循环(ReAct · 模型驱动控制流) - 与左轨声明式有向图正交的另一种范式 - 独立 AgentScope 模块,不嫁接进 SAA 主循环(拒缝合) - + + 引擎:LittleJS 增强发行版(轻-中档) + 与 Tier0 同引擎,表现复杂度更高;非分档轴 - - 引擎:Phaser / Pixi(全无头自治轨) - 据 headless 筛子选,排除 Cocos(MCP 经编辑器驱动、非 headless) - + + 模型:便宜档为主,救场位升强档 + 11 角色映射模型;难门反复失败时 escalate 升档 - - 宽预算 · 高质量 · 低产量 · 小时级时延 - ¥50~500 / 款,B 端定价覆盖;确定性地板 + 人工终审 - + + 验收:同走九门 harness(共用确定性地板) + 与 Tier0 共用一套验收门;判定权不让步 - - 产物:真 Phaser 多文件源项目工程 - 经独立源项目契约构建出 bundle - 最终也落 src/ 工程(与终态范式一致) - + + 产物:A-model 写真 src/ 多文件源工程 + 与 Tier0 同范式(LLM 写真 src/),仅表现层更厚 - - 输出 bundle → 同样进公共件出包发行 + + 现状:与 Tier0 同条 A-model 主线, + 引擎 / 验收 / 产物完全共用,差别只在 AI 介入深度与表现复杂度。 + per-gen 预算硬闸:便宜档 < ¥10 / 次(图、音另算) - - 为什么不嫁接进左轨: - 左轨声明式图 vs 右轨命令式循环是两种正交范式, - 硬塞就成项目明令反对的"缝合设计";且对卡 80% 门, - 图的确定性本就比"DO NOT STOP"口头督促更稳。 - 0 号 spike go / no-go 决定它是否落地。 + + + Tier2 · 深介入档(核心已落) + 承载:富交互游戏 —— 经营 / 合成 / 多系统富游戏(AI 自治造) - - - 两轨唯一交汇面 = 公共件(双线边界 · 不随轨变) - - 计费平面(new-api 配额) - 成本只减不增,成本可对账 - - 送审 + feed(合规门 / 信息流) - 两轨产物都走同一条上线发行 - - 验收基线(确定性门)+ 执行沙箱 - 都暴露 __GameBundle / 跑同一套 iframe - - 控制 / 管理面治理层(两线共用) - 配置注册表 + 观测审计仓 + D12 治理门 + + AI 职责:自治 ReAct agent 造多系统富交互 + 介入最深;同在 AgentScope 框架下,不另开第二套范式 - - - + + 引擎:Phaser(最富档 · 全无头可构建) + 纯代码全无头,适配 agent 自治 loop;按复杂度选,非分档轴 - - - 深度去子树 - SAA 16 节点拓扑 / 加节点 - / 救场阶梯 / 引擎运行时 / - tier2 详设 → 生成引擎子树 + + 模型:强档(M3 Anthropic 原生 · thinking 分离) + 宽预算高质量低产量,小时级时延可接受 - 图例: - 现行已建(SAA 廉价线) - 远期·待 spike(tier2 轨) - 公共件(两轨唯一交汇) - 质量 - 成本 - 九门地板=质量 · 便宜模型=成本 · 两轨解耦=避免缝合 + + 验收:三层校验(确定性地板)+ 人工终审兜底 + L1 必过 / L2 尽量 / L3 评分;产物仍汇入同一套验收基线 - 映射:architecture/架构/README §2.2 + 生成引擎/README §1·§8 | 状态:现 + F(左现行、右远期)| 设计变动须同步本图 + + 产物:Phaser 写真 src/ 多文件源工程 + 与 Tier0/1 同范式(LLM 写真 src/),仅引擎换 Phaser + + + 现状:0 号 spike feie-005 已 accept、核心已落; + 验证走 n=5 收敛环(并发跑 5 / 有错追加 5 / 收敛即 go),产品化排期待定。 + per-gen 预算硬闸:复杂档 < ¥50 / 次(图、音另算) + + + + 三档唯一交汇面 = 公共件(双线边界 · 运行期零耦合,只在此汇合) + + 计费平面(new-api 配额) + 单 key 入台账,成本可对账 + + 送审 + feed(合规门 / 信息流) + 三档产物都走同一条上线发行 + + 验收基线(确定性门)+ 执行沙箱 + 都跑同一套 iframe 沙箱与门 + + 控制 / 管理面治理层(三档共用) + 配置注册表 + 观测审计仓 + D12 治理门 + + + + + + + + + 远期可插拔适配 + SAA / dify / coze 降最低优先级, + 留作「验证框架可插拔」目标: + 各接一个 adapter 适配进来, + 非现行主轴 · 远期不投核心 + + + 图例: + 现行已建(三档 · 各档浅深不同) + 远期可插拔适配(SAA / dify / coze) + 公共件(三档唯一交汇) + 质量 + 成本 + + 读这张图抓三点:① 分档轴只有「AI 参与深度」一条,引擎(LittleJS / Phaser)只是按复杂度选的实现变体;② 三档共用一套 AgentScope 框架与同一套九门 / 验收基线,Tier2 核心已落、验证走 n=5 收敛环;③ 三档运行期零耦合,只在公共件汇合。生成引擎运行时单一真相见子树运行时 SoT。 + + 映射:architecture/架构/生成引擎/README §1·§4 + 运行时 SoT agentic运行时架构图说.md §一·§四 | 状态:现 + 建(三档全已落,Tier2 产品化排期待定;SAA / dify / coze 远期可插拔适配)| 设计变动须同步本图 diff --git a/docs/architecture/assets/07-端到端全链泳道.svg b/docs/architecture/assets/07-端到端全链泳道.svg index 12b3ef28..c8d1c95f 100644 --- a/docs/architecture/assets/07-端到端全链泳道.svg +++ b/docs/architecture/assets/07-端到端全链泳道.svg @@ -24,7 +24,7 @@ 状态约定: - 实线步骤 = 现行已建(机制实测);橙虚线小标 = 现状桩(feed 游标分页恒返第一页 / 真广告 SDK 仍 mock);紫虚线 = tier2 富游戏轨(远期·待 spike,不入现行链)。整链主路 = 现 + 桩,绝不读成全实。 + 实线步骤 = 现行已建(机制实测);橙虚线小标 = 现状桩(feed 游标分页恒返第一页 / 真广告 SDK 仍 mock);tier2 富游戏档 = 实线独立 service(0 号 spike accept、核心已落,经公共件交汇,与现行主链平行)。整链主路 = 现 + 桩,绝不读成全实。 @@ -197,19 +197,19 @@ 提现打款桩:缺渠道须 fail-fast,绝不发假钱 - - - tier2 富游戏轨(远期·待 spike,不入现行链) + + + tier2 富游戏档(独立 service · 经公共件交汇) AgentScope 自治 ReAct + Phaser 无头 → 真 src 源工程 换的是"内容怎么造",出包后仍走同一条上线 / 发行公共件 - + 图例: 现行主路(一句话→出包→上线→被玩) 数据回流(把链弯成飞轮) 合规总闸(pass 才入流) - 远期 tier2 轨(不入现行链) + tier2 富游戏档(独立 service · 经公共件交汇) 现状桩(feed 游标 / 真广告 SDK / 打款) 旁路(出包即可预览) @@ -222,7 +222,7 @@ 新人一眼看出: ① 没有任何一环跨域接缝是断的——相邻泳道交接处对得上,系统才闭环;② 合规门是上线总闸(⑧),不 pass 进不了 feed;③ 数据回流(⑬⑭⑮)把线性链弯成飞轮,是"越用越聪明"的来源; - ④ 钱流(ⒶⒷⒸⒹ)与主链并联、经 source_ref 串起对账;⑤ 现状要诚实读:feed 分页 / 真广告 SDK / 打款都还是桩,tier2 富游戏轨是远期、不在这条现行链上。 + ④ 钱流(ⒶⒷⒸⒹ)与主链并联、经 source_ref 串起对账;⑤ 现状要诚实读:feed 分页 / 真广告 SDK / 打款都还是桩,tier2 富游戏档是独立 service、与现行主链平行而非串接其上。 - 映射:产品/README §1 闭环 + 架构/README §5 + 后端/README §3 五条业务链 + 后端/数据模型 §2 + 运营/变现与单位经济 + 运维/smoke §1.3 | 状态:现 + F(桩与远期已标)| 设计变动须同步本图 + 映射:产品/README §1 闭环 + 架构/README §5 + 后端/README §3 五条业务链 + 后端/数据模型 §2 + 运营/变现与单位经济 + 运维/smoke §1.3 | 状态:现 + F(桩与 tier2 独立档已标)| 设计变动须同步本图 diff --git a/docs/architecture/产品/assets/02-19产品域五大块.svg b/docs/architecture/产品/assets/02-19产品域五大块.svg index 3dea4693..bc9aedb0 100644 --- a/docs/architecture/产品/assets/02-19产品域五大块.svg +++ b/docs/architecture/产品/assets/02-19产品域五大块.svg @@ -53,9 +53,9 @@ 第二条生成轨(tier2 富游戏) - 经营 / 合成 / 挂机等多系统 premium 品类 - 与超休闲廉价线解耦并存 · 价高量低 - 待 0 号 spike · 未落代码 · 不在 MVP 清单 + 经营 / 合成 / 挂机等多系统富游戏档(tier2)品类 + 与轻量便宜档解耦并存 · 价高量低 + 0 号 spike 已 accept · 核心已落 · 不在 MVP 清单 不单列正式 P-id(见生成引擎子树) 五大块内细分域数:5 diff --git a/docs/architecture/产品/assets/05-需求模块映射RTM.svg b/docs/architecture/产品/assets/05-需求模块映射RTM.svg index 0e1b2b06..ebf66d3e 100644 --- a/docs/architecture/产品/assets/05-需求模块映射RTM.svg +++ b/docs/architecture/产品/assets/05-需求模块映射RTM.svg @@ -94,10 +94,10 @@ 待建 · post-spike(先挂指针,免悬空) - tier2 富游戏轨:经营/合成/挂机 premium 品类 + tier2 富游戏档:经营/合成/挂机多系统品类 的自治生成与渲入信息流,第二条生成轨 控制面 / 管理面:配置注册表、运行轨迹 - 与配置审计、运行治理门(两线共用治理层) + 与配置审计、运行治理门(三档共用治理层) 待 0 号 spike 过后才展开正式 T-id 与映射行 纪律:只有本表两边都认识 P-id 与 T-id diff --git a/docs/architecture/架构/生成引擎/README.md b/docs/architecture/架构/生成引擎/README.md index d17e5225..61e9bd9a 100644 --- a/docs/architecture/架构/生成引擎/README.md +++ b/docs/architecture/架构/生成引擎/README.md @@ -33,8 +33,6 @@ ## 2. 一张端到端流程图:一句话怎么变成一款游戏 > ⚠️ **这张 16 节点流程图是旧 SAA 路线的历史表示。** 2026-06-25 框架 reframe 后,生成框架统一收敛到 **AgentScope**,SAA 降为最低优先级(留作远期适配验证可插拔的目标),不再是现行生成主线的编排底座。下图保留下来是为了讲清"一句话→游戏"这条流水线的**相位结构**(分类→设计→生成→构建→验收→发布的固定相位至今有效),但具体的编排框架与节点拓扑以运行时 SoT [`agentic运行时架构图说`](agentic运行时架构图说.md)(§5.2 控制面)为现行真相。 -> -> ⚠️ **配图待重绘(mini-desktop)**:本节若配有对应 SVG,需按"AgentScope 统一框架"重绘后再替换。 下面这张图是旧 SAA 路线生成主线的相位全貌。16 个节点不是抽象概念,而是当时图里真实存在的执行单元。读图时抓住三段就好:**先理解题面(render→classify→design)→ 再造出东西(generate→scaffold→asset→build)→ 最后反复验收直到合格或放弃(play/player/nreview→modify/repair/escalate→emit/giveup)**。 diff --git a/docs/architecture/架构/生成引擎/agentic运行时架构图说.md b/docs/architecture/架构/生成引擎/agentic运行时架构图说.md index 4986339f..b5282abe 100644 --- a/docs/architecture/架构/生成引擎/agentic运行时架构图说.md +++ b/docs/architecture/架构/生成引擎/agentic运行时架构图说.md @@ -300,7 +300,7 @@ tier2 这条线另有一套总览图,与 §5 各 facet 的细化图互补: ## 五、运行时八面(facet) -> 八个 facet 是 §四 生成实例的逐面放大,把各档在每一面的设计讲到可照着实现的颗粒度。最高深度档(tier2 富游戏)的内容偏多——**它的核心已落、0 号 spike 已 accept**(各面"现/建"按 2026-06-24 `tier2/HANDOFF.md` 真相标注:多数已落,留后的是更多款的收敛环验证(n=5、有错追加 5)、阶段 1 Agent Team、控制面/管理面);低档在每一面以现行已落的对照锚出现。各面引用的 svg 大图在 `assets/`——**这些图是 0 号 spike 前视角(虚线、以及图内"整图状态 = 建·待 spike"小标都是当时的待建标记),现状真相以各面散文的"现/建"为准,不以图的虚线为准**(svg 重绘待 mini-desktop 出图管线)。 +> 八个 facet 是 §四 生成实例的逐面放大,把各档在每一面的设计讲到可照着实现的颗粒度。最高深度档(tier2 富游戏)的内容偏多——**它的核心已落、0 号 spike 已 accept**(各面"现/建"按 2026-06-24 `tier2/HANDOFF.md` 真相标注:多数已落,留后的是更多款的收敛环验证(n=5、有错追加 5)、阶段 1 Agent Team、控制面/管理面);低档在每一面以现行已落的对照锚出现。各面引用的 svg 大图在 `assets/`——**已按 2026-06-25 reframe 重绘**(tier2 核心已落标实线、框架统一 AgentScope、旧「两线 / SAA 廉价线 / 超休闲」口径已清),与各面散文的「现 / 建」口径一致。 ### 5.1 运行时形态 diff --git a/docs/architecture/架构/生成引擎/assets/00-生成两阶段.svg b/docs/architecture/架构/生成引擎/assets/00-生成两阶段.svg index 1195028f..1eb48765 100644 --- a/docs/architecture/架构/生成引擎/assets/00-生成两阶段.svg +++ b/docs/architecture/架构/生成引擎/assets/00-生成两阶段.svg @@ -90,5 +90,5 @@ 文档 + 代码 workflow:两阶段 = Agent Team 动态调度 + 自治 loop,非 workflow DAG(AgentScope 无显式 workflow 原语);「给用户用的 workflow 能力」是未来需求、另议(图说 §5b)。 - 建 session 三种加载入口(续会话 / 加载已有工程 / 加载模板)见图 2。 映射:自治富游戏引擎.md · agentic集成架构.md · generation-lifecycle-project-model | 设计变动须同步本图 + 建 session 三种加载入口(续会话 / 加载已有工程 / 加载模板)见图 2。 映射:agentic运行时架构图说.md §5.1 运行时形态 / §4.2 Phaser 富游戏档 · generation-lifecycle-project-model | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/01-系统全景.svg b/docs/architecture/架构/生成引擎/assets/01-系统全景.svg index df81e9f5..12526661 100644 --- a/docs/architecture/架构/生成引擎/assets/01-系统全景.svg +++ b/docs/architecture/架构/生成引擎/assets/01-系统全景.svg @@ -11,7 +11,7 @@ 图 1 · 系统全景 / 部署 - tier2 agentic 是独立 service,game-cloud 经 HTTP API 调用;运行期与 SAA 廉价线零耦合;模型统一经 new-api。 + tier2 agentic 是独立 service,game-cloud 经 HTTP API 调用;运行期与便宜档(Tier0/1·LittleJS)零耦合;模型统一经 new-api。 @@ -26,8 +26,8 @@ feed / 发布〔公共〕 CDP 验收基线(公共 harness)〔公共·双线〕 - 九门确定性验收,两线共享,泛化 Phaser - 公共组件 = 两条生成线共享,不进 tier2 私有 + 九门确定性验收,三档共享,泛化 Phaser + 公共组件 = 三档共享,不进 tier2 私有 安全 质量 @@ -87,9 +87,9 @@ - SAA 廉价线(Tier0/1 · Java) - 现行生成主线;与本 service 运行期零耦合 · 可删 - 两线只经公共组件(计费/送审/feed/验收基线)交汇 + 便宜档(Tier0/1 · LittleJS) + A-model 走 AgentScope;与本 service 运行期零耦合 · 可删 + 三档只经公共组件(计费/送审/feed/验收基线)交汇;SAA 降最低优先级 @@ -112,5 +112,5 @@ 实线〔官方现成〕 虚线〔自建/零耦合〕 双线〔公共组件〕 - 映射:agentic集成架构.md · tier2四层工程架构.md | 基于 agentscope 2.0.2 源码实证 | 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.1 运行时形态 / §5.8 四层职责 | 基于 agentscope 2.0.2 源码实证 | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/02-调用时序.svg b/docs/architecture/架构/生成引擎/assets/02-调用时序.svg index 8fd080a8..6728f181 100644 --- a/docs/architecture/架构/生成引擎/assets/02-调用时序.svg +++ b/docs/architecture/架构/生成引擎/assets/02-调用时序.svg @@ -72,5 +72,5 @@ REST 请求 / 动作 SSE 事件流(可恢复) - 映射:agentic集成架构.md · tier2实现详设.md|基于 agentscope 2.0.2 Agent Service + Agent Team 源码实证|设计变动须同步本图 + 映射:agentic运行时架构图说.md §5 控制面与运行时形态|基于 agentscope 2.0.2 Agent Service + Agent Team 源码实证|设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/03-运行时内部架构.svg b/docs/architecture/架构/生成引擎/assets/03-运行时内部架构.svg index b9d4b96d..a763ac45 100644 --- a/docs/architecture/架构/生成引擎/assets/03-运行时内部架构.svg +++ b/docs/architecture/架构/生成引擎/assets/03-运行时内部架构.svg @@ -116,5 +116,5 @@ 实线〔官方〕 虚线〔自建〕 生产维度:可靠 / 安全 / 数据 / 可观测 / 质量(标在对应组件角) - 映射:tier2四层工程架构.md · 自治富游戏引擎.md | 基于 agentscope 2.0.2 源码实证(Agent 双轴持有 Workspace · Agent 非常驻 · Middleware 洋葱) | 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.8 四层职责 / §5.1 运行时形态 | 基于 agentscope 2.0.2 源码实证(Agent 双轴持有 Workspace · Agent 非常驻 · Middleware 洋葱) | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/04-ReAct循环流程.svg b/docs/architecture/架构/生成引擎/assets/04-ReAct循环流程.svg index 3a6ef01e..15260f30 100644 --- a/docs/architecture/架构/生成引擎/assets/04-ReAct循环流程.svg +++ b/docs/architecture/架构/生成引擎/assets/04-ReAct循环流程.svg @@ -94,5 +94,5 @@ - 〔官方〕= AgentScope 现成 〔自建〕= 挂官方 Middleware 自写 | 映射:tier2四层工程架构.md §4 · 自治富游戏引擎.md | 设计变动须同步本图 + 〔官方〕= AgentScope 现成 〔自建〕= 挂官方 Middleware 自写 | 映射:agentic运行时架构图说.md §4.2/§5(tier2 单写 ReAct 运行时) | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/06-reuse边界全景.svg b/docs/architecture/架构/生成引擎/assets/06-reuse边界全景.svg index e893986a..52d6b33d 100644 --- a/docs/architecture/架构/生成引擎/assets/06-reuse边界全景.svg +++ b/docs/architecture/架构/生成引擎/assets/06-reuse边界全景.svg @@ -8,7 +8,7 @@ 图 6 · 复用边界(来源 × 共享范围 · 自建项标载体类型) - 维度:来源(官方现成 vs 自建)× 共享(两线公共 vs tier2 私有)。自建项后的〔徽章〕= 用 AgentScope 哪种扩展点做(看明白在哪做什么)。公共组件是自建的共享件、非现成。 + 维度:来源(官方现成 vs 自建)× 共享(三档公共 vs tier2 私有)。自建项后的〔徽章〕= 用 AgentScope 哪种扩展点做(看明白在哪做什么)。公共组件是自建的共享件、非现成。 @@ -41,7 +41,7 @@ - 自建 · 两线公共(自建的共享件,非现成) + 自建 · 三档公共(自建的共享件,非现成) · 确定性九门(真浏览器真玩判能玩) 〔Tool + 独立 harness〕 · 三层校验工具:L1 编译/运行 · L2 设计符合 · L3 效果 〔Tool〕 @@ -50,8 +50,8 @@ · 送审 / 审核台 · feed / 发布 〔框架外独立服务〕 · trace 契约(核心子集 + 扩展段) 〔Schema〕 - 为什么公共:两线产物都要计费/送审/进同一 feed、都靠同一套确定性验收判能玩 → 抽共享、不重复造。 - 为什么不是现成:AgentScope 不提供游戏验收/计费/发行,这些是项目自建、只是两线共用。 + 为什么公共:三档产物都要计费/送审/进同一 feed、都靠同一套确定性验收判能玩 → 抽共享、不重复造。 + 为什么不是现成:AgentScope 不提供游戏验收/计费/发行,这些是项目自建、只是三档共用。 @@ -75,5 +75,5 @@ 载体类型(AgentScope 扩展点): Tool=工具函数 Middleware=hook 拦截 Skill=SKILL.md Prompt=指令 Memory=ReMe Schema=契约数据 独立=框架外 - 映射:tier2四层工程架构.md §8 · agentic集成架构.md | 基于 agentscope 2.0.2 源码逐项核对(官方已有/真自建 + 载体类型) | 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.8 四层职责 / §5.5 能力面 | 基于 agentscope 2.0.2 源码逐项核对(官方已有/真自建 + 载体类型) | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/07-全局两线与tier体系.svg b/docs/architecture/架构/生成引擎/assets/07-全局两线与tier体系.svg index f055e7c4..4e8cab87 100644 --- a/docs/architecture/架构/生成引擎/assets/07-全局两线与tier体系.svg +++ b/docs/architecture/架构/生成引擎/assets/07-全局两线与tier体系.svg @@ -1,73 +1,111 @@ - + + - - 图 ① · 生成引擎全局:两条生成线 + tier 体系 - 一句话按品类/复杂度分流到两条线;两线**运行期零耦合**、各跑各运行时,只在公共组件(计费/送审/feed/验收基线)交汇。tier2 线详见 agentic 图说 9 图。 + + 图 ① · 生成引擎全局:三档统一 AgentScope + tier 体系 + 一句话按 AI 参与深度分流到三档(Tier0/1/2),统一在一套 AgentScope 自治 agent 框架下;级别越高 AI 写得越多。三档全模板化、运行期零耦合,只在公共组件(计费 / 送审 / feed / 验收基线)交汇。引擎随复杂度选 LittleJS / Phaser。 - - 用户一句话 brief + play_spec - 按品类 / 复杂度分流 + + + 统一编排框架 · AgentScope 一套自治 agent(Python)——三档共用,按 AI 参与深度调档 + 分档轴只有「AI 参与深度」一条;引擎(LittleJS / Phaser)只是按表现复杂度选的实现变体、不是分档轴。三档全在玩法模板 + 工程脚手架上生成,非从零;最低档也要能商业闭环。SAA / dify / coze 降最低优先级,留作远期可插拔适配验证(见右下)。 - - + + + 用户一句话 brief + play_spec + 按 AI 参与深度分档(Tier0 → Tier1 → Tier2,渐深) + + + - - - Tier0/1 廉价线 - 超休闲单局:pong / 点击器 / 躲避 / 跑酷(几何色块) + + + Tier0 · 浅介入档(已落) + 轻量单局:点选 / 合成 / 答题 / 躲避(照模板填) - 范式:声明式数据壳 + 便宜模型填 + 固定运行时 - 编排:SAA 16 节点裸 StateGraph〔Java〕 - 模型:便宜档(deepseek-v4 / M3) - 引擎:LittleJS(55KB gz) - 验收:九门 harness(真浏览器真玩) - 产物:可维护 src/ 源项目(改源不改包) - gamedef json 正废除中(另会话)→ 终态 src/ 源项目 + AI 职责:照玩法模板填数值 / 文案 / 资产变体 + 引擎:LittleJS 增强发行版(轻量档) + 模型:便宜档(deepseek-v4 / M3) + 验收:九门 harness(真浏览器真玩) + 产物:A-model 写真 src/ 源工程(改源不改包) + gameDefinition 已废 → 终态 src/ 多文件源项目 - 端到端怎么转 → 图 ③ 廉价线端到端全景;九门 → 图 ⑤ + 预算硬闸:便宜档 < ¥10 / 次(图、音另算) + 端到端怎么转 → 图 ③ 端到端全景;九门 → 图 ⑤ - - - tier2 自治富游戏线 - 合成 / 经营 / 挂机(肥鹅档;Marvel·KOF = 对标天花板) + + + Tier1 · 中介入档(已落) + 中等复杂单局:跑酷 / 弹球 / 多机制小游戏 - 范式:O2 约束自治 + 单写 ReAct - 编排:AgentScope 独立 service(工作室 Agent Team → 单写)〔Python〕 - 模型:M3 Anthropic 原生(thinking 分离) - 引擎:Phaser / Pixi - 验收:三层校验(L1 必须 / L2 尽量 / L3 评分) - 产物:Phaser 源工程 - 全悬 0 号 spike(便宜模型能否自治写富游戏) + AI 职责:在模板上写玩法逻辑 + 受控改码 + 引擎:LittleJS 增强发行版(轻-中档) + 模型:便宜档为主,救场位升强档 + 验收:同走九门 harness(共用地板) + 产物:A-model 写真 src/ 源工程(同 Tier0 范式) + 与 Tier0 同主线,差别只在 AI 介入深度与表现复杂度 - → 详见 agentic 运行时架构图说(图 A + 1–8,共 9 图) + 预算硬闸:便宜档 < ¥10 / 次(图、音另算) + 引擎 / 验收 / 产物与 Tier0 完全共用 + + + + Tier2 · 深介入档(核心已落) + 富交互:经营 / 合成 / 多系统富游戏(AI 自治造) + + AI 职责:自治 ReAct agent 造多系统富交互 + 引擎:Phaser(最富档 · 全无头可构建) + 模型:强档(M3 Anthropic 原生 · thinking 分离) + 验收:三层校验 + 人工终审 → 汇入同一验收基线 + 产物:Phaser 写真 src/ 源工程(同范式,换引擎) + 0 号 spike feie-005 已 accept、核心已落 + + 预算硬闸:复杂档 < ¥50 / 次(图、音另算) + 验证走 n=5 收敛环(并发跑 5 / 有错追加 5 / 收敛即 go),产品化排期待定 - - 两线运行期零耦合 · 各跑各运行时 · 可独立删 + + 三档运行期零耦合 · 各跑各运行时 · 可独立删 · 只经下方公共组件汇合 - - 公共组件(两线共享 · 均为自建) + + 公共组件(三档共享 · 均为自建) - 计费台账new-api quota → ¥ - 送审 / 审核台 - feed / 发行 - CDP 验收基线九门 harness 泛化 - 源项目契约各线独立 schema + 计费台账new-api quota → ¥ + 送审 / 审核台 + feed / 发行 + 验收基线 + 执行沙箱九门 harness 泛化 + 控制 / 管理面治理层配置注册表 + 观测审计 + D12 - - + + + - - tier 体系: - Tier0/1 = 超休闲廉价线(本图左) · tier2 = 富游戏自治线(本图右) · Tier3 = Cocos 3D / 渠道导出(人在环·future·不在本模块) - 差异化护城河 = 生成 + 流量 + 变现全闭环(数据飞轮见图 ④);两条生成线吃不同市场、各跑各运行时,只经上面公共组件交汇。 - 映射:README · 固定游戏架构.md · 自治富游戏引擎.md · 设计合理性裁决.md | 与 agentic 图说 svg 风格统一 | 设计变动须同步本图 + + + 远期可插拔适配(非现行主轴 · 远期不投核心): + SAA / dify / coze 降最低优先级,留作「验证框架可插拔」目标 —— 等 AgentScope 做扎实,再各接一个 adapter 适配进来。 + + + tier 体系: + Tier0/1 = 轻-中档(LittleJS) · Tier2 = 富游戏档(Phaser) · 均统一在 AgentScope 框架下、按 AI 参与深度分档 + 更高层级(Cocos 3D / 渠道导出,人在环 · future)不在本生成模块。 + + + 图例: + 现行已建(三档) + 远期可插拔适配(SAA / dify / coze) + 公共组件(三档唯一交汇) + + 差异化护城河 = 生成 + 流量 + 变现全闭环(数据飞轮见图 ④);三档统一在 AgentScope 下、按 AI 参与深度分档,引擎随复杂度选,各跑各运行时、只经上面公共组件交汇。 + + 映射:本子树 README §1·§4 + 运行时 SoT agentic运行时架构图说.md(§四 三档两引擎实例 / §五 控制面)| 状态:现 + 建(三档全已落,Tier2 核心已落、产品化排期待定;SAA / dify / coze 远期可插拔适配)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/10-数据飞轮全景.svg b/docs/architecture/架构/生成引擎/assets/10-数据飞轮全景.svg index bd8838b2..db4a5a59 100644 --- a/docs/architecture/架构/生成引擎/assets/10-数据飞轮全景.svg +++ b/docs/architecture/架构/生成引擎/assets/10-数据飞轮全景.svg @@ -12,7 +12,7 @@ 生成 → 发布 → feed 播放 → 遥测 → 反馈 → 优化 → 回生成;三条飞轮(网络效应/资产/数据)互相咬合、自我加速 = 差异化护城河。 - ① 生成两线产物 + ① 生成三档产物 ② 发布落库 / 上架 ③ feed 播放玩家消费 ④ 遥测留存/行为/收益 diff --git a/docs/architecture/架构/生成引擎/assets/t2-A-01-AgentService与session三路.svg b/docs/architecture/架构/生成引擎/assets/t2-A-01-AgentService与session三路.svg index 41eb76b5..a2ba5d34 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-A-01-AgentService与session三路.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-A-01-AgentService与session三路.svg @@ -156,5 +156,5 @@ 同一 Agent 装配点(只是初始 state / workdir 不同) - 映射:agentic集成架构.md §tier2 接入面(八 router / MessageBus / session 三路)· tier2实现详设.md §运行时形态:两阶段、service 化与 session 三路径 ·(放大总览图 1 系统全景 / 图 2 调用时序)· 源码 agentscope/app/ 已核 | 状态:现(官方 Agent Service 现成件)/ 建(tier2 接线待 spike)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §tier2 接入面(八 router / MessageBus / session 三路)· §运行时形态:两阶段、service 化与 session 三路径 ·(放大总览图 1 系统全景 / 图 2 调用时序)· 源码 agentscope/app/ 已核 | 状态:现(官方 Agent Service 现成件)/ 建(tier2 接线待 spike)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-A-02-Agent非常驻与AgentState.svg b/docs/architecture/架构/生成引擎/assets/t2-A-02-Agent非常驻与AgentState.svg index d079fa99..077ca9d0 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-A-02-Agent非常驻与AgentState.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-A-02-Agent非常驻与AgentState.svg @@ -151,5 +151,5 @@ 每轮落盘与半轮幂等两条硬约束,以及 resume 续跑落到 SessionRecord.state 与 cur_iter 续接的具体链路——这些总览图 3/8 未展开。Agent↔Workspace 两轴注入见总览图 3,本图不重画。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §运行时形态(Agent 非常驻 + AgentState + checkpoint)· agentic集成架构.md §tier2 接入面(durable session / SessionRecord.state)· agentic运行时架构图说.md 图3 运行时内部 + 图8 类图(放大)· AgentScope 2.0.2 源码 state/_state.py + app/storage(已核)| 状态:现(AgentState/StorageBase=官方现成)/ 建(tier2 非常驻装配 + 每轮 checkpoint + resume)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §运行时形态(Agent 非常驻 + AgentState + checkpoint)· §tier2 接入面(durable session / SessionRecord.state)· 图3 运行时内部 + 图8 类图(放大)· AgentScope 2.0.2 源码 state/_state.py + app/storage(已核)| 状态:现(AgentState/StorageBase=官方现成)/ 建(tier2 非常驻装配 + 每轮 checkpoint + resume)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-A-03-Workspace双轴注入.svg b/docs/architecture/架构/生成引擎/assets/t2-A-03-Workspace双轴注入.svg index 7015caf3..7cd0012b 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-A-03-Workspace双轴注入.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-A-03-Workspace双轴注入.svg @@ -135,5 +135,5 @@ tier2 不凭空自建 environment 数据面:在官方 Workspace 抽象上挂 tier2 要的工具与资源即可;沙箱底座(Local/Docker/E2B 与 D5 选型)解决「在哪跑、隔离多强」。 - 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md 图3(运行时内部·双轴注入)+ 图8(类图 WorkspaceBase)· tier2实现详设.md §运行时形态 · tier2四层工程架构.md §3(environment 层·载体=Workspace·D5 沙箱底座待验)· agentscope 2.0.2 源码(_agent.py:104 offloader / _toolkit.py:27 get_toolkit / workspace/_base.py:36 三实现)| 状态:现(官方 AgentScope 现成件)/ 建(tier2 注入工具集 + D5 沙箱底座选型)/ 缓(E2B 远端强隔离=更长期层)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md 图3(运行时内部·双轴注入)+ 图8(类图 WorkspaceBase)· agentic运行时架构图说.md §运行时形态 · agentic运行时架构图说.md §3(environment 层·载体=Workspace·D5 沙箱底座待验)· agentscope 2.0.2 源码(_agent.py:104 offloader / _toolkit.py:27 get_toolkit / workspace/_base.py:36 三实现)| 状态:现(官方 AgentScope 现成件)/ 建(tier2 注入工具集 + D5 沙箱底座选型)/ 缓(E2B 远端强隔离=更长期层)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-A-04-Middleware洋葱.svg b/docs/architecture/架构/生成引擎/assets/t2-A-04-Middleware洋葱.svg index 362c99f5..77597d41 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-A-04-Middleware洋葱.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-A-04-Middleware洋葱.svg @@ -111,6 +111,6 @@ D12 现只覆盖 SAA;tier2 接入的入口 / 预算扣减 / 并发释放 / 失败补偿待补(D12 边界,见集成架构 §D12)。 - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §D12 运行治理门(on_model_call / ModelCallEndEvent 软刹缺口与自建硬熔断)· tier2实现详设.md §建设五步第三步「成本强制」· agentscope 2.0.2 源码 middleware/_base.py(4 onion + 1 transformer 钩子)· _budget.py(软刹机制)· _tracing/_trace.py(Event→OTel)| 状态:建(tier2 待建·洋葱 hook 2.0.2 已核;软刹 / trace 官方现成,硬熔断自建)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §5.2 控制面(含 D12 治理门:on_model_call / ModelCallEndEvent 软刹缺口与自建硬熔断)· §建设五步第三步「成本强制」· agentscope 2.0.2 源码 middleware/_base.py(4 onion + 1 transformer 钩子)· _budget.py(软刹机制)· _tracing/_trace.py(Event→OTel)| 状态:建(tier2 待建·洋葱 hook 2.0.2 已核;软刹 / trace 官方现成,硬熔断自建)| 设计变动须同步本图 (放大总览图 8 关键类图的 MiddlewareBase 一支:ReplyBudgetControlMiddleware 现成,TimeoutMiddleware / StuckDetectMiddleware 自建 —— 本图把它们各自挂哪个钩子、做什么逐项展开,不重画类图。) diff --git a/docs/architecture/架构/生成引擎/assets/t2-B-01-控制面四组件.svg b/docs/architecture/架构/生成引擎/assets/t2-B-01-控制面四组件.svg index 4d15f558..902bb229 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-B-01-控制面四组件.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-B-01-控制面四组件.svg @@ -16,26 +16,26 @@ 图 B1 · 控制面四组件(族 B) - tier2 与现行 SAA 廉价线共用的治理层:让两条生成线被配置、观测、审计、在入口拦住。内核 = 配置即数据 · 全链可观测,不从零造 Dify。 + 三档(生成)共用的治理层:让生成全档被配置、观测、审计、在入口拦住。内核 = 配置即数据 · 全链可观测,不从零造 Dify。 整图状态 = 现 + 建·接:D12 与 Prompt Registry 部分已落(现);配置审计 / skill-tool-mcp 推广 / tier2 接入 待建(建·接)。 - 实线框 = 现行已落或已有件复用;虚线框(stroke-dasharray 6 4)= 待建净增量或 tier2 待接。控制面从属于线A、只做净增量;tier2 整轨待 0号 spike 验证。 + 实线框 = 现行已落或已有件复用;虚线框(stroke-dasharray 6 4)= 待建净增量或 tier2 待接。控制面从属于便宜档、只做净增量;tier2 富游戏档 0 号 spike 已 accept、核心已落。 可观测 安全 数据 - - 两条生成线 + + 三档(生成) - + - SAA · Tier0/1 廉价线 + 便宜档 · Tier0/1 · LittleJS 现行 - 16 节点静态 StateGraph + 16 节点静态 StateGraph(SAA,降最低优先级) 读配置 / 写轨迹 / 过 D12 已接 @@ -47,7 +47,7 @@ - 控制面 / 管理面 —— 对两条线暴露同一套契约:读配置 + 写轨迹 + 过门(接口对称 · 内容不对称) + 控制面 / 管理面 —— 对三档暴露同一套契约:读配置 + 写轨迹 + 过门(接口对称 · 内容不对称) @@ -129,21 +129,21 @@ - 接口对称、内容不对称 —— 一份管理面管两条异构线的成立条件 - 读配置:两条线都按「id + 版本」从注册表加载(接口同),但 SAA 读 16 节点参数、tier2 读 ReAct 工具集与轮数预算(内容异)。 - 写轨迹:都按统一 trace 契约写,公共核心子集对称、扩展段各写各的(SAA 放阶段/修复轮/门裁,tier2 放推理/动作/观察)。 - 过治理门:都先过 D12,现只覆盖 SAA、tier2 待接。注意:tier2 的 eval/灰度门尚不存在 —— 其配置改动当前只有「下次生效+轨迹留痕」两层保护、无 eval 拦截。 - 反锁死:控制面对外只暴露读配置/写轨迹/过门三件,平台不绑死任何单一 agent 框架(固化在协议层的是任务/状态/工具/门禁/遥测五件)。 + 接口对称、内容不对称 —— 一份管理面管三档异构生成的成立条件 + 读配置:三档都按「id + 版本」从注册表加载(接口同),但便宜档读 16 节点参数、富游戏档读 ReAct 工具集与轮数预算(内容异)。 + 写轨迹:都按统一 trace 契约写,公共核心子集对称、扩展段各写各的(便宜档放阶段/修复轮/门裁,富游戏档放推理/动作/观察)。 + 过治理门:都先过 D12,现只覆盖便宜档、tier2 待接。注意:tier2 的 eval/灰度门尚不存在 —— 其配置改动当前只有「下次生效+轨迹留痕」两层保护、无 eval 拦截。 + 反锁死:控制面对外只暴露读配置/写轨迹/过门三件,框架统一 AgentScope 但仍不绑死任何单一实现(固化在协议层的是任务/状态/工具/门禁/遥测五件)。 元素级状态读法 - 实线框 = 现行已落 / 已有件复用:SAA 廉价线(读配置·写轨迹·过 D12 已接)、D12 治理门、Prompt Registry(构建期快照那部分)。 + 实线框 = 现行已落 / 已有件复用:便宜档(读配置·写轨迹·过 D12 已接)、D12 治理门、Prompt Registry(构建期快照那部分)。 虚线框 = 待建净增量 / tier2 待接:配置审计日志(全新建)、注册表推广到 skill/tool/mcp、统一 trace 契约新立位、tier2 读配置/写轨迹/过门。 远期紫(phase-3 完整可视化建图)= 远期不投:要等真有多编排 / 多 agent 团队需求、且「拓扑配置化」深坑被填后才上。 存储复用已部署的 MySQL + 对象存储,不新起重型可观测中间件(链路追踪那套是 future-state,等真有第一个消费者再上)。 - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §为什么要这一层(顶部 mermaid)+ §四个组件 | 状态:现(D12 / Prompt Registry 部分已落)+ 接 / 建(配置审计 · skill-tool-mcp 推广 · tier2 接入待建)/ 缓(phase-3 远期)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §4.2/§5(tier2 与控制面)| 状态:现(D12 / Prompt Registry 部分已落)+ 接 / 建(配置审计 · skill-tool-mcp 推广 · tier2 接入待建)/ 缓(phase-3 远期)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-B-02-反锁死五协议.svg b/docs/architecture/架构/生成引擎/assets/t2-B-02-反锁死五协议.svg index d12161e7..580260d6 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-B-02-反锁死五协议.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-B-02-反锁死五协议.svg @@ -12,24 +12,24 @@ 图 B2 · 反锁死五协议(框架可替换 · 族 B) - 平台不绑死任何单一 agent 框架:选了 SAA ≠ 被 SAA 锁死。固化在协议层的五件与框架解耦,框架被压到「只租用不拥有」。 + 平台不绑死任何单一 agent 框架:统一 AgentScope ≠ 被 AgentScope 锁死。固化在协议层的五件与框架解耦,框架被压到「只租用不拥有」。 整图状态 = 建:本图立的是一条根本架构原则(协议层固化、框架解耦);五件中 job/callback 契约 #6 已存在,其余随 tier2 / 控制面分期落地。 - 实线 = 现行已落(GenerationDispatcher 接口 #6 / D12 已有件 / 九门廉价线已建 / new-api 出口);虚线(stroke-dasharray 6 4)= tier2 专属或随分期待建(统一 trace 契约 / 工具接口契约 / tier2 接 D12);远期紫 = AgentScope premium 轨等远期不投。 + 实线 = 现行已落(GenerationDispatcher 接口 #6 / D12 已有件 / 九门便宜档已建 / new-api 出口);虚线(stroke-dasharray 6 4)= tier2 专属或随分期待建(统一 trace 契约 / 工具接口契约 / tier2 接 D12);远期紫 = SAA·dify 远期适配验证等不投核心。 - 当下生产线 SAA-only(HJ-AGI-002,经双评审 + 源码核验选定的实现) - 「选了 SAA」不等于「被 SAA 锁死」——框架可借鉴 / 组合 / 分轨采用(long-term tier2 premium 轨走 AgentScope)。 + 框架统一 AgentScope(三档共编排;SAA/dify 降最低优先级、留作远期适配验证) + 「统一 AgentScope」不等于「被 AgentScope 锁死」——框架可借鉴 / 组合 / 替换(SAA·dify 留作后期验证可插拔的适配目标)。 把协议层那几件钉牢,框架就被压到「只租用不拥有」的位置,换框架时业务不被连根拔起。 - + - long-term premium 轨 + 远期适配验证轨 远期不投 - tier2 premium 走 AgentScope + SAA·dify 留作可插拔验证 @@ -105,11 +105,11 @@ 判据 · 正向:切轨 = 换一个被治理的执行后端 - long-term 把某轨从 SAA 切到 AgentScope 时—— + 远期要把某档从 AgentScope 切到 SAA/dify 做适配验证时—— 只要这五件仍稳稳钉在协议层, 切换就只是换一个被治理的执行后端,不是推倒重来。 - SAA(裸 StateGraph) ⇄ AgentScope(自治 ReAct):业务侧调用方契约不变(不变量五)。 + AgentScope(自治 ReAct) ⇄ SAA(裸 StateGraph):业务侧调用方契约不变(不变量五)。 两套异构范式靠「协议层对称、执行后端可换」共存。 @@ -125,11 +125,11 @@ 框架被压到「只租用不拥有」 · 协议层固化 · 执行后端可换 - 五件钉牢的是平台真正固化、不随框架走的东西;框架(SAA / AgentScope / LangGraph / AutoGen)只在五件契约的约束下被借鉴 / 组合 / 分轨采用。 - 这条原则不是空谈「将来好换」,它有具体落点:它正是 long-term 要不要把某条轨从 SAA 切到 AgentScope 时的判据。 - 现行已落锚点(实线):契约 #6 GenerationDispatcher 接口已存在;九门由廉价线已建(验收门禁);D12 入口治理为已有件;模型出口统一收口 new-api 计费平面。 + 五件钉牢的是平台真正固化、不随框架走的东西;框架(AgentScope / SAA / LangGraph / AutoGen)只在五件契约的约束下被借鉴 / 组合 / 替换。 + 这条原则不是空谈「将来好换」,它有具体落点:它正是远期要不要把某档从 AgentScope 切到 SAA/dify 做适配验证时的判据。 + 现行已落锚点(实线):契约 #6 GenerationDispatcher 接口已存在;九门由便宜档已建(验收门禁);D12 入口治理为已有件;模型出口统一收口 new-api 计费平面。 待建锚点(虚线):状态模型 / 工具接口的契约化、统一 trace 契约(contracts/trace/ 当前未立位)、tier2 接 D12,随 0号 spike 与控制面分期落地。 - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §「Agent 框架可替换:反锁死原则」· SAA编排.md §1 决策锚点 / §4 不变量五(GenerationDispatcher 契约 #6) | 状态:建(原则·协议层固化;契约 #6 已存在,余随分期落地)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §一(反锁死原则)/ §4 不变量五(GenerationDispatcher 契约 #6)| 状态:建(原则·协议层固化;契约 #6 已存在,余随分期落地)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-B-03-预算三层强制.svg b/docs/architecture/架构/生成引擎/assets/t2-B-03-预算三层强制.svg index 640d7378..d526139a 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-B-03-预算三层强制.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-B-03-预算三层强制.svg @@ -113,5 +113,5 @@ (C3「四道熔断」是总览,本图只深挖其中预算这一道 + D12 网关配额;spike 阶段成本熔断可先只挂官方软刹,硬熔断与三层强制到建设期补全。) - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §D12 运行治理门(官方软刹 vs 自建硬熔断 + 三层强制)· tier2实现详设.md §建设五步 第三步 成本强制 | 状态:现(官方 ReplyBudgetControlMiddleware + D12 已有)/ 建(硬熔断 + 三层强制自建待落)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §5.2 控制面(含 D12 治理门:官方软刹 vs 自建硬熔断 + 三层强制)· §建设五步 第三步 成本强制 | 状态:现(官方 ReplyBudgetControlMiddleware + D12 已有)/ 建(硬熔断 + 三层强制自建待落)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-B-04-管理面三phase.svg b/docs/architecture/架构/生成引擎/assets/t2-B-04-管理面三phase.svg index eb617a03..a2e8772a 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-B-04-管理面三phase.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-B-04-管理面三phase.svg @@ -33,7 +33,7 @@ 设计选择先定:不从零造 Dify 式建图器,让配置成为真相、UI 只做配置+轨迹的视图与编辑器 - ① 已拍板维持现有 SAA / AgentScope、不迁可视化平台;② 裸图节点是 Java 代码、ReAct 工具也是代码 — 真相在代码和配置里,拖拽生成代码是另一套不可靠范式; + ① 已拍板框架统一 AgentScope、不迁可视化平台;② 裸图节点是 Java 代码、ReAct 工具也是代码 — 真相在代码和配置里,拖拽生成代码是另一套不可靠范式; ③ 别过度工程的纪律。但「配置是真相、UI 是视图」不等于「第一期什么都不做」— 管理面按三档落,且诚实命名(下排)。 @@ -100,7 +100,7 @@ 贯穿约束 ② 接口对称、内容不对称 - 「一份管理面管两条异构线」能成立的条件:接口层对称、内容层不对称。 + 「一份管理面管三档异构生成」能成立的条件:接口层对称、内容层不对称。 @@ -126,8 +126,8 @@ 要写明的现实 · 不是设计缺陷,是 tier2 成熟度的现状 配置安全门要分清:tier2 的 eval / 灰度门是 tier2 实验的产物、现在不存在。 所以「配置改动要过 eval 门」对 tier2 现在是空头支票 — eval 门建成前,tier2 配置改动只有「下次任务生效 + 轨迹留痕」两层保护,没有 eval 门拦截。 - 写明这点,否则会让人以为 tier2 配置改动有它实际没有的安全网。(SAA 廉价线则已落 D12 + Git CI 校验,保护更全。) + 写明这点,否则会让人以为 tier2 配置改动有它实际没有的安全网。(便宜档则已落 D12 + Git CI 校验,保护更全。) - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §管理面 UI + §接口对称内容不对称 + §关于 workflow 编排(放大总览图 5 的管理面/配置维度)| 状态:接(phase-1)/ 缓(phase-2)/ future 不投(phase-3)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §管理面 UI + §接口对称内容不对称 + §4.2/§5(tier2 与控制面)| 状态:接(phase-1)/ 缓(phase-2)/ future 不投(phase-3)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-C-01-单写ReAct循环.svg b/docs/architecture/架构/生成引擎/assets/t2-C-01-单写ReAct循环.svg index b0a35443..c871429a 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-C-01-单写ReAct循环.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-C-01-单写ReAct循环.svg @@ -20,11 +20,11 @@ 图 C1 · 单写 ReAct 循环(族 C) - 一个单写者 ReAct agent 在三层校验门内自治造富游戏:想一步 → 调一个工具 → 看结果 → 再想。tier2 演进自 WG1 studio.py,待 0号 spike 验证。 + 一个单写者 ReAct agent 在三层校验门内自治造富游戏:想一步 → 调一个工具 → 看结果 → 再想。tier2 演进自 WG1 studio.py,0 号 spike 已 accept、核心已落。 - 整图状态 = 建(tier2 整轨待 0号 spike 验证、尚未落代码)。 + 整图状态 = 建·核心已落(tier2 0 号 spike 已 accept,单写 ReAct 主干跑通;细化待续)。 实线 = 承袭现行已落(九门 harness · A-model driven 感知);虚线(stroke-dasharray 6 4)= tier2 专属新机制,待建;红线 = 四道熔断。 @@ -56,12 +56,12 @@ - 为压便宜档单价:L1 生产主线 - 明确不引 AgentScope(框架 token 膨胀) + 早期为压便宜档单价采单轮;预算闸放松后 + 三档已统一改用 AgentScope 编排 - tier2 富游戏线(待建 · fork 起步) + tier2 富游戏档(核心已落 · fork 起步) max_iters 放开(2.0.2 默认 20) 把多轮自治从外层 repair 循环 搬进 Agent 内部 ReAct 循环 @@ -180,5 +180,5 @@ 经营游戏多系统共享同一套状态与约定,拆并行几乎必不一致。一手教训:曾把「造 Flappy Bird」拆给并行子 agent,背景跑成了马里奥。 「单写者」专指阶段 2 写代码环节(阶段 1 工作室设计仍用 Agent Team 星形多 agent 发散);旁配只读探路 agent + 一道独立评审。 - 映射:自治富游戏引擎.md §「谁在写:单写者 ReAct + 四道熔断」 · tier2实现详设.md §「运行时形态」第二阶段 + §「建设五步」第一步 | 状态:建(tier2 待建,演进自 WG1 studio.py)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §4.2/§5(单写者 ReAct + 四道熔断 · 运行时形态 · 建设五步)| 状态:建·核心已落(tier2 0 号 spike 已 accept,演进自 WG1 studio.py)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-C-02-M3原生接法.svg b/docs/architecture/架构/生成引擎/assets/t2-C-02-M3原生接法.svg index caa8a5ad..5b2ff1c8 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-C-02-M3原生接法.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-C-02-M3原生接法.svg @@ -107,5 +107,5 @@ 不论走哪条端点,计量都收口到 new-api 的 quota 口径(per-model 折¥)— 一个计费平面,成本可对账。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §模型矩阵与样本量(M3 行接法说明)· 项目记忆 m3-agentic-anthropic-protocol(Anthropic 原生 thinking + 工具循环)| 状态:建(M3 接法走官方 AnthropicChatModel,AgentScope 2.0.2 已核)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §模型矩阵与样本量(M3 行接法说明)· 项目记忆 m3-agentic-anthropic-protocol(Anthropic 原生 thinking + 工具循环)| 状态:建(M3 接法走官方 AnthropicChatModel,AgentScope 2.0.2 已核)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-C-03-四道熔断.svg b/docs/architecture/架构/生成引擎/assets/t2-C-03-四道熔断.svg index f3c091e4..1b6674ef 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-C-03-四道熔断.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-C-03-四道熔断.svg @@ -12,7 +12,7 @@ - 整图状态 = 建:tier2 待 0 号 spike 验证、尚未落代码。实线 = 现行已落或官方现成;虚线(stroke-dasharray)= tier2 待建。 + 整图状态 = 建·核心已落:tier2 0 号 spike 已 accept、主干跑通。实线 = 现行已落或官方现成;虚线(stroke-dasharray)= 待细化。 预算闸用官方 ReplyBudgetControlMiddleware(现成软刹,画实线);三道硬熔断 + 强制硬闸为 tier2 自建(待落,画虚线)。spike 阶段可先只挂官方软刹。 @@ -76,9 +76,9 @@ 警示 · 预算闸现还不是强制硬闸(待建) 官方软刹只在钩子里按预算优雅收尾,是 best-effort,不强制截断;自治多轮一旦不强制,会在 56% 表现层上烧钱发散。 - 强制硬闸的完整口径归《agentic 集成架构》那份;规模化(premium 量起来)前必须落地,否则成本不可控。 + 强制硬闸的完整口径归 agentic 运行时架构图说那份;规模化(富游戏档量起来)前必须落地,否则成本不可控。 spike 阶段退路:可先只挂官方 ReplyBudgetControlMiddleware 软刹跑通验证,强制硬闸 + 三道自建硬熔断到建设期再补——不阻塞 spike。 - 映射:自治富游戏引擎.md §「谁在写:单写者 ReAct + 四道熔断」(K 节点)· tier2实现详设.md §「建设五步」第三步成本强制 + §「前置物清单」 | 状态:建(软刹官方现成 / 硬熔断 + 强制硬闸自建待落、现 best-effort)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §4.2/§5(单写者 ReAct + 四道熔断 · 建设五步第三步成本强制 · 前置物清单)| 状态:建(软刹官方现成 / 硬熔断 + 强制硬闸自建待落、现 best-effort)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-C-04-多轮范式承amodel.svg b/docs/architecture/架构/生成引擎/assets/t2-C-04-多轮范式承amodel.svg index 07e874ef..63dc0140 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-C-04-多轮范式承amodel.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-C-04-多轮范式承amodel.svg @@ -19,7 +19,7 @@ - 整图状态 = 建(范式承 A-model 已落 / tier2 fork 演进、待 0号 spike)。 + 整图状态 = 建·核心已落(范式承 A-model 已落 / tier2 fork 演进、0 号 spike 已 accept)。 实线 = 现行已落(wg1 studio.py 单轮 + repair · amodel-gen 多轮 JS harness,均 working reference);虚线 = tier2 专属、待建(Python·AgentScope 2.0.2 多轮自治造 Phaser 富游戏)。 质量 @@ -57,7 +57,7 @@ reason → act 写源 → 读 verdict → 再 reason 种子仍是 studio.py(Python) 造 Phaser 多系统富游戏(肥鹅美食街档) - 整轨待 0号 spike 验证 · 尚未落代码 + 0 号 spike 已 accept · 核心已落、细化待续 @@ -97,7 +97,7 @@ - 边界说明 · fork 演进而非返工(创始人 2026-06-23 裁:两线分立、不收敛) + 边界说明 · fork 演进而非返工(2026-06-25 reframe 已收敛为三档统一 AgentScope,06-23 两线分立口径已被取代) 复用躯干:tier2 复用 studio 那套多角色 prompt 与生成域(design / code / fix)的躯干,把「多轮」从外层 repair 循环搬进 Agent 内部 ReAct(max_iters 放开)。 接法 A(七成已建)是接法 B(ReAct 自治)的躯干 evolve——是 fork 起步、独立演进、运行期零依赖现有 worker,不是推倒重来。 种子归属:种子仍是 studio.py(Python · 框架接缝 6 符号在 2.0.2 兼容、版本钉级别);amodel-gen 只作 working reference(JS · 参照循环范式,不照搬)。 @@ -106,5 +106,5 @@ tier2 待建(虚线):amodel-gen 合并 dev/2.0.0 后,循环范式以合并后版本为参照系重取;多轮 ReAct / Workspace / Service 是 net-new 的真功夫(Phase B)。 边界从旧「能力档(声明式 vs 自治)」精确为「引擎 / 表现层复杂度档」:A-model 吃 LittleJS 轻量档,tier2 吃 Phaser 重表现富游戏档。 - 映射:docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md §与 A-model 分支的关系 · tier2/HANDOFF.md §与 A-model 分支的协调 · tier2实现详设.md §建设五步(第一步) · wg1/gen-worker/worker/agent_loop/studio.py:159/:266 | 状态:建 | 设计变动须同步本图 + 映射:docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md §与 A-model 分支的关系 · tier2/HANDOFF.md §与 A-model 分支的协调 · agentic运行时架构图说.md §4.2/§5(建设五步第一步)· wg1/gen-worker/worker/agent_loop/studio.py:159/:266 | 状态:建·核心已落 | 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-D-01-三层校验全景.svg b/docs/architecture/架构/生成引擎/assets/t2-D-01-三层校验全景.svg index 8bfadc2f..d24e4d7d 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-D-01-三层校验全景.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-D-01-三层校验全景.svg @@ -47,5 +47,5 @@ ② L3(M3 视觉)严格只评分、绝不阻塞、绝不单独拒发——防 Goodhart(VLM 提成硬门会被刷)。 ③ 初期只识别硬问题(L1),L2/L3 渐进;绝不让效果问题阻塞真问题;用户可经 HITL 要求继续解决任意层。 - 映射:tier2四层工程架构.md §4.1 · tier2实现详设.md · 自治富游戏引擎.md(已升三层口径)· plan U6/U9 | 状态:建(tier2 待建 · 初期只焊 L1)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §4.2/§5(三层校验口径,tier2 内容)· plan U6/U9 | 状态:建·核心已落(tier2 0 号 spike 已 accept · 初期只焊 L1)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-D-02-九门逐门.svg b/docs/architecture/架构/生成引擎/assets/t2-D-02-九门逐门.svg index a3e69ed7..2492804b 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-D-02-九门逐门.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-D-02-九门逐门.svg @@ -111,5 +111,5 @@ tier2 待建(虚线):探针为 Phaser 重写——#game-engine 选择器 / window.__engine.snapshot().frame 帧源 / __gameHostEngineInitFired boot 信号 全换。 这是「重写适配层、非参数化」;沙箱底座(agentscope-runtime BrowserSandbox vs 复用现有 CDP)= spike 前置阻断验证(见计划 U3)。 - 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs · tier2四层工程架构.md §4.1 · plan U3/U6 | 状态:现(九门=LittleJS 现行)/ 建(tier2 Phaser 重写探针)| 设计变动须同步本图 + 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs · agentic运行时架构图说.md §4.1 · plan U3/U6 | 状态:现(九门=LittleJS 现行)/ 建(tier2 Phaser 重写探针)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-D-03-富游戏专属门.svg b/docs/architecture/架构/生成引擎/assets/t2-D-03-富游戏专属门.svg index 8670cfe7..3002443d 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-D-03-富游戏专属门.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-D-03-富游戏专属门.svg @@ -11,16 +11,16 @@ 图 D3 · 富游戏专属确定性门(族 D) - 九门是超休闲单局的机制地板;富游戏的本质难点是多系统接线,故 tier2 在九门之上补三道确定性门(全为 tier2 待建)。 + 九门是轻量单局的机制地板;富游戏的本质难点是多系统接线,故 tier2 在九门之上补三道确定性门(tier2 核心已落、细化待续)。 - 整图状态 = 建(tier2 待建 · 经营品类专属确定性门):整轨待 0号 spike 验证、尚未落代码。 - 实线 = 承袭现行已落(九门 harness / A-model 已建);虚线 = tier2 专属新机制(三联动门 / 经济门 / latch 门 · 待建)。 + 整图状态 = 建·核心已落(tier2 经营品类专属确定性门):0 号 spike 已 accept、富游戏三门跑通。 + 实线 = 承袭现行已落(九门 harness / A-model 已建);虚线框 = tier2 专属新机制(三联动门 / 经济门 / latch 门 · 核心已落、细化待续)。 - 现行九门 = 「超休闲单局」的机制地板(实线,已落 · 见 D2);它确定性地判「能不能玩」,但不查跨系统接线。 + 现行九门 = 「轻量单局」的机制地板(实线,已落 · 见 D2);它确定性地判「能不能玩」,但不查跨系统接线。 富游戏(mini-肥鹅级)是多个系统耦合,光过九门不够 —— 还要确定性地证「三系统真接上了」「经济双路径真能跑到终态」「终态真落定」,故补下面三门。 @@ -36,7 +36,7 @@ • 合成消耗调资源系统 consumeIngredient L1 硬 - tier2待建 + 核心已落 assertAfterPlay:订单引物品可达、 合成 DAG 无环 @@ -53,7 +53,7 @@ 驱动跑到终态(不是只在数据表里能算) L1 硬 - tier2待建 + 核心已落 assertAfterPlay:经济可盈利可破产 @@ -68,7 +68,7 @@ (约束写者把终态焊成可轮询 latch) L1 硬 - tier2待建 + 核心已落 承 A-model「observe→enforce」范式(见 D2 脚带) @@ -80,7 +80,7 @@ + - tier2 三道专属门(虚线 · 待建) + tier2 三道专属门(核心已落) ① 三联动门(跨表可达 + DAG) ② 经济门(盈利 / 破产双路径) ③ latch 门 @@ -88,7 +88,7 @@ tier2 的 L1 机制地板 - 九门(超休闲地板)+ 三门(富游戏接线地板) + 九门(轻量地板)+ 三门(富游戏接线地板) 共同构成 · 全绿 = 富游戏机制地板通过 @@ -100,7 +100,7 @@ 3×3 合成棋盘 · 资源系统(金币 + 食材库存 {coins, ingredients})· 3~5 个顾客订单(含 patience)。 内容量:12 个物品 / 6 条合成链(mergeChains)/ 5 个订单模板(orders)/ 2 种货币 —— 砍到能证、又保住多系统耦合 + 重 UI 表现层 + 数值经济闭环三个本质难点。 - assertAfterPlay 规格(前置物清单 · tier2 待建):① 订单引物品可达(合成产出能满足全部订单 requires); + assertAfterPlay 规格(前置物清单 · tier2 核心已落):① 订单引物品可达(合成产出能满足全部订单 requires); ② 合成 DAG 无环(mergeChains 拓扑无环);③ 经济可盈利可破产(金币 20→100 赢路径、连续 3 单流失输路径,两路径 harness 真输入驱动可达终态并 latch)。 复用 game-e2e-cdp-harness 四件套证据(render→截图时序→驱动→verdict);driver 按「点合成格→凑齐订单物品→交单→看金币涨」确定性序列预建。 @@ -109,5 +109,5 @@ 可靠 数据 - 映射:tier2实现详设.md §靶子游戏-mini-肥鹅 / §过门判据与精确阈值 / §前置物清单 | 状态:建(tier2 待建 · 经营品类专属确定性门)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §4.2/§5(靶子游戏 mini-肥鹅 · 过门判据与精确阈值 · 前置物清单)| 状态:建·核心已落(tier2 经营品类专属确定性门 · 0 号 spike 已 accept)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-D-04-advisory分级与Goodhart隔离.svg b/docs/architecture/架构/生成引擎/assets/t2-D-04-advisory分级与Goodhart隔离.svg index 13a2c660..f435f252 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-D-04-advisory分级与Goodhart隔离.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-D-04-advisory分级与Goodhart隔离.svg @@ -118,5 +118,5 @@ driver_rejected_by_review = 自产 driver 被独立评审打回的比例 · driver_edits = driver 修改次数(防它靠反复改 driver 逃避卡死探测)。 - 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs(advisory 分级 L1077-1085·A-model 分支)· 生成引擎/tier2实现详设.md §两段实施步骤 第二段 + §建设五步 第三步 Goodhart 安全 | 状态:现(advisory=A-model 已落)/ 建(自产 driver 三层隔离=tier2 第二段待建)| 设计变动须同步本图 + 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs(advisory 分级 L1077-1085·A-model 分支)· 生成引擎/agentic运行时架构图说.md §两段实施步骤 第二段 + §建设五步 第三步 Goodhart 安全 | 状态:现(advisory=A-model 已落)/ 建(自产 driver 三层隔离=tier2 第二段待建)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-D-05-CDP探针Phaser重写.svg b/docs/architecture/架构/生成引擎/assets/t2-D-05-CDP探针Phaser重写.svg index c501b789..39f4e3f1 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-D-05-CDP探针Phaser重写.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-D-05-CDP探针Phaser重写.svg @@ -18,7 +18,7 @@ - 整图状态 = 建(tier2 待建·待 0号 spike 验证)。实线 = 现行已落(九门 harness / A-model 已建的 LittleJS 探针);虚线框 = tier2 专属新机制(Phaser 重写 + 沙箱底座 spike,尚未落代码)。 + 整图状态 = 建·核心已落(tier2 0 号 spike 已 accept)。实线 = 现行已落(九门 harness / A-model 已建的 LittleJS 探针);虚线框 = tier2 专属新机制(Phaser 重写 + 沙箱底座 spike,细化待续)。 右侧 Phaser 钩子全画虚线;实线 LittleJS 钩子 → 虚线 Phaser 钩子的「重写映射」用虚线箭头,逐条须各自重写,不是一个参数切过去。 可观测 @@ -114,5 +114,5 @@ 阻断关系:沙箱底座结论须在 U7 生成迭代开跑前出来——这道结论不出,U7 的生成迭代跑不起来(spike 前置阻断项,见 plan U3 / Risks)。 - 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs · docs/plans/2026-06-22-003-…-plan.md U3 · tier2实现详设.md §前置物清单 · 自治富游戏引擎.md §引擎是能力包 | 状态:建(tier2 Phaser 重写探针 + 沙箱底座 spike,待 0号 spike 验证)| 设计变动须同步本图 + 映射:game-runtime/games/_wg1-gen/_shared/play.cdp.cjs · docs/plans/2026-06-22-003-…-plan.md U3 · agentic运行时架构图说.md §4.2/§5(前置物清单 · 引擎是能力包)| 状态:建·核心已落(tier2 Phaser 重写探针 + 沙箱底座 spike · 0 号 spike 已 accept)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-E-01-skills清单.svg b/docs/architecture/架构/生成引擎/assets/t2-E-01-skills清单.svg index ff590f62..f8382d9a 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-E-01-skills清单.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-E-01-skills清单.svg @@ -109,5 +109,5 @@ tier2 待建(虚线):工具的 Phaser 实现(esbuild profile / Phaser harness 钩子)按引擎重写;第一版 Phaser 硬编码进 worker,第二引擎落地后再抽通用能力包接口(见 E2)。 - 映射:tier2实现详设.md §运行时形态 / §前置物清单 · 自治富游戏引擎.md §引擎是能力包 · plan U2/U5 | 状态:建(tier2 待建 · 演进自 wg1 studio.py)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.5 能力面(skills 与 MCP 工具)/ §4.2 Phaser 富游戏档 · plan U2/U5 | 状态:建(tier2 待建 · 演进自 wg1 studio.py)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-E-02-引擎能力包manifest.svg b/docs/architecture/架构/生成引擎/assets/t2-E-02-引擎能力包manifest.svg index 56d60b96..99c87a8c 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-E-02-引擎能力包manifest.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-E-02-引擎能力包manifest.svg @@ -94,5 +94,5 @@ 承袭现行已落(实线):九门 harness 的钩子机制本身、A-model 的 driver 感知分级——这些是现行 LittleJS 廉价线已建、tier2 复用其哲学而非新造。 - 映射:自治富游戏引擎.md §引擎是能力包不是底座 · tier2实现详设.md §运行时形态 · 见 E-01 toolkit | 状态:建(第一版 Phaser 硬编码 · 通用接口待第二引擎)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.5 能力面(引擎=能力包不是底座)/ §4.2 Phaser 富游戏档 · 见 E-01 toolkit | 状态:建(第一版 Phaser 硬编码 · 通用接口待第二引擎)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-E-03-prompt两阶段角色.svg b/docs/architecture/架构/生成引擎/assets/t2-E-03-prompt两阶段角色.svg index e783a120..12b93f7b 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-E-03-prompt两阶段角色.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-E-03-prompt两阶段角色.svg @@ -126,5 +126,5 @@ 「单写者」专指阶段 2 写代码环节,不是整轨只一个 agent:阶段 1 设计用多 agent 要发散 + 专业分工,阶段 2 实现收敛到单写要防并行写冲突。 承袭实线 = 九门 harness / A-model(现行已落,见 D2);tier2 专属新机制(Agent Team 星形 / 单写 ReAct 多轮)= 虚线待建,待 0号 spike 验证。 - 映射:tier2实现详设.md §「运行时形态:两阶段、service 化与 session 三路径」 · 自治富游戏引擎.md §「换一种生成方式」+§「谁在写:单写者 ReAct」 | 状态:建(阶段1 Agent Team / 阶段2 单写,2.0.2 API 已核)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.1 运行时形态(两阶段 · session 三路径)+ §5.3 单写者 ReAct | 状态:建(阶段1 Agent Team / 阶段2 单写,2.0.2 API 已核)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-E-04-Amodel插件复用.svg b/docs/architecture/架构/生成引擎/assets/t2-E-04-Amodel插件复用.svg index a777329b..8f842e05 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-E-04-Amodel插件复用.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-E-04-Amodel插件复用.svg @@ -8,12 +8,12 @@ 图 E4 · A-model 4 插件复用(族 E) - A-model(Tier1 廉价线 agentic 优化)造的资产 tier2 接住、别重新发明。两线分立:A-model 吃 LittleJS 轻量经营档,tier2 吃 Phaser 重表现富游戏档。 + A-model(便宜档 Tier0/1 的轻量自治)造的资产 tier2 接住、别重新发明。三档统一 AgentScope、按 AI 参与深度分:A-model 吃 LittleJS 轻量经营档,tier2 吃 Phaser 重表现富游戏档。 整图状态:接(复用 A-model 已落资产 · 合并后对账)。实线框 = A-model 现行已落(承袭即用);虚线框 = tier2 专属新机制(待 0 号 spike 验证、尚未落代码)。 - 两线分立(创始人 2026-06-23 裁):边界 = 引擎 / 表现层复杂度档,非能力档。A-model = LittleJS 轻量自治(单局 + 轻量经营/合成);tier2 = Phaser 重表现富游戏(肥鹅美食街档)。 + 两线分立(创始人 2026-06-23 裁),06-25 reframe 已收敛三档统一 AgentScope、取代之:边界 = AI 参与深度档。A-model = 便宜档(Tier0/1)的轻量自治(LittleJS);tier2 = Phaser 重表现富游戏(肥鹅美食街档)。 数据 @@ -107,5 +107,5 @@ 注脚:A-model 合并 dev/2.0.0 后,接缝(play.cdp.cjs / source-project.schema.json)会刷新——实现 tier2 时以合并后版本为准对账(plan §61 · HANDOFF §35)。 - 映射:plan「与 A-model 分支的关系」§54/§56/§57/§61 · tier2/HANDOFF.md「与 A-model 分支的协调」§30/§32/§33/§35 | 状态:接(复用 A-model 资产,合并后对账)| 设计变动须同步本图 + 映射:plan「与 A-model 分支的关系」§54/§56/§57/§61 · tier2/HANDOFF.md「与 A-model 分支的协调」§30/§32/§33/§35 | 状态:接(复用 A-model 资产,合并后对账)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-F-01-源项目契约七要素.svg b/docs/architecture/架构/生成引擎/assets/t2-F-01-源项目契约七要素.svg index ce661e4b..25fad61b 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-F-01-源项目契约七要素.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-F-01-源项目契约七要素.svg @@ -111,5 +111,5 @@ 接上产品基座:游戏是长生命周期的结构化源项目,改源不改包、重新构建 —— 真·多文件 Phaser 工程本身就是一个可维护的源项目。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §第一批工程定义:源项目契约(七要素四组 / finish 工具共用 / 命名边界)· (放大总览图 7 产物与契约)docs/architecture/架构/生成引擎/agentic运行时架构图说.md | 状态:建(tier2 待建·契约组新一类 additive;承袭现行 GamePackage 落库取回这条路 = 实线)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §第一批工程定义:源项目契约(七要素四组 / finish 工具共用 / 命名边界)· (放大总览图 7 产物与契约)docs/architecture/架构/生成引擎/agentic运行时架构图说.md | 状态:建(tier2 待建·契约组新一类 additive;承袭现行 GamePackage 落库取回这条路 = 实线)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-F-02-第二装载分支.svg b/docs/architecture/架构/生成引擎/assets/t2-F-02-第二装载分支.svg index ca7275b8..571c5a3c 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-F-02-第二装载分支.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-F-02-第二装载分支.svg @@ -131,5 +131,5 @@ 可靠 = sha256 / 内容哈希完整性校验 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §第一批工程定义:源项目契约(现行 engineBundle 装载 + tier2 第二装载路)· (放大总览图 7 产物与契约)· 项目记忆 runner-v2-p1-loading-contract(__GameBundle / bootGameHost / engineBundle 内嵌 manifest 已落实证)| 状态:现(ECS-lite 装载已落)+ 建(tier2 Phaser 第二装载分支待建)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §第一批工程定义:源项目契约(现行 engineBundle 装载 + tier2 第二装载路)· (放大总览图 7 产物与契约)· 项目记忆 runner-v2-p1-loading-contract(__GameBundle / bootGameHost / engineBundle 内嵌 manifest 已落实证)| 状态:现(ECS-lite 装载已落)+ 建(tier2 Phaser 第二装载分支待建)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-F-03-finish共用schema.svg b/docs/architecture/架构/生成引擎/assets/t2-F-03-finish共用schema.svg index 846cddf3..0114ebf4 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-F-03-finish共用schema.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-F-03-finish共用schema.svg @@ -141,6 +141,6 @@ 定义工程怎么存进 MySQL + 对象存储、怎么按 id 取回重建(即链路④⑤的依据)。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §第一批工程定义:源项目契约(finish 工具共用 schema 那段 / 七要素四组 / 落库取回链路)| 状态:建(finish 与契约共用一份 schema · tier2 待 0号 spike)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §第一批工程定义:源项目契约(finish 工具共用 schema 那段 / 七要素四组 / 落库取回链路)| 状态:建(finish 与契约共用一份 schema · tier2 待 0号 spike)| 设计变动须同步本图 放大《agentic 运行时架构图说》图 7「产物与契约」:图 7 给五要素扁平链,本图逐项展开七要素四组 + finish 工具 + 共用 schema 防漂移机制 + 交付→落库→取回链路(deepen 不 duplicate)。 diff --git a/docs/architecture/架构/生成引擎/assets/t2-G-01-建设五步与spike门.svg b/docs/architecture/架构/生成引擎/assets/t2-G-01-建设五步与spike门.svg index 11b75e16..a2f5afbe 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-G-01-建设五步与spike门.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-G-01-建设五步与spike门.svg @@ -24,7 +24,7 @@ 整图状态 = 建:tier2 整轨待 0号 spike 验证、尚未落代码;故 tier2 专属新机制(spike 门、五步路径、隐藏硬工作)一律画虚线。 - 实线 = 承袭现行已落(AgentScope 2.0.2 官方件 / SAA 廉价线 / L1 九门 / W-CH-α 渠道路);虚线(stroke-dasharray 6 4)= 待建;远期紫 = 远期不投核心循环(Cocos)。 + 实线 = 承袭现行已落(AgentScope 2.0.2 官方件 / 便宜档 Tier0/1·LittleJS / L1 九门 / W-CH-α 渠道路);虚线(stroke-dasharray 6 4)= 待建;远期紫 = 远期不投核心循环(Cocos)。 建设主干(纵向五步 · spike 门插在第二步与第三步之间) @@ -95,7 +95,7 @@ 隐藏硬工作 · 第四步(把「人审」做实,不是创始人亲玩一票) ① 终审判据 —— 把「好玩」拆成可复核的几条、压个人品味方差。 - ② 终审吞吐模型 —— 否则 premium 量一上来,人审变瓶颈或橡皮图章。 + ② 终审吞吐模型 —— 否则 tier2 富游戏档量一上来,人审变瓶颈或橡皮图章。 ③ player panel 减负 —— 判明显劣化信号(可达性 / 空内容这些确定性可逼近的)给人门减负。 承接:终审地板 = 第三步「验收地板」泛化的 L1;终审吞吐与 panel 都是为「人审不成瓶颈」服务。 产物 = 可维护、可回头改和扩的 Phaser 源工程(改源不改包),非生成完就完的一次性产物。 @@ -135,6 +135,6 @@ Goodhart 安全:自产 driver 过白名单 + 独立评审,写者不判自己的卷 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §建设五步与 0号 spike 生死门(含 mermaid)+ §退路树(放大见 G5)+ §三层校验(L1)| 状态:建(tier2 待建 · 五步 + spike 生死门)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §4.2 Phaser 富游戏档(五步 + 0号 spike 生死门 + 退路树)+ §5.4 三层校验(L1)| 状态:建(tier2 待建 · 五步 + spike 生死门)| 设计变动须同步本图 承接《agentic 运行时架构图说》(看图入口)的「建设/spike」一面逐项放大:deepen 不 duplicate —— 总览给系统全景与对象结构,本图给五步顺序、spike 插点、隐藏硬工作与退路触发线的细节。 diff --git a/docs/architecture/架构/生成引擎/assets/t2-G-02-mini肥鹅靶子.svg b/docs/architecture/架构/生成引擎/assets/t2-G-02-mini肥鹅靶子.svg index 96ab253a..cb1504a3 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-G-02-mini肥鹅靶子.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-G-02-mini肥鹅靶子.svg @@ -159,5 +159,5 @@ 保留:三个联动系统 + 确切耦合点(spike 考点) - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §靶子游戏 mini-肥鹅(含三系统耦合 mermaid)· §过门判据(latch / 胜负阈值)· §前置物清单(人工预建骨架 + driver)| 状态:建(tier2 待建·spike 靶子施工图)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §靶子游戏 mini-肥鹅(含三系统耦合 mermaid)· §过门判据(latch / 胜负阈值)· §前置物清单(人工预建骨架 + driver)| 状态:建(tier2 待建·spike 靶子施工图)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-G-03-模型矩阵与跑序.svg b/docs/architecture/架构/生成引擎/assets/t2-G-03-模型矩阵与跑序.svg index 5e4fdf82..31348105 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-G-03-模型矩阵与跑序.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-G-03-模型矩阵与跑序.svg @@ -166,5 +166,5 @@ 看把模型降到主力便宜档,过门率与单款成本各掉多少;Opus/Fable 仍只作路通不通上限基线、不进成本评估。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §模型矩阵与样本量(模型矩阵表 + 跑序 2026-06-21)· M3 接法逐项见 C2(放大)· 项目记忆 m3-agentic-anthropic-protocol | 状态:现(deepseek 两档/mini-desktop 已有)/ 建(tier2 spike 矩阵)/ 缓(Opus·Fable 仅基线)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §模型矩阵与样本量(模型矩阵表 + 跑序 2026-06-21)· M3 接法逐项见 C2(放大)· 项目记忆 m3-agentic-anthropic-protocol | 状态:现(deepseek 两档/mini-desktop 已有)/ 建(tier2 spike 矩阵)/ 缓(Opus·Fable 仅基线)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-G-04-过门阈值与采集字段.svg b/docs/architecture/架构/生成引擎/assets/t2-G-04-过门阈值与采集字段.svg index bfed81d5..a712ecb2 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-G-04-过门阈值与采集字段.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-G-04-过门阈值与采集字段.svg @@ -135,5 +135,5 @@ 汇总到矩阵级(每模型档)→ go/no-go 直接输入:① 过门率 = pass 款数 / n ② ¥/成功款 = Σcost / pass 款数 ③ 收敛中位数 ④ fail_system 分布 — 对照 A 区阈值与退路树触发线判。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §过门判据与精确阈值 + §采集指标字段表(汇总三张图见同档退路树触发线)| 状态:建(tier2 待建 · spike 阈值 + 采集字段;★ 需创始人和实测校准)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §过门判据与精确阈值 + §采集指标字段表(汇总三张图见同档退路树触发线)| 状态:建(tier2 待建 · spike 阈值 + 采集字段;★ 需创始人和实测校准)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-G-05-两段实施与退路树.svg b/docs/architecture/架构/生成引擎/assets/t2-G-05-两段实施与退路树.svg index 2f02aa25..30d9c07e 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-G-05-两段实施与退路树.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-G-05-两段实施与退路树.svg @@ -233,6 +233,6 @@ 铁律:五条出口(GO / R1 / R2 / R3 / KEEP)都是「据数字裁定一步」—— 退路树真能被触发、不悬空,KEEP 也只许据具体数微调一轮,绝不滑成无限调参。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §两段实施步骤(含 mermaid)+ §退路树(含 mermaid)· §过门判据与精确阈值 · §采集指标字段表(fail_system / driver 安全列)| 状态:建(tier2 待 0号 spike 验证)| 设计变动须同步本图 + 映射:docs/architecture/架构/生成引擎/agentic运行时架构图说.md §两段实施步骤(含 mermaid)+ §退路树(含 mermaid)· §过门判据与精确阈值 · §采集指标字段表(fail_system / driver 安全列)| 状态:建(tier2 待 0号 spike 验证)| 设计变动须同步本图 deepen 不 duplicate:两段实施与退路树承接《agentic 运行时架构图说》的 spike 判据,本图把两段 gate 铁律与退路三条数字触发线逐项放大(总览未展开);自产 driver 三层隔离详见 D4。 diff --git a/docs/architecture/架构/生成引擎/assets/t2-H-01-trace统一契约.svg b/docs/architecture/架构/生成引擎/assets/t2-H-01-trace统一契约.svg index 04754a47..930d64f9 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-H-01-trace统一契约.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-H-01-trace统一契约.svg @@ -16,12 +16,12 @@ 图 H1 · trace 统一契约(族 H) - 两条生成线的轨迹收成同一张表:一个对称的公共核心子集 + 各轨一个不对称的 JSON 扩展列;落成 contracts/trace/ 的 additive 契约,写不进去时 best-effort 不阻塞。 + 三档生成的轨迹收成同一张表:一个对称的公共核心子集 + 各轨一个不对称的 JSON 扩展列;落成 contracts/trace/ 的 additive 契约,写不进去时 best-effort 不阻塞。 整图状态 = 建:tier2 整轨待 0号 spike 验证、尚未落代码;contracts/trace/ 这一位当前还没建(随 spike 或控制面 phase-1 落地时再新立、别当现成)。 - 实线 = 现行已落(SAA 廉价线节点裁决已在跑 / contracts 契约组已存在 / D12 治理门已有件);虚线(stroke-dasharray 6 4)= tier2 专属待建机制 + contracts/trace 待立位。 + 实线 = 现行已落(便宜档 Tier0/1·LittleJS 节点裁决已在跑 / contracts 契约组已存在 / D12 治理门已有件);虚线(stroke-dasharray 6 4)= tier2 专属待建机制 + contracts/trace 待立位。 可观测 @@ -123,5 +123,5 @@ 价值:任何一次生成都能反查「它当时用的哪几条配置的哪个版本」—— 才能回答「那批游戏质量掉了,是不是上周改的那条 prompt 干的」。 - 映射:docs/architecture/架构/生成引擎/tier2实现详设.md §统一 trace 契约的实现接点 · agentic集成架构.md §观测/审计仓(运行轨迹)+§接口对称内容不对称 · (放大总览图 7)agentic运行时架构图说.md 图7 trace 契约 | 状态:建(tier2 待建 · contracts/trace additive 待立;SAA 廉价线节点裁决已落)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.7 观测与成本(运行轨迹 · 统一 trace 契约 · 接口对称内容不对称,放大总览图 7)| 状态:建(tier2 待建 · contracts/trace additive 待立;便宜档 Tier0/1·LittleJS 节点裁决已落)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-H-02-观测管道.svg b/docs/architecture/架构/生成引擎/assets/t2-H-02-观测管道.svg index de902908..3fd5a2a1 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-H-02-观测管道.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-H-02-观测管道.svg @@ -20,7 +20,7 @@ 整图状态 = 建:tier2 整轨待 0号 spike 验证、尚未落代码。Event System / TracingMiddleware / OTel / Studio 是 AgentScope 2.0.2 官方现成件(源码已核),adapter 为自建。 - 实线 = 官方现成件 / SAA 廉价线已落 / 已有件;虚线(stroke-dasharray 6 4)= tier2 专属待建机制(订阅事件流、adapter、统一 trace 契约位)。 + 实线 = 官方现成件 / 便宜档 Tier0/1·LittleJS 已落 / 已有件;虚线(stroke-dasharray 6 4)= tier2 专属待建机制(订阅事件流、adapter、统一 trace 契约位)。 @@ -139,10 +139,10 @@ 扩展段(tier2 独有):推理 · 动作 · 观察 机制 = 订阅 typed 事件流(非节点裁决埋点)。 - + SAA adapter(Java 线) - 廉价线已落 + 便宜档已落 SAA 按它自己的 16 节点裁决埋点, 走同一份契约的 adapter。 扩展段(SAA 独有):阶段 · 修复轮次 · 门裁 @@ -152,7 +152,7 @@ contracts/trace 统一表 契约位待建 - 公共核心子集(两线对称): + 公共核心子集(三档对称): traceId · step · cost · verdict · timestamp 扩展段:各写各的(JSON 扩展列) 同一张表,第 9 类 additive 契约位(尚未建) @@ -168,10 +168,10 @@ trace 契约是数据口径、不是采集机制 —— 采集两条线各按各的框架来 - 写不进去时的策略要选边:默认 best-effort 不阻塞主流程(轨迹写失败 → 计入告警、生成继续),而非阻塞生成。契约位含字段定义 · schema 版本 · 脱敏规则 · 两线 adapter 映射。 - 消灭 split-brain 的真口径 = 每条派发路诚实镜像它真有的字段、没有的绝不编造,不是强求两线字段对齐。tier2 不必埋点(订阅 Event System),SAA 按节点裁决埋点 —— 机制各异、契约一致。 + 写不进去时的策略要选边:默认 best-effort 不阻塞主流程(轨迹写失败 → 计入告警、生成继续),而非阻塞生成。契约位含字段定义 · schema 版本 · 脱敏规则 · 两轨 adapter 映射。 + 消灭 split-brain 的真口径 = 每条派发路诚实镜像它真有的字段、没有的绝不编造,不是强求两轨字段对齐。tier2 不必埋点(订阅 Event System),SAA 按节点裁决埋点 —— 机制各异、契约一致。 价值:任何一次生成都能反查「它当时用的哪几条配置的哪个版本」,才能回答「那批游戏质量掉了,是不是上周改的那条 prompt 干的」。存储复用已部署 MySQL + 对象存储,不上重型可观测中间件。 - 映射:docs/architecture/架构/生成引擎/agentic集成架构.md §观测/审计仓(Event System → TracingMiddleware → OTel → Studio)· agentic运行时架构图说.md §6 术语映射(可观测 = Event System,放大总览图 6)· 源码 agentscope/event/_event.py + middleware/_tracing/_trace.py | 状态:建(tier2 待建 · Event System / TracingMiddleware 官方现成,adapter + contracts/trace 自建)| 设计变动须同步本图 + 映射:agentic运行时架构图说.md §5.7 观测与成本(Event System → TracingMiddleware → OTel → Studio)| 状态:建(tier2 待建 · Event System / TracingMiddleware 官方现成,adapter + contracts/trace 自建)| 设计变动须同步本图 diff --git a/docs/architecture/架构/生成引擎/assets/t2-H-03-成本台账.svg b/docs/architecture/架构/生成引擎/assets/t2-H-03-成本台账.svg index c9adac98..819d9ed6 100644 --- a/docs/architecture/架构/生成引擎/assets/t2-H-03-成本台账.svg +++ b/docs/architecture/架构/生成引擎/assets/t2-H-03-成本台账.svg @@ -101,5 +101,5 @@ 一句话:成本不是估的,是从 new-api quota 权威口径折出来的 per 款¥;凭据见 docs/内网凭据与端点.md(NEWAPI_KEY / 端点 / 机器)。 - 映射:tier2/HANDOFF.md §接着做(U7 成本取证:RecordingChatModel(AnthropicChatModel) 变体)· docs/architecture/架构/生成引擎/tier2实现详设.md §采集指标字段表(cost_rmb / tokens_by_model)· 项目记忆 newapi-billing-plane-integration(quota 权威成本源 · cost.py 读 logs.quota)· 接法见 C2 底带 / 采集字段落处见 G4 | 状态:建(RecordingChatModel(Anthropic) 变体待补)/ 现(new-api quota 计费平面已落)| 设计变动须同步本图 + 映射:tier2/HANDOFF.md §接着做(U7 成本取证:RecordingChatModel(AnthropicChatModel) 变体)· docs/architecture/架构/生成引擎/agentic运行时架构图说.md §采集指标字段表(cost_rmb / tokens_by_model)· 项目记忆 newapi-billing-plane-integration(quota 权威成本源 · cost.py 读 logs.quota)· 接法见 C2 底带 / 采集字段落处见 G4 | 状态:建(RecordingChatModel(Anthropic) 变体待补)/ 现(new-api quota 计费平面已落)| 设计变动须同步本图 diff --git a/docs/mvp/可行性方案16周-波次映射.md b/docs/mvp/可行性方案16周-波次映射.md index 839689bb..0fcfed66 100644 --- a/docs/mvp/可行性方案16周-波次映射.md +++ b/docs/mvp/可行性方案16周-波次映射.md @@ -22,7 +22,7 @@ supersedes: 本文件原「可行性验证方案(16 周)↔ 工程波次映射 **两套旧路线图怎么收敛成视图**:execution-spec(10 人×3 周 / 55 P0 / ≈137 技术项)降为本 SoT 的**产品验收来源**外加一段冲刺视图;投资人版(5 人 / ¥4,300/月 / 11 周)降为**对外资本效率叙述视图**。二者都不再作为平行的执行基线,以本 SoT 的 16 周轴为准。 -> 配图待出 mini-desktop(16 周泳道甘特 + 日历闸门叠加层 + 55 P0 挂点)。 +> §0 门面概览图待补(16 周泳道甘特 + 日历闸门叠加层 + 55 P0 挂点)。 --- diff --git a/docs/plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md b/docs/plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md index 21bb8c69..7a061a63 100644 --- a/docs/plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md +++ b/docs/plans/2026-06-25-生成引擎统一执行计划-AgentScope三档-plan.md @@ -14,7 +14,7 @@ design_sot: docs/architecture/架构/生成引擎/agentic运行时架构图说.m # 生成引擎统一执行计划 — AgentScope 三档 -> 配图待出(留 mini-desktop 出图管线;本计划只到架构与工作单元层,工作单元依赖图以档内 mermaid 呈现)。 +> §0 门面概览图待补;本计划只到架构与工作单元层,工作单元依赖图以档内 mermaid 呈现。 ## Summary