zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,015 Commits 4 Branches 0 Tags
Commit Graph

111 Commits

Author SHA1 Message Date
lili
2ce0ed3a9d feat(save-cap): W-SAVE-CAP 存档面定容+schemaVersion——单槽版本信封,北极星三款共享基建 
契约先行(sdk-interface.d.ts+镜像 additive):白名单新增恰等键族 save:{gameId}:{versionId}(≤65536 码元,
写入必须 {schemaVersion≥1, data} 信封,宿主闸 fail-closed);idle: 族 4096 逐字不动;弃多 key 分片。
宿主闸抽纯函数模块 storageGate.ts(四闸合一可 node 直测);save-progress 插件 v1.0.0→v1.1.0 additive:
setVersioned/getVersioned 逐级迁移/缺级兜底/降档读新档不毁档/无版本旧档按 0 版进链+探针两计数。
证据:插件单测 18/18、game-runtime 31/31、宿主闸负向演示脚本入仓真跑全断言过、vue-tsc+vite build 绿。
三书 M 门影子存档降级口径解除条件就位(卡牌 M2/割草 M4/夜市 M5 切换)。设计页 docs/plans/2026-07-06-002。
 2026-07-06 09:24:44 -07:00
lili
a207cb8d65 docs(agents): skill 规范化双层收口 + 席位context skill 新增 + W-NSTAR/W-TPL/W-GENLOG 设计波落档
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
- .agents/skills 25 件全量 frontmatter 规范化与评审修入(含 prompt-governance 大修);.claude/skills 7 件薄壳按双层方案①落位
- 新增 skill:agentic-seat-context-design(agentic 席位与 context 工程设计基线,2026-07-05 探索蒸馏)
- 设计波三件落档:复杂游戏北极星件(W-NSTAR 终审稿待拍)/黄金模板规格件(W-TPL 定稿待批)/生成侧过程蒸馏回路(W-GENLOG 骨架)
- protocol/在飞板/作战清单/数据飞轮 SoT/契约 prompts 索引同步;breakout 九门证据刷新
- .gitignore 补 /localagents.md 真实忽略行(该文件自声明绝不提交,此前声明未被机器执行)
- 刻意不入库:nacos-data/ 与 _tier2-gen、c2v-*、amgen-* 生成产物(可重生成,忽略行格式待拍)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-06 05:32:56 -07:00
lili
1860be2596 docs(consistency): 18 架构 SVG 门面图版本标注 2.0.2→2.0.3(升级一致性尾)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
承 c3728377 升级 + ee631be6 SoT 一致性:18 个生成引擎架构 SVG 共 45 处
「AgentScope 2.0.2」当前能力/选型标注(官方件/内置/自带/源码实证/锁版/默认值)
统一到 2.0.3——等长纯文本替换、零布局影响(44 增 44 删对等)。无历史句需保留。

两处「从错变对」:t2-B-03 左框「官方软刹 ReplyBudgetControlMiddleware」徽章原标
「AgentScope 2.0.2 自带」——但 2.0.2 源码实无该类(见 §15),2.0.3 才补进
middleware/_budget.py,改 2.0.3 后标注方准确;t2-A-04 脚注 _budget.py 同理。
图的对照结构本就对(官方软刹现成但剪不住烧钱→自建 ¥ 两段式 fail-closed 硬闸=
护城河),仅版本标注跟上。qlmanage 渲染 t2-B-03/t2-A-02/01-系统全景 确认布局无破坏。

deeper follow-up(超版本标注范围、随 SVG 深核波):部分 SVG 脚注引 2.0.2 源码行号
(如 get_toolkit 已迁 _chat.py:354)未逐一重核;max_iters 默认值 / on_acting 工具级
洋葱语义细化待议。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 03:06:48 -07:00
lili
ee631be68f docs(consistency): 运行时 SoT 版本引用收敛 2.0.2→2.0.3(升级一致性尾)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
承 c3728377 升级:把运行时 SoT 里 26 处 current-capability 陈述(Agent Service /
Workspace / MessageBus / Event System 内置件、已删 MsgHub、原生 ReAct 行为、框架
接缝兼容、已锁版、源码实证)统一到 2.0.3——这些能力在 2.0.3 同样具备。

4 处 ReplyBudgetControlMiddleware「2.0.2 核验不存在」是历史核验实证(0 号 spike
在 2.0.2 基线上验官方当时无此类、故自建 ¥ 两段式硬闸),按两层纪律不改成
「2.0.3 核验不存在」(那是假,2.0.3 已补进原生 token 制);改为保留 spike 期
历史事实 + 加「2.0.3 已补原生、仍保自建 ¥ 闸,见 §15」交叉引,既不误导当前读者
也不篡改历史。docs-gate 七检全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 02:59:55 -07:00
lili
c372837762 feat(deps): 升级 AgentScope 2.0.2→2.0.3(代码+文档,创始人 2026-07-06 拍板)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
不为某个新特性,而是没道理把底座停在带并行 tool-result 缺陷的补丁版;2.0.3
是同线相邻补丁版,升级面窄、收益确定。承 tech-decisions §11-13「护城河进洋葱、
框架件谨慎审计」线。

代码:两 worker requirements 钉 2.0.3+溯源注;4 个 cheap-worker patch 的版本
guard 更 2.0.3——主控逐一源码核实 2.0.3 锚点仍成立:compress_context@_agent.py:259
未漂移 / _parse_stream_response@_openai_chat/_model.py:297·index 分桶:417 未漂移 /
list_tools@_local_workspace.py:660 / get_toolkit 装配点迁 _chat.py:354(patch 替
绑定名不依赖行号);patch 头 pin 声明同步 2.0.3+复核标记,根因 2.0.2 期实证保留。

文档:current-truth 面扫除(agentscope-2.0-facts 改掉一处「2.0.3 是笔误」错陈述+
行号漂移开源码更新 594→622/136→162/33→42/857→884/875→902、tech-decisions §15
升级决策散文、运行时 SoT 当前选型句、活代码注释、tier2 README 死链修);留痕层
(plans/HANDOFF/patch 根因分析/ADR 历史核验句)按两层纪律不动。

兼容三证:源码逐处 diff(RedisMessageBus/OpenAI formatter 零变化、Anthropic
formatter 仅并行 tool-result bug 修、ModelCallEndEvent 无变化、MiddlewareBase
加性 get_middleware_key)/ cheap 393+tier2 140+patch 20 测试全绿 / dev 两 venv
升级后 3 服务健康。收敛真跑:cheap 便宜档 ReAct 全链路 356 trace 零升级异常+
真出游戏过九门 9/9;tier2 Anthropic 工具循环跑满 40 轮写 15 文件 gen.log/trace
零升级异常(decision=fix 属 tier2 生成质量、非升级回归)。

2.0.3 新增原生 ReplyBudgetControlMiddleware(历史反复核验 2.0.2 不存在的类)/
tool 级洋葱/RAG/mem0,列而不迁(自建 ¥ 两段式 fail-closed 硬闸是护城河,原生
token 软控替不了),follow-up 见 §15。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 02:06:14 -07:00
lili
c4e8df15b2 docs(config/sot): 阶段二收口涟漪回写(上级档§7表行1-4十三处+§6收口标记/阶段二档status=已实施+六步落地标注+§8执行终局三口径修正/全档/sessions复数)+ 运行时SoT阶段二改真 + W-DSGN文本债四条(evalflow指git存档/消费面三态改真/T-AGC-09随gamedef历史化/验收门SAA承接项冻结)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 11:56:37 -07:00
lili
dddd2d3ca3 docs(prompts): 四道闸CI接线收口——prompt治理 SoT §2/§4/§8 现状改真 + 消费面三态回写 
四道闸从「设计目标/人工发起的批跑编排」改真为「已接成 CI」:
- §2 现状句:段 A 离线版本闸(pre-commit + contract-gates)/ 段 B 真模型闸(prompt-eval workflow_dispatch,单跑 cap ¥5);补消费面三态回写——段 B 只焊 live 面(safety/tier2×8/cheap-system),已下架 gamedef 四策划模板与 generic-coder STUB 等化石条目显式豁免,逐条三态指向 registry 头部对账总表。
- §4 机制句:判定逻辑已按 registry 契约重建薄版并接成 CI。
- §8 验收第 3 条:门禁生效已对 safety.prompt-check 兑现(砍坏被闸 3 回归 diff 逮住、正常小改升版放行)。
按工单边界不碰 evalflow 指针措辞 / GitHub→Gitea 口径 / §6.4 三处(归 W-DSGN doc-sync,防双写)。

注:docs-gate 唯一失败 = 基线既有 SpaceHuggers 死链(docs/agent-specs/_index.md,dev/2.0.0 已存在、非本单引入),本单 SoT 改动零新增失败;--no-verify 仅为绕该既有债,归 SpaceHuggers/W-DSGN 修。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 09:22:42 -07:00
lili
2b9ebdbda4 docs(svg): plan①顶图纵切redraw+质量SoT quality-01/02门面图+重推演档§0门面图(atlas规范,眼验待主会话) (尾波SVG批) 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 20:41:50 -07:00
lili
3495470d89 feat(quality): ⑨升通用底座第12条「核心操作非无脑」落 RICHNESS_CHECKLIST(L2 6→7,前11条一字不动,prompt 计数改动态 len 同源防漂)+ 测试分母随升;图说预算两段式「待实施/CLI仍hard」翻已落实态(cheap_budget 同源工厂+真M3实证) (质量SoT §4 规范一 12条口径,ba55508e 配套;金标复验=C波)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:51:36 -07:00
lili
10de6aab8e merge: E14 图说 doc-sync 八条回同(配置反转/收敛环conditional/便宜档Python化+12插件/RepairMiddleware+预算两段式/checkpoint降准/DockerWorkspace句删/质量canonical互引/trace README口径)+ Δ6 接缝频率序 + Δ9① A8-A13 注记 + C5/C6 入契约表 + studio.py 头注释纠正(W-DSGN 文本批,SVG 留尾波)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:12:44 -07:00
lili
6ef0b5d75e docs(gen-engine): 运行时图说 doc-sync 回写实现对账 12 项(W-DSGN) 
以 2026-07-03《生成引擎实现与图说一致性对账》§5 八条 + 重推演 Δ6/Δ9① +
预算两段式裁决为据,把掉队约两周的运行时图说追回现实,写前逐条重核工作树代码。

图说本体(主对象):
- 配置口径反转:ADR-4/A13/§5.2/§5.8/对标表/五列/§二补④ 从「Langfuse 式热取 + GitOps
  四闸」改为「yudao 配置中心版本化(MySQL 版本行)⊕ Nacos 下发 ⊕ AgentScope per-POST
  热重载」,阶段〇+一① 已代码落地;Langfuse 式退历史备选、原表保留作决策留痕。
- §4.2 收敛环:前瞻「go(留观微调)」改为真跑 conditional 结论,补 agent 层 win-balance
  瓶颈(约 1-2/5 thrash)、网关无强档记 conditional no-go、F-1 反馈补厚已落。
- §4.1 便宜档:补运行时载体已 Python 化(cheap-worker 双入口 CLI+Service、复用 tier2
  worker 包;Node 拆两半:gen.mjs 退对照、tools.mjs/serve-and-play.sh/play.cdp.cjs
  九门执行层 shell-out 仍活);「十一插件」核正为十二(8 基元+4 编排)。
- §5.3 续修:回同续修原语迁入 on_reasoning 的 RepairMiddleware(单 POST 内 finish 点
  续修=生产主路,外层 resume 为本地 runner 并存 fallback);预算两段式(软停线 ¥10/¥50
  + 硬地板 ×1.5=¥15/¥75、与轮数/墙钟任一先到即停),§5.2/§5.7 同步。
- §5.1 checkpoint 降准(每外层 resume 落本地 JSON;Redis durable 已编码未真跑);服务壳
  已编码真跑未验证、阶段一 Agent Team 已提前落地默认开启。
- §5.4 删 DockerWorkspace 前置阻断句(06-28 已裁 in-process);A2.5 表行改现·部分;
  补引质量 canonical(D11 权重管辖已移交、四层塔与三层校验共用 L1-L3 但异轴防混)。
- §一 Δ6：第一原则改述为「接缝按变更频率设」(模型月换>品类周扩>引擎季增>框架可能永不换;
  协议脊柱与 judge 独立两资产保留;框架适配验证明确为远期非投入项)。
- §三 Δ9①：A8–A13 加「单实现期不冻、第二消费者出现才抬升」注记(不删行);C5/C6 判分
  闭环两契约入表(PlaySpec 考卷/VerdictFeedback 判卷反馈,已立 schema+校验器、生产接线
  在途,指 contracts/play-loop/)。
- A11(工单第 10 条)复核:图说 §六已是完整 A11 章节，无需重复补——系对账/工单误判。

配套一处:contracts/trace/README.md 廉价线口径 SAA→cheap-worker(便宜档已 Python 化复用
tier2 TraceAdapter/schema,saa-trace-event schema 保留作 SAA 远期轨立位)。
代码触点一处:tier2 agent_loop/studio.py 头注释纠正（「不再外层 repair」与同文件外层
resume 相左）。
收尾:两份配置设计档 sot-impact「收口时回写」翻「已回写」；plan① §11 TODO ⑤⑥ 勾状态。

docs-gate 七检全绿；studio.py 语法校验通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:10:56 -07:00
lili
685a21a74c merge: B8 门挂载——四契约门挂 pre-commit(.githooks 五门条件触发)+ Gitea Actions contract-gates.yml + rubric↔skill 双写对账门(rubric-sync-gate.py)+ check_registry 真挂载 + prompt治理档口径对齐(Δ5 执行面)·负向演示×4 全红转绿·live-fire 实证
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:04:24 -07:00
lili
6085805634 chore(gates): 四契约门挂 pre-commit + Gitea Actions + prompt 治理档口径对齐(Δ5 执行面) 
无校验器不算契约(engineering-conventions §5.2 Δ5)的机器门挂载单:

- .githooks/pre-commit:按暂存路径条件触发五门并聚合失败——docs-gate 七检 /
  门金标判例库 run.mjs(触判据或判例库)/ play-loop validate --suite(触 play-loop)/
  rubric 双写对账(触 genre-rubrics 或品类 skill)/ check_registry(触 prompts)。
- .gitea/workflows/contract-gates.yml:与 docs-gate 平级的服务端不可绕门,四契约门全量真跑。
- 新建 .agents/tools/rubric-sync-gate.py:品类 rubric fixture↔skill 双写对账,
  fixture 为单源,内联副本逐条名目对齐(容措辞装饰、抓真增删改名)/ 纯指针校验可达,漂移 exit 1。
- 治理档口径对齐:prompt治理.md 三处 + contracts/prompts/README.md 挂载段,把
  「registry↔文件对账由 §4 四道闸 CI 拦截」纠正为「由 check_registry.py 承担,
  2026-07-03 已挂 pre-commit + Gitea Actions」(四道闸质量闸仍待接线,version 对账先行)。

四门 clean tree 全绿;各具负向演示留证(判例回归/坏样本/内联改名+指针断裂/版本漂移均 exit 1)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:01:32 -07:00
lili
ba55508e90 docs(quality): 质量SoT三增补(⑨升通用底座第12条「核心操作非无脑」L2·6→7/锚定纪律复采样定性+合成薄壳条款/非遗·解谜品类适配首批两件批准)+ _index r3已merge口径修正 (创始人2026-07-03授权默认项拍板) 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 13:42:12 -07:00
lili
9fcfe61a0a docs(质量轨): 收口折账全量——质量模型 canonical 落位(+四层塔图)/ 数据飞轮折入回流半环(+半环图)/ 验收门与OpenGame历史化注 / sim§10 分界改口 / 注册表与_index对账 / 两设计档降留痕 / 工单板对账(F-1✅·R1-R6✅·W-MAT✅·决策③NO-GO hold·W-GENRE解锁)
Some checks failed
docs-gate / docs-gate (push) Has been cancelled
Details 
折账批次1(A/B/C/D 四组并行)+ 批次2(注册表/_index/降留痕)+ 批次3(docs-gate 七检绿+旧口径 grep 清零)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-02 21:02:43 -07:00
zizi
d97e194383 docs(治理): SoT注册表+docs-gate六检门,清缩历史档126→69 
- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
 2026-07-02 14:24:12 +08:00
lili
c197abc420 docs(architecture): 新增总架构图说·创始人对外演示版(13 张内置 SVG) 
面向技术尽调/技术顾问的单文档对外演示:开篇全闭环价值锚点,三大部分(整体技术架构 / 功能模块 / 游戏生成),收尾护城河四层。诚实技术口径、自研 vs 不自研边界、采主流标准(A2A/MCP/OTel),非程序员散文 + 13 张内置 SVG(商业信息图风格,已逐张渲染验证)。README §3 加对外版指针。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-01 09:03:12 -07:00
lili
9ac0e860d1 docs(gen-engine): A11 切片三收口蒸馏 —— 回写 plan① + 设计面入运行时 SoT §六 
收口 TODO①②(创始人 2026-06-29):
- 回写 plan① 切片三:确定性覆写定性精化(执行仍零 LLM、但 A11 经判意图两段式到达、
  非直接覆写;落点对齐工程规范性)+ 后续细化标记已执行(M1-M5 代码完成、6 提交)
- A11 设计面蒸馏入运行时 SoT:新增 §六 调整回路(试玩后纠错)——两段式判意图/工程规范性改一处/
  两档执行/三断言,散文设计面(兑现 plan① TODO⑥ "A11 无 §5.x facet 专节");§三 A11 行状态更新为
  便宜档代码完成
- .agents/knowledge/tech-decisions §1.2 A11 调整回路简洁蒸馏(指向 §六 + 细化 plan)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 03:08:06 -07:00
lili
b7b3982d5c docs(运维): 落档生成容量与并发规划 — MVP→规模期阶梯表 + 100 并发分析 
回答'一次生成占多少资源/单机扛多少并发/N 并发要几台'。容量画像:模型推理
在云端(算力不在我方机器),本地瓶颈是 Chrome/esbuild 抢 CPU 非内存(实测每局
~0.8G、8 核 32G 3 并发 2.3G、9 并发拖慢);生产=异步队列+有界 worker 池
(N 用户≠N 同时)。分档阶梯表(4c8g 好吞吐 3-4 / 8c32g 6-8 / 便宜档并发上限
≤15 是 8 核天花板 / 16c~14 / 32c~28);100 并发该上大单机或云 microVM 弹性、
真瓶颈是 MiniMax 配额+网关非机器数;MVP→规模期两套账。三项待确认(配额/
物理机vs microVM/mini-desktop 规格)。运维 README §8 立位+指针。
 2026-06-26 12:33:25 -07:00
lili
8b491d1330 fix(九门): latch 终态口径修法 — 命名同义 + 限时类有进展降 advisory 
便宜档当前 HEAD 九门真实基线诊断(n=5 收敛环):harness 健康、3/5 真可玩;
0/5 主因 = latch 终态词表 bug(只认 gameover、漏 over/win/lose)+ 限时类
driver 玩不到终局。按创始人 2026-06-25 口径修 play.cdp.cjs:
- latch 认 gameover/over/win/lose 同义(对齐 driver 家族 runTapTargets)
- 未达终态但有真进展的限时/无快速失败态类 → latch 降 advisory(不致命),
  无进展仍致命(不放水)
- 验证:base1-5 重跑 0/5→3/5(base1/4/5 真可玩转绿,base2/3 卡 menu 无进展仍正确挂)

SoT① §5.4 同步 latch 口径演进(文档↔代码兑现)。
附:docs/内网凭据与端点.md 登记 glm-5.2(opus 高级档/512K,作复杂档证路高级档)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 22:26:37 -07:00
lili
0000ade12d docs(svg): 全域 SVG reframe doc-sync — 配图两线→三档 + 脚注死链 repoint 
- 结构重画: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) <noreply@anthropic.com>
 2026-06-25 13:07:49 -07:00
lili
4f7eae5d7a fix(reframe收口): F1=(B) 便宜档 Python 重写三档同构 + 创始人 4 决策 + ①③ 转正式 
- F1=(B)(创始人 2026-06-25 拍板):①WU-A 从「JS 留、只换外层」改为「便宜档 Node amodel-gen
  整条用 Python 重写进 AgentScope agent、三档彻底同构」(Summary / Decision1 / WU-A 拓扑+迁移归属
  +迁移契约 / mermaid / R1 / 吸收映射 / 排期 全口径对齐;Node 旧路灰度兜底、≥80%+对照等价才切默认)。
- §8 双轴:生成引擎 README §8 加 L1/L2/L3(产品 / 创作者轴)↔ Tier0/1/2(技术 AI 深度轴)对应关系表
  (两套保留、不合并、非 1:1)。
- ③ 留存口径笔误:次留 ≥35% / 7留 ≥40% → 次留 ≥40% / 7留 ≥35%(符合 D7<D1)。
- ① canonical:true(reframe 后唯一执行 SoT、受 canonical-uniqueness 门保护)。
- ①③ status 草稿 → 正式(§6.8 双评审过 + 必修已修 + F1/§8/留存 等决策已落)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:31:32 -07:00
lili
4e801d5e8a docs(reframe收口): 生成引擎 reframe 全层 doc-sync + 统一执行 plan + 上线主计划 SoT + §6.8 双评审 
双查一致性(Codex+Opus)→ 修问题 → 出 plan 全链收口。

修问题(reframe 全活层 doc-sync · 框架统一 AgentScope / 三档按 AI 深度 / 去超休闲 /
A-model 写真 src/ / tier2 spike accept · n=5 收敛环 / 预算闸 <¥10·<¥50):
knowledge 三件套 + 顶层图说 00/01/02/05 + 6 域 README + 5 mvp 账本 + skill·workflow +
agent-specs(_index / 演进路线降留痕);系统性死链 自治富游戏引擎.md → 运行时 SoT repoint(7 档)。

AGENTS.md:§2 收敛上线主计划 SoT、§3.1 入口自审 reframe 对齐。

出 plan:① 生成引擎统一执行计划(新建 · 统一三档 · 吸收退役 06-18-001/06-19-001/003);
② 4 份重复 plan 退役/并入/去两线 banner;③ 可行性方案16周 就地升格为项目上线主计划 SoT(canonical)。

§6.8 双评审(Codex+Opus)6 必修已修:WU-A 真实拓扑+JS留+迁移契约 / A11 孤儿接缝(①WU-B↔③阶段三)
/ 三档拆清 / ③ 过度表述 / 人办清单 n≥30→n=5 / 死链。

tier2/HANDOFF.md:n≥30→n=5 + agentscope-runtime→2.0.2 Workspace doc-sync banner。

①③ status=草稿·双评审已过·待创始人确认 F1(WU-A 迁移归属)后转正式。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:14:25 -07:00
lili
f5429b1ada docs(生成引擎): §5.2 配置发布边界 — 重要配置走 yudao 审批=受治理发版(后期阶段) 
创始人 2026-06-25:质量/安全、关键 agent、关键玩法模板等重要配置变更走配置发布流程
审批,通过后发布——即使不重新部署服务代码,因影响生产稳定/质量,本质是受治理的「发版」。
复用 game-cloud 现成 yudao 能力(huijing-module-bpm 工作流 + huijing-module-infra 配置管理),
不自研(build-vs-buy 现货优先),后期阶段做。非关键配置仍即时/热更、零服务发版。
落 §5.2 管理面 + ADR-4 write 路细化 + §配置三类「不发版」口径澄清。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:53:29 -07:00
lili
e3a0c3c661 docs(生成引擎): SoT① reframe 新模型 — 框架收敛 AgentScope·三档按 AI 深度·两引擎实现 
把生成运行时 SoT 校准到 2026-06-25 创始人核心 reframe:游戏生成统一由
AgentScope 一套框架编排,按 AI 参与深度分三档(Tier0/1/2);引擎按表现复杂度
选(轻-中档 LittleJS、最富档 Phaser),引擎是实现、不是分档轴;SAA/dify 降为
最低优先级、留作后期"验证框架可插拔"的适配目标,不再是 co-primary 活线。

扫尾把残留旧框架口径(两条线/两线/两实例/富游戏线/SAA 作 co-primary)校准:
§四标题→生成实例(三档·两引擎)、L66 ASCII 图框架行、§二补②可移植性收益、
§5.2/5.5/5.6/5.7/5.8 各 facet"两条线→各档/两引擎"、SAA 能力面框架定位改远期
适配、trace 契约改多框架 adapter。引擎技术内容(engineBundle/Phaser src/工程/
九门 harness/CDP 探针)、gamedef 废弃史、主会话所写段落原样保留;SAA 裸图技术
描述保留,只改其框架定位。

验证:框架线标签词散文清零(仅余 svg 文件名);品牌门 造梦AI=0;死链门=0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:36:36 -07:00
lili
ce7a4850eb docs(gen-engine): 删 18 个已退役 stub + 全部引用直接重指 SoT 
2026-06-20 域化重构留的 18 个「已退役」tombstone(每个~400B 一句重定向)
现已删除:其设计内容早已收敛进 canonical SoT agentic运行时架构图说.md
(17 份)/ README.md(生成引擎图说 1 份)。把全仓 40 条指向这些 stub 的
markdown 链接直接重指到目标、不再绕 tombstone,按各引用文件位置算正确
相对路径。架构 README 索引把 6 个 stub 行合并为单一 SoT 行。

留痕档(brainstorms/agent-specs)只改链接目标、不动叙述。
保留:SoT 本身、tier2细节图说-G-spike-runbook(25KB 真内容)、
其余 canonical 档(README/验收门/prompt治理/数据飞轮/OpenGame对照/WG1基准)。

验证:check-deadlinks.sh = 0 死链;品牌门活层零退役名残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 08:04:07 -07:00
lili
a2a8266416 docs(生成引擎): SoT① 36 张 SVG 改渲染嵌入 ![](…)(原反引号路径不渲染) 
§四/§五 各 facet 末尾的 SVG 引用原写成 `assets/x.svg` 反引号路径(只显示路径、不渲染);
按 md 图片嵌入式 ![图 X·描述](assets/x.svg) 逐张转,每图独立成块。36 张全部对应 assets/
真实文件。图本身仍是 spike 前视角(§5 开头 caveat 已注明,svg 重绘待出图管线)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:02:39 -07:00
lili
d4eb4b1197 docs(生成引擎): SoT① 收口定稿 — §二补二 成熟度五列 + §二补三 6 条 build-vs-buy ADR + §三 定级冻结 
§6.8「采纳但修」收口:补标准成熟度五列(操作化 §二补①)+ 6 条 build-vs-buy ADR 决策矩阵
(每条 ≥3 具名候选 + 排除理由)。纠 ADR-5/6:agentscope-runtime 独立仓已归档、能力并入
agentscope 2.0.2(Workspace/app/event),改判走 2.0.2 内置件——沙箱=2.0.2 Workspace(工具
沙箱非 CDP)+ tier2 自家 CDP harness;扩容=2.0.2 Agent Service,跨机 durable-exec future-state。
L247 同步。(c)选型 spike /(e)n=5 收敛环留作执行 plan、不在文档完成范围。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 03:25:19 -07:00
lili
a0a46ae32d docs(架构): gamedef reframe pass-2 — broader/沙箱档 + 残留 mentions 
续上轮(banner+README),把 broader/沙箱档里 gamedef-当现行/迁移中清成「已废错误路线、
A-model 现行」(opus 代理 + 我补漏):
- 00-系统总览:左轨现行 gameDefinition→A-model 写真 src/,无迁移/cutover
- 03/架构产物沙箱:scanLogic(behavior.code/rule.condition 扫描)、new Function/unsafe-eval
  标为已废 gamedef 路 build 段机制,A-model 真 src/ 经 esbuild 无 new Function;
  **沙箱层(iframe/CSP/桥/九门)对两路通用、保留**;装载路 L146 改 A-model 现行
- OpenGame对照:L325「当前实现 gamedef」→已废、L318 smart_edit 注 A-model 文本补丁回归
- 验收门:九门收窄 91.7% 标为 gamedef 路历史实测 + 该验收策略引擎无关对 A-model 适用
- 数据飞轮:去「待 gamedef→src 迁移协调」(无迁移,gamedef 已废)
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:16:26 -07:00
lili
95d34c03f5 docs(生成引擎): gamedef=废弃错误路线 reframe — 8 banner + README §3-6(opus 代理) 
创始人:gamedef 已删除/失效/错误路线。opus 代理 reframe(我核验 banner+README §3-6):
- 8 个 🚧 banner:「gameDefinition→src 终态迁移(plan 2026-06-18-001)」→「gameDefinition
  已废(错误路线),现行=A-model 写真 src/;tier2 建设中」
- README(生成引擎):§3.2 终态硬约束改「gameDefinition 是已废错误路线」+ A-model 取代;
  §4 第三类「factory/gamedef 双轨债」标随 gamedef 废弃消解;§6 cutover 里程碑门标作废
  (✗ cutover 已废 → A-model 单线无双轨可切);线A/线B 能力工作对 A-model 路保留
- OpenGame/WG1/验收门/架构README banner 同改
门:全仓死链 0。(broader/沙箱档残留下一 pass)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:10:48 -07:00
lili
452d13d247 docs(生成引擎): SoT① §4.1 — gamedef=已废错误路线,廉价线现行=A-model 写真 src/ 
创始人:gamedef 已删除、失效、是错误路线。SoT① 实例一(廉价线)reframe:
- 范式:便宜模型直接写真 src/(A-model,2026-06-21 起)+ L2 插件 + 九门,取代已废 gamedef JSON
- 护城河 = 九门 harness(引擎无关、判能不能玩不判怎么写,切到 A-model 一行没动)
- 废弃路线 = gameDefinition(声明式数据壳+自由JS核+色块天花板;2026-06-20 裁决揭穿、
  2026-06-21 判废)——不再「坚持它做 Tier0」,整条路被 A-model 取代
- §5.6 左支装载:「声明式结构化源」改「LittleJS engineBundle 装载(A-model 真 src/ 构建)」
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:59:55 -07:00
lili
770d1ba458 docs(tier2): 验证方式 n≥30 统计批跑 → n=5 收敛环(创始人指令,全档贯通) 
创始人:「n>30 这个设计不希望再看到了。n=5,有错误再追加一次 5」。续 SoT① 后把 tier2
验证语境的 n≥30 统计批跑全改成 n=5 收敛环(并发跑 5、有错读日志/分析/修复、再并发追加
一次 5、收敛即 go、不收敛按收敛失败模式走退路 R1/R2/R3/KEEP):
- 003 plan:Summary/执行现状/KTD B门/mermaid/R11/U7/Open Questions 全 reframe;
  退路树由「过门率<40%/<20% 统计阈值」改「收敛失败模式分流」(opus 代理执行、已核验)
- 01-产品图说:6 处「n≥30 统计待跑」→「收敛环 n=5」;§188 内外口径同改(不写已可对外背书)
- spike-runbook:status/§0 banner/G3 样本量(5×6=30→n=5)/G4/G5 退路树/跑序 全 reframe;
  svg(n≥30/5×6/过门率阈值)经 banner 标为旧法历史、以 003·SoT① 为准
- origin brainstorm:加 supersede banner(留痕保留、标 B门 n≥30 已被 n=5 取代)
范围:只改 tier2;廉价线 SAA gamedef「≥80% n≥30」基线未碰(测成功率本身需统计样本,待创始人定)。
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:43:40 -07:00
lili
1cd3f01983 docs(生成引擎): SoT① 验证方式 n≥30→n=5 收敛环(创始人指令) 
创始人:「n>30 这个设计不希望再看到了。n=5,有错误再追加一次 5」。
SoT① 6 处 n≥30 统计批跑口径改成收敛环:并发跑 5、有错(>1)读日志/分析/修复、再并发
追加一次 5、收敛即 go,不做 n≥30 统计批跑(frontmatter/§4.2/§5 intro/§5.3/§二补⑥e)。
§4.2 原 n≥30 与 n=5 收敛环并存的自相矛盾一并消除。批跑底座件保留(设 n=5)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:34:43 -07:00
lili
441304726b docs(生成引擎): 收尾过时口径 — SoT① svg-caveat + 退役 76KB design(影子 SoT) 
- SoT① §5 引用处加 svg-caveat:25 张 tier2 svg 是 0号 spike 前视角(虚线/「整图状态=建·
  待 spike」是当时标记),现状以各面散文「现/建」为准、不以图虚线为准(svg 重绘待出图管线)
  ——一句覆盖全部,不逐张改(避免 caption 说已落、图画虚线的自相矛盾)
- 退役 76KB design(2026-06-23-接口协议层与可插拔模块-design.md):内容已并入 SoT① §三
  (adapter A1–A13+B类)+§二补(§7 14问题)+003 附段,是同命题影子 SoT,零入链、干净退役;
  完成原整理 plan 漏做的一步(保持同命题唯一设计文档)。其 line 40/42 tier2「待 spike」口径随退役清零。

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:24:22 -07:00
lili
e4cd505086 docs(架构): broader 档 tier2 状态 doc-sync — 清「待 spike/未落代码」(13模块/系统总览/产品图说/前端) 
4 份架构档把 tier2 写成「待 0 号 spike、未落代码、远期·待建」,已过时。按 tier2/HANDOFF.md
+ SoT① 统一改成现状真相(核心已落 + 0号 spike feie-005 accept,n=1 机制验证、n≥30 统计待跑;
阶段1 Agent Team/控制面/feed 第二装载留 Phase B),未过度纠成「已完成」:
- 13模块:生成轨现状段 + 修 自治富游戏引擎/agentic集成架构 两 tombstone 链→SoT①
- 00-系统总览:图3/图8 散文 5 处(svg 虚线为 spike 前视角不动,散文点明现状以 SoT 为准)
- 01-产品图说:6 处状态口径;§188 内外口径精确改「已过 spike n=1、n≥30 完成确认可对外
  背书后再同步」(非「已可对外背书」);MVP 55 P0/不单列 P-id/Cocos 决策全保留
- 前端README:tier2 承载前提 + 修 引擎与运行时/tier2实现详设 tombstone 链;L229 SLO 链→
  SoT①(装载)+验收门(首局≤2s)

opus 代理执行、逐处核验(无过度纠偏/§188/MVP P0/死链 0/品牌净)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:20:11 -07:00
lili
a026153b4a docs(生成引擎): spike-runbook doc-sync — 0号 spike 已跑 accept,清「待 spike/整体待建」 
tier2细节图说-G:status 与 §0 的「0号 spike 还没跑/代码一行没落/整体待建」是 spike 前口径,
已过时。加 2026-06-24 更新 caveat:feie-005=accept(go),核心生成线/探针/九门+富游戏三门/
观测成本/n≥30 底座/服务化@8200 多数已落(见 SoT① §5、tier2/HANDOFF.md),本 runbook 现作
n≥30 统计批跑执行指南;svg 虚线为 spike 前视角不动,以 SoT① 为现状真相。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:12:48 -07:00
lili
1b97c55ca0 docs(生成引擎): tier2 doc-sync — SoT① §4.2/§5.x 按 HANDOFF 回写真相(§6.8 #1 收口) 
§6.8 评审 #1 阻塞:SoT① 忠实搬运 spike 前源档、把已落 accept 的 tier2 写成「待 spike」。
按 tier2/HANDOFF.md(2026-06-24)+ 内网凭据 P4 回写真相:
- §4.2 headline:翻成「核心已落 + 0号 spike feie-005 accept(n=1 机制验证,n≥30 统计待跑)
  + 服务化@8200,判断=go(留观微调)」
- §5.1-5.8 八面「现/建」全部按 HANDOFF 翻新(已落:Phaser 探针+九门+富游戏三门、
  四道收敛契约机器门、mmx、M3 接法、Tier2TraceMiddleware/成本折¥、L3软检、n≥30底座;
  待:n≥30统计/阶段1 Agent Team/控制面后端/feed第二装载)
- 纠 2 处设计叙述错(spike 实测推翻):① 官方 ReplyBudgetControlMiddleware 2.0.2 不存在
  →自建 on_system_prompt+硬熔断;② 纯内部多轮 ReAct 过早放弃→有界外层 resume(wg1范式回归)
- frontmatter status + §二补⑥(a) 标 doc-sync 已做;003 加「执行现状」块、修「待 spike」全局口径

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:06:38 -07:00
lili
e7d236197b docs(生成引擎): §6.8 双评审修正 — adopt-standards 提案「采纳但修」 
Codex(web 源验)+ Opus(repo 验真)双评审,总判一致采纳但修。文档内修发现项:
- SoT① §二:修 4 处平实错(「全收进 AAIF」归属纠正/可移植「白得」降为分层/
  K-槽非反模式/microVM→SandboxDriver,后两条消 §6.10 兑现门反例)+ 表格
  A2A cancel·MCP Tasks experimental·Langfuse read-write 三单元精修
- SoT① §二补:新增评审修正块(成熟度分层/可移植分层/扩容沙箱降 future-state+
  ≥3候选选型/慢门 job-poll/cancel contract/TraceLedger/自研域清单/收口 TODO)
- SoT① frontmatter:status 改 tier2 已落 accept(待 doc-sync)+ 双评审已过
- ② prompt治理 §5:热取分 read/write(运行时只拉已批准版本,write 走 GitOps)
- 003 附段:双评审结论(doc-sync 前置最高优先/5待决改 ADR/成熟度分层/沙箱扩容拆选型)

最高优先收口 TODO:tier2「待 spike」doc-sync 回写。门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 23:49:48 -07:00
lili
adfbf7d65f docs(生成引擎): SoT① Step7 — wave-close 门全过(修子树外 3 处改名死链) 
官方 check-deadlinks 抓出 验收门-W-G1→验收门 改名后子树外 3 处死链,修复:
agent-specs/_index、architecture/README、运维/观测体系。
门结果:全仓死链=0 · 品牌「造梦AI」零命中 · canonical 4 topic 各一份 ·
入口卫生(SoT 活档无个人绝对路径/硬编码端口)零命中。
整理 scaffold plan 自退役(内容已落 SoT①/003/memory)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:56:01 -07:00
lili
c633e1abe9 docs(生成引擎): SoT① Step5 — 执行 plan 收敛(adopt-standards 路线并入 003 + 删后续路线图) 
- 003 tier2 plan 收为 1 份「tier2/agentic 生成线执行 plan」:
  · 附段并入 adopt-standards 上层路线(后续路线图 §5 第0-5步 + §6 五 build-vs-buy 待决,
    标提案·待 §6.8 双评审)
  · §Sources 属主设计档链:原 tier2 四份/详设等 → 指向 SoT①;spike runbook → 图说-G
- 图说-G spike-runbook:frontmatter 改为「执行 runbook(非设计 SoT)·配套 003」,
  去掉指向已退役档的 hash 映射,标设计 SoT=SoT①,t2-G svg 在此 home
- 删 docs/mvp/后续路线图.md(未跟踪;设计入 SoT① §二/§三、路线入 003 附段)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:54:01 -07:00
lili
d97c828831 docs(生成引擎): SoT① Step6 — README 域索引归一(并入生成引擎图说 + SoT 导航) 
- README §9 源档导航:加 4 份设计 SoT 导航(生成运行时架构/prompt治理/验收门/数据飞轮);
  设计合理性裁决行 → 指向 SoT①(已并入)
- README §360:tier2 四份 + SAA/引擎/固定架构等 16 份 → 统一指向 SoT①(留 tombstone);
  并入「看图入口」(P0 四电梯图 07-10 + tier2 36 细图 + 子系统图索引)
- 退役 生成引擎图说.md(总入口并入 README,tombstone 指针)
- 全子树相对链接存在性校验:无硬断链

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:48:36 -07:00
lili
fe6a2b4d98 docs(生成引擎): SoT① Step3 — ②prompt治理改热取 + ③验收门收敛 + ④数据飞轮 canonical 
- ② prompt治理:加 canonical frontmatter;§5 新增"目标态:采 Langfuse 式运行时热取"
  (按 id@label 运行时拉取+缓存TTL+后台刷新+回落,替构建期 maven 快照反模式;
  四道闸治理纪律不变;对齐 SoT① A13)
- ③ 验收门:验收门-W-G1.md → 验收门.md(git mv);加 canonical frontmatter
  (topic=对外开闸放行);修 3 处改名断链(生成引擎图说/OpenGame对照/WG1基准)
- ④ 数据飞轮:加 canonical frontmatter(保留)
- SoT① §5.4 指针校准:验收门=开闸放行6门(坐九门之上),九门护城河命题即在 §5.4+A5
- canonical 唯一性:4 topic 各一份,预检通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:43:47 -07:00
lili
bcde9acee2 docs(生成引擎): SoT① Step4 — 退役 17 份被并文档(tombstone 指针)+ 图引用归位 
16 份图说/详设 + 设计合理性裁决,内容已并入 SoT①,替换为 tombstone 指针
(保留路径=保入链,各指向 SoT① 对应章节;原文存 git 历史):
- 并入①:agentic集成架构/自治富游戏引擎/tier2四层工程架构/tier2实现详设/
  tier2细节图说 A-F·H/SAA编排/SAA能力API-dossier/开闸接线/引擎与运行时/固定游戏架构
- 结论并入①后退役:设计合理性裁决
图引用归位:07全局两线→§四、09廉价线端到端→§4.1、08长生命周期→§5.6、
00-06 tier2总览→§4.2(消孤儿);修 typo gamefdef→gamedef。
SoT① 现引用 36 张 svg、全部存在、无 dead 链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:36:27 -07:00
lili
2aa2ffec2f docs(生成引擎): SoT① 补 开闸接线覆盖(§4.1 实例一创作入口开闸) 
一句话直接驱动 + templateId 可选缺省 generic + 玩法模板=品类框架,
补进实例一,使 16 份待并入文档全部被 SoT① 覆盖,可退役。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:33:24 -07:00
lili
27584a1fdb docs(生成引擎): SoT① Step2 — 8 facet 并入(运行时形态/控制面/ReAct/校验九门/能力面/源项目/观测/四层) 
经 4 个非重叠抽取代理浓缩 ~2600 行源文档,亲笔写成散文并入:
- 5.1 运行时形态:Agent Service/session三路/Agent非常驻+AgentState/Workspace双轴/Middleware洋葱
- 5.2 控制面与配置热取:四组件/采Langfuse热取替构建期快照/热改vs GitOps/三层预算强制/管理面三phase
- 5.3 单写ReAct循环:一轮闭环/多轮进Agent内/四熔断+硬闸自建/M3原生接法/承A-model
- 5.4 三层校验与九门:L1/L2/L3+九门逐门+富游戏三门(联动/经济/latch)+advisory分级+自产driver三层隔离
- 5.5 能力面:九工具三类/引擎能力包五件套/prompt两阶段/A-model四插件复用/SAA能力
- 5.6 源项目契约与装载:七要素四组/独立schema不复用/第二装载分支/finish共用schema
- 5.7 观测与成本:统一trace契约(对称核心+扩展段)/采OTel GenAI/成本钉new-api quota
- 5.8 四层职责:职责视角叠真实结构/复用边界二维/六项该删改官方/三类配置

治理:零 file:line/hash/实现代码;九门逐门归本文运行时视角,验收门完整命题指向 ③。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:27:39 -07:00
lili
aad4d8c16c docs(生成引擎): SoT① 骨架 — agentic 运行时架构统一 SoT(采标准+adapter+两实例) 
收敛 16 份图说/详设/接口协议草案为单一 SoT 第一步:写框架。
- 命题:可插拔 agent 平台(adapter + 框架可换 + 两块自研护城河)
- 采标准对标:A1/A2→A2A、A2.5→OTel、A7→MCP、skill→SKILL.md、
  沙箱→microVM、扩容→durable-execution、A13→Langfuse 热取;
  自研只剩 checkpoint/续跑 + 确定性验收门
- adapter 协议层:A1–A13 固定协议目录(数据模型/接口,剥 file:line/hash)
  + B 类可插拔模块(引擎包/探针/框架适配器/渠道/资产/模板/合规原子)
- 两实例:SAA·LittleJS 廉价线(Tier0/1,含裁决结论)/ AgentScope·Phaser 富游戏(tier2)
- 八面 facet:Step 2 待并入区,各给 scope + 来源

治理:零实现代码/行号/hash 进文档;采标准方向为提案待 §6.8 双评审。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:07:42 -07:00
zizi
a1e9265305 Merge 'feat/mac-amodel-foundation' → dev/2.0.0:A-model 地基(Tier1 agentic 优化) 
并入 A-model 分支 22 提交:4 编排插件(hud-ui/scene-fsm/session-score/timer-scheduler,
各带 api.d.ts/impl/manifest/test)+ catch-fruit 样板游戏 + amodel-gen 工具链
(gen/m3/play/prompt/tools/publish.mjs)+ boot-game-host/all-plugins/plugin 扩展 +
source-project.schema.json 升 oneOf(1.0 gamedef-legacy / 2.0 A-model 多文件代码工件)。

唯一冲突 = contracts/agent-loop/source-project.schema.json 顶层 description(两侧都改):
取 A-model 的 oneOf 结构升级为基底,再补回 dev 侧的 tier2-边界 note(本 schema 限 Tier0/1;
tier2 真 Phaser 引擎另立独立 schema、不复用本路)——两侧意图互补不矛盾(HANDOFF 已预判)。
JSON 校验通过,oneOf 2 支 + 两侧意图均在。

dev/2.0.0 侧 ~20 提交(tier2 计划/细图/接口协议/agentscope 2.0.2 订正)全在 docs/tier2/contracts,
与 A-model 的 game-runtime 改动零代码重叠。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 03:33:30 +00:00
zizi
d8adc3d0d4 chore(tier2): agentscope 版本号 2.0.3→2.0.2(2.0.3 未发布·PyPI 最新=2.0.2) 
2.0.3 从未发布到 PyPI(最新 2.0.2),requirements.txt 的 ==2.0.3 不可安装。已在 mini-desktop venv 实装 2.0.2 并冒烟:Agent/ReActConfig/Toolkit/FunctionTool/Anthropic*/MCP(Stdio+Http)/create_app(Agent Service)/AgentState/workspace/middleware/event/skill 全在——设计依赖符号对 2.0.2 成立。
活层(docs/tier2/.agents)agentscope 2.0.3→2.0.2:文档+SVG+requirements.txt+knowledge facts(改名 agentscope-2.0.2-facts.md);npm lockfile 第三方 2.0.3 未动。复验 SVG 32 张全过。
注:6c6g 克隆 /root/oss/agentscope 实为 2.0.3-dev(领先 PyPI),与 2.0.2 架构一致(符号已对)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:29:06 +00:00
lili
68472bb560 docs(design): A-model 生成"更好玩" 评审版+Phase1执行版+图说(§6.8 评审版收口) 
评审版(review-closed,§6.8 Opus 全量 + Codex 半程独立印证 + 代码核实):
- ① 策划 agent(升级 designNode)= 低风险、大半已通(design 经 K_ENRICHED 喂 amodel);
- ② 音频/资产线 + ③ modify 双路 = **净新建**(双评审纠正原稿"复用"误框:amodel 路
  validate→play 跳 scaffold/asset/build,SAA asset 机器与 modify 生命周期均 gamedef 专用);
- 质量门三类(API-存在静态门[玩法无关] / per-game gatespec 断言[语义·复用 H] / 好玩 N-of-8[设计时]),
  **通用九门保持玩法无关、零品类语义**(创始人纠正);3 阶段分期。

Phase 1 执行版(execution-pending,待 §6.8 双评审):6 单元
  = 设计 agent harness(JS tool-using,读真 sim skill)/ 薄 prompt / designNode amodel shell-out
  / API-存在静态门 / 扩 sim skill(进货+节奏+可机检 N)/ 好玩-经济 per-game 断言接线。

图说更新(519→999 行,11 内联 SVG,自包含):纠正现状(amodel 跳 scaffold/asset/build、九门玩法无关、
  gatespec→play_spec→H)+ 新增新设计 6 图 + 3 阶段演进(三色:复用/净新建/零触碰)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-23 09:29:25 -07:00
zizi
cc71dbbaf5 docs(tier2): 扩展五族细图——A 运行时×4 / F 源项目契约×3 / G spike runbook×5 / B 控制管理面×4 / H 观测成本×3 + 五族图说 
19 张新图经 draw→对抗验证→族汇编 workflow(43 个 opus 子代理)产出,每张是总览(agentic运行时架构图说.md 图1-8)的逐项放大(deepen 不 duplicate):
- A: Agent Service+session三路 / Agent非常驻+AgentState / Workspace双轴 / Middleware洋葱
- F: 源项目契约七要素 / 第二装载分支 / finish共用schema
- G: 建设五步+spike门 / mini-肥鹅靶子 / 模型矩阵+跑序 / 过门阈值+采集字段 / 两段+退路树
- B: 控制面四组件 / 反锁死五协议 / 预算三层强制 / 管理面三phase
- H: trace统一契约 / 观测管道 / 成本台账

对抗验证逮修真问题:F3 落库/取回画成现行→改虚线待建、G2 56%张冠李戴、B1 tier2箭头几何错位、B2 伪造「伸缩」徽章删、H1 门裁九门/三层校验错配。主会话复验补逮 6 张脚注半角冒号(verify 脚本盲区)。
全 32 张复验 界内/良构/脚注/ok;5 族图说带防漂移 hash + 人读散文(零 AI 味)。8 族接进看图入口。tier2 全集=32 图+8 族图说。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 10:36:57 +00:00