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