21b5320f3f
知识件(喂 agent 学怎么生成的设计范式:skills/黄金脚手架/few-shot/tier2 RAG)原散在 worker repo 检出、 read_file 按硬编码路径自取,改一条范式得重部署。本切片(K1 路乙 MinIO,创始人拍)外置成可热换知识包: - kb_store.py:KnowledgePackageStore(LocalFs/Backend)存 MinIO + manifest 落 MySQL(专用表 cheap_knowledge_package_version + 专用桶 cheap-kb,与 ASSET-SRC 正交不合表);复用 store.py 纯工具 (_canonical_content_hash/derive_version_id/_is_safe_rel_path,store.py 零改动)+ manifest-first 半落库 (pending→put→committed、fetch 只返 committed、缺源标 missingContent 不静默)。 - materialize_active:按激活版取回→staging 逐文件 sha256 校验(K2 寻址断言)→原子换入知识根(旧挪 .prev); 缺文件/取不到/指纹不匹配【显式失败】(类比 ASSET-SRC 缺源),kb_root 不动=回落上一份完整包。落点 TIER2_KB_ROOT 在 git 检出之外(deploy-safe,防 reset --hard 抹)。 - cheap_run.py read_file shadow:先查知识根同相对路径(热换即生效)、回落仓根(api.d.ts 等代码不外置); TIER2_KB_ROOT 未配时短路、read_file 字节不变(默认关);两根守只读+200KB+路径不逃逸、越界即拒。 cheap_roles.py 硬编码路径不改(shadow 在解析层处理)。 K3(yudao 治理+激活推送+admin)= 后续切片,留接缝点(resolve_active_version/materialize_active/default_kb_store)。 主控终审:store.py 零改动 + read_file 默认关字节不变 + 缺文件显式失败/原子回落读码坐实 + 独立表桶 + 亲跑 test_kb_externalize 14 + read_file 回归 18 全绿。真 MinIO 物化闭环排窗口(cheap venv 无 pymysql/minio)。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tier2 · 富游戏自治生成线
这是绘境 AI 的第二条游戏生成线。它和现有的超休闲廉价线（wg1/ + LittleJS）解耦并存、运行期零耦合：廉价线用便宜模型往声明式数据壳里填空、做单局几何色块小游戏；tier2 则给一个 AI agent 一台完整的游戏工作站——读文档、写多个 Phaser 源文件、构建、在真浏览器里真玩验收、看截图、查资产——让它在一圈确定性验收门的笼子里反复迭代，把现有产线做不出的多系统富游戏（合成、经营、挂机这类肥鹅美食街档）逼出来。
底座是 AgentScope 2.0.2（独立锁版、独立 env），引擎选 Phaser/Pixi（过无头硬筛、按 AI 作者视角取生态厚度）。生成范式是约束自治（O2）：把一款游戏拆成数据表、系统骨架、表现层三层，用骨架和插件 API 锁住系统层最难的部分，把便宜模型的火力集中到必须写的约 56% 表现层，再用三层校验和四道熔断把自治关在笼子里。
整条线最深、也最没证过的赌注是：便宜或中等模型的自治 agent 能不能稳定写出那 56% 的表现层。所以建设按「顺序软、判据硬」走——先把集成和环境搭扎实，再用 M3（写代码逻辑）+ mmx（产美术音乐）连续迭代；但生成证据的判据保持离散可判定：M3 证路是软门、便宜档 n≥30 是硬门、退路树沿用数字触发线，只有硬门通过才投入重机器。
怎么读
- 要建什么、为什么：
docs/brainstorms/2026-06-22-tier2-整体实现方案-requirements.md（WHAT，已过双评审）。 - 怎么建（照这个动手）：
docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md（HOW，10 单元，Phase A 详 / Phase B 纲要）。 - 接手须知：
HANDOFF.md（本次 6c6g 初始化交付了什么、Mac 接着做什么、环境切分）。 - 模块边界与红线：
.agent。 - AgentScope 2.0.2 真实 API：
.agents/knowledge/agentscope-2.0.2-facts.md（拿不准先读/root/oss/agentscope源码 + agentscope-skill 的references/v2-*.md离线镜像；该 skill 的 SKILL.md 正文示例是 1.x，勿照抄）。
现状
2026-06-22 在 6c6g 完成项目初始化：模块骨架、独立依赖（agentscope==2.0.2）、governance、forbidden-import CI 就位。实现与运行调优转交 Mac / mini-desktop（真跑需 chrome/headless+esbuild，6c6g 禁 chrome）。