6 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
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
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
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
zizi
ae7d78ddde docs(arch): 全仓架构档对齐游戏生成两条线(组外 ~14 档)
- tier2 富游戏线 = AgentScope(Python 独立 service) + Phaser;Tier0/1 廉价线 = SAA + LittleJS(产物走 src 源项目)
- gamedef json 正废除中(另会话)→ 终态=可维护 src 源项目;gameDefinition 现为迁移中的中间脚手架/债(非已移除)
- Cocos 区分:退出 tier2 自治轨改 Phaser;Tier3/3D/渠道导出的 Cocos 保留
- 未来可能两条线收敛入 AgentScope(登记)
- 覆盖:顶层图说体系(系统全景/架构/产品/前端图说) + 架构核心(README/产物执行沙箱) + glossary/tech-decisions + AGENTS§3 + mvp(总账/作战清单/可行性方案) + agent-specs(agentic编排-SAA/_index) + 图①svg

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 14:24:20 +00:00
zizi
38357c3dc0 docs: 架构文档补全 5 份 P0 新档(鉴权与权限 / 产物执行沙箱 / 契约总览 / 数据模型总图 / 变现端到端,均无 AI 味散文 + mermaid,逐份审过)+ 接进 架构 / 后端 / 运营 三域索引
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 17:45:23 +00:00