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

324 Commits

Author SHA1 Message Date
zizi
28e70d7d7b docs(arch-atlas): 收口单一全量主档——删冗余导览式apex+7域图说 
创始人裁定'删冗余只留全量主档':
- 删 系统全景图说.md(导览式apex)+ 7 域图说(产品/架构/沙箱/后端/前端/运营/运维),内容已全部 inline 进 系统全图说.md;SVG 与各域 README 保留不动。
- 系统全图说.md 防漂移门改指真实设计档(6域README + 13模块/契约总览/产物执行沙箱/数据模型/鉴权/观测/k8s/生成引擎README)的 commit hash,非已删的中间图说;每图具体映射见图脚注。
- 顶层 README 加'看图入口'指向全量主档;.agents/skills 配方 + plan 同步为'单一全量主档'口径(多文件跨子目录不渲染→合并一篇引子目录assets)。
复核:35 图嵌入零缺失、36 Mermaid 完好、目录锚零断链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:07:50 +00:00
zizi
799ec6790f docs(arch-atlas): 系统全图说——单一全量主档(全部图说 inline 在一篇·全图真渲染) 
按创始人反馈:多文件跨子目录引用在其渲染环境不显图,改为一份自包含主档。
1721 行:顶部目录(102锚零断链)+ 7张系统级图 + 七领域全部图说逐字并入;
35 SVG 经顶层相对路径引用(逐个ls实证存在·零缺失)+ 18内联Mermaid + 18张'引'图改内联其README Mermaid(带图源小注);
SVG文件不动仍在各子目录assets/。生成引擎子树只链接不并入(另session在飞)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 14:56:17 +00: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
4abc0f1e5f docs(gen-engine): 生成引擎模块补图 P0 四张电梯图 + 《生成引擎图说》总入口 
- 图① 全局两线+tier体系(廉价线vs自治线·零耦合·公共组件交汇)
- 图② 游戏=长生命周期源项目(源目录+六操作+改源不改包闭环+免LLM/要LLM)
- 图③ 廉价线端到端(一句话→开闸→SAA16节点→九门→落库→feed·串编排/验收/prompt/开闸)
- 图④ 数据飞轮全景(生成→发布→播放→遥测→反馈→优化·三轮咬合)
- 新建《生成引擎图说.md》总入口索引全模块(P0四张+tier2九图指针+各档mermaid+P1/P2待补)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 13:42:15 +00:00
zizi
d5efe45f71 docs(agentic): 回写 tier2 三份设计档对齐图说(2.0.3真实结构/三层校验/两阶段/二维复用/service化) 
把图说确立的本次校正回写进设计档、supersede 旧表述(均经 agentscope 2.0.3 源码实证):
- 四层工程架构: 四层→职责视角(environment=Workspace 双轴注入·Agent 非常驻) / 双层→三层校验 / 复用契约→二维+6项改官方+载体类型 / 补两阶段·service化·goal-task·无 workflow DAG
- 实现详设: 运行时形态(两阶段/service化/session三路径) + 三层校验 + M3 接入(AnthropicChatModel+base_url+thinking) + 建设五步锁2.0.3 + 源项目契约复用 finish schema
- 集成架构: 官方 Agent Service + Agent Team(MsgHub已删) + session三路径 + workflow范式(无DAG+未来需求登记) + trace=Event System+OTel+Studio + 预算软刹官方/硬熔断自建
- 待定: 记忆载体 ReMe(独立框架·要自接) vs mem0(2.0.3官方内置 middleware)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 13:08:15 +00:00
zizi
f9d6baa5f4 docs(arch-atlas): 总图叙 apex 系统全景图说——第一期收口(导览式·7系统级图+七领域导航) 
读一份文档完成整个系统了解+据图 review:§2 七张跨域系统级图(六域生命周期/六层分层/
现行SAA线‖远期tier2轨边界/跨域数据飞轮/失败降级补偿全景/端到端鉴权信任边界/角色×端)+
§3 领域导航(每域讲什么故事+最该据图review的命门缝+链接)+§4 按角色下钻路径。
单源只链不重画;6 SVG 经脚本核良构/零溢出/脚注转义;9 源档 commit hash 防漂移门;
现行vs远期严格标(tier2远期待spike虚线/Dify废/网关双校验未来态)。
第一期=总图叙+7域图说(运维/产品/架构/沙箱/后端/前端/运营)全收口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 12:35:15 +00:00
zizi
7fff6518a4 docs(arch-atlas): 第一期六域图说(产品/架构/沙箱/后端/前端/运营)——克隆运维金样板 
6 域图说 + 25 张新 SVG,克隆运维金样板配方:house style 沿用、状态双层标注、
单源引用(引图只链 README 不抄)、frontmatter 防漂移门记源档 commit hash。
独立复验:25 SVG 全 XML 良构/零溢出/脚注映射+状态齐/转义 OK;6 md §0-3 结构齐、
hash 与当前 git 一致、单源 mermaid 块数=新 Mer 图数。
高风险图抽验:架构契约族诚实画'声明 vs 现实'5 处漂移缝;运营合规死锁点出律所待裁缝。
覆盖 ~56 图位(25 SVG + Mermaid 内联 + 引用现有)。PNG 留 mini-desktop 后续转。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 12:15:54 +00:00
zizi
3fc54ea201 docs(agentic): 落创始人第2轮反馈——两阶段闭环/session三路径/goal-task/载体类型/workflow范式 
- 图A 重画: 阶段1只读(EXPLORE)+跨session对话+修改意图设计 / 阶段2写工程内文档+模板初始化工具+写代码 / 工程仓闭环(写→读)
- 图1/2 加 Agent Team; 图2 加 session 初始化三路径(续会话/加载已有工程/加载模板)
- 图3 补 goal/task(AgentState.tasks_context TODO 追踪); 图6 每个自建项标载体类型(Tool/MW/Skill/Prompt/Memory/Schema/独立)
- 图说 §5b 登记未来需求(给用户的 workflow 能力·待讨论) + §5 校正记录 + workflow 范式(无 DAG·自治)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 12:01:04 +00:00
zizi
891a5777c2 docs(arch-atlas): 运维域图说金样板——架构图集首件(8图:4 SVG+3 Mermaid+1单源引用) 
第一个域样板,验收通过作扇出克隆标杆。house style 沿用金样板;
状态纪律到位(观测=接/k3s=缓,图顶状态约定条+元素级实心 vs 虚线);
单源引用(图1四机只链 README 不抄);frontmatter 防漂移门记三源档 commit hash。
4 张 SVG 经脚本核:XML 良构、零溢出、脚注映射+状态齐。PNG 留 mini-desktop 后续转。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 11:30:43 +00:00
zizi
3c008fb847 docs(plan): 架构图集 v2 确认稿——全域目录+图清单+每图讲什么(纳 Codex+Opus 双评审整改) 
六域生命周期结构上增量铺图集:总图叙(导览式)+ 六域各一份图说 + 生成引擎子树(提案待与在飞 session 对齐)。
混合形式(复杂 SVG + 简单 Mermaid)、house style 沿用金样板、逐图标状态、单源引用防漂移。
~140 图位(~110 新作 + ~30 单源引用)。分两期:先六域、后生成引擎子树。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 11:05:56 +00:00
zizi
e41389ef09 docs(agentic): 落创始人4问校正——两阶段/真实结构/三层校验/reuse二维 
- 新增图A 生成两阶段(工作室 Agent Team 星形多agent设计 → 单写实现)
- 图3 按 AgentScope 真实对象结构重画(Agent 无状态引擎持有 Workspace 双轴注入 / Agent 非常驻每run现组装)
- 验收改三层(L1编译运行必须/L2设计符合尽量/L3效果只评分·初期只L1)
- 图6 reuse 二维重做(来源×共享范围·官方能力列全·自建核对该删的改官方·公共=自建∩共享)
- 图说 md §4 三层表 + §5 四问校正记录 + §6 术语映射;均基于 agentscope 2.0.3 源码实证

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 09:40:41 +00:00
zizi
e6d87dc4f5 docs(agentic): 补全 tier2 运行时架构图集(图1/2/4/6 svg + 图5/7/8 mermaid) + 官方术语校准 
- 新增 svg: 01-系统全景 / 02-调用时序 / 04-ReAct循环流程 / 06-reuse边界全景
- 图说 md 补全 8 图 + 图5/7/8 mermaid + 术语映射
- 校准官方术语: Agent Service(REST+SSE) / Workspace(Local/Docker/E2B) / Event System(agentscope 2.0.3 源码实证)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 07:32:36 +00:00
zizi
0ff4d8cc48 docs(agentic): 模型接入口径纠正(统一new-api·协议不锁) + tier2运行时架构图说金样板(图3 svg) 
- 内网凭据档补 new-api 协议端点(/v1/messages + /v1/chat/completions)+ 接入铁律(协议/SDK 不锁)
- rules/security 加模型接入统一出口红线;skill cheap-model 纠正旧「唯一 OpenAI 兼容出口」口径
- 新增 agentic运行时架构图说.md + assets/03-运行时内部架构.svg(金样板,基于 agentscope 2.0.3 源码实证)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 07:04:54 +00:00
lili
37f5eddbdd docs(architecture): tier2 四层工程架构(评审版)+ README 导航 
独立 AgentScope 模块的 environment/harness/context/prompt 四层地基(建设五步第一二步);复用契约四类(外部复用 cost.py/_client.py · 种子拷贝 studio.py · 自有依赖 agentscope · 禁止依赖 SAA);双层验收=确定性硬门(机制地板)+ M3 视觉软检(只观测、绝不拒发);硬代码 vs 可配置=三类门 + 三类配置;能力包 manifest 单一 owner;预算闸 fail-closed;spike-grade 地基逐项映射《详设》六样前置物。已过两轮 Codex+Opus §6.8 双评审,档内发现全闭;残留跨档 T1-T6 见 §11。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-21 18:51:36 -07:00
zizi
7b40175853 docs(recall): 历史回收第二轮(查漏补缺+review)6 域清单 + 总索引更新 
拿这几天 9 份新设计档复核第一轮 199 条 + 补漏:
- 新挖 43:跨域双漏(admin 审核台四页+观测三入口)/ 3 条确定性后端缺口
  (trade_income 缺 game_id·game_stat 缺留存·封号级联零实现)/ 生成硬门 A-E
  pivot 未回填 canon / 冷启动供给(种子游戏+创作者 BD)/ 广告挂了要跳过保留存 /
  new-api 网关健康巡检
- 改判 28:含 1 个真判错(后端 008 推荐公式第一轮误判遗落,实早在架构 README §7)
- 已被新档覆盖 36:证回收→设计闭环有效(审核台整章接运营 9 条 / 观测+k8s 接运维
  9 条 / 数据飞轮接生成 4 条)
- 总索引 README 补第二轮章节;6 域清单带空判定列待创始人逐条判

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 01:15:25 +00:00
zizi
15b707fd2a docs(arch): 回填创始人 4 拍板(k8s收窄缓做 / P-FED-12升P0 / 同款不分成 / 审核台信用降权放第一期) 
创始人 2026-06-22 拍板,逐条落档:
- k8s:收窄(单节点 k3s + 数据库不进集群 + 推迟多节点/高可用/prod)+ 缓做(排 W-G1 之后)
  → k8s迁移 §7/§9/§6 收口、运维 README §4 修正
- P-FED-12 同款创作升 P0:Doc A 需求清单 P1→P0(P0 总数 55→56 待全局同步)、
  数据飞轮开放问题#6 + 正文收口、前端 README §7.3 口径校准
- 同款创作首期不分成、纯展示溯源:数据飞轮开放问题#1 + 正文收口
- 审核台 feed 自动降权 + 创作者信用模型放第一期(覆盖原"建议降 P1"):审核台
  §4 第一期/§3.5/§5.3 收口为放第一期、单独做(均待 contract-first 补新 -api/新表)

验证:待拍板残留 grep 全 0;Doc A 已 P0;审核台"放第一期"7 处。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 01:12:11 +00:00
zizi
3e71715af9 docs(arch): tier2 补充设计 4 份正式稿落地(数据飞轮/审核台/观测体系/k8s迁移) 
4 份设计草稿经 Codex(核事实)+Opus(对抗式)双评审 → 据评审逐份精修:
- 修系统性事实硬伤:把"待建/未落库/已禁用"误写成现状的逐条改为"现状+本设计
  新增+contract-first 清单"——数据飞轮 game_trade_income.game_id/lineage/ASSET
  枚举待建;审核台 FeedApi 降权-api/封禁链路/credit_score 待建;观测 5 指标零
  命中待埋点、@BizTrace 禁用;k8s Dockerfile 已存在/基础镜像 JDK21
- 修设计矛盾:血缘边 pending 状态机(坏同款不进网络)、去重加 child_creator_id、
  remix 默认轻量跳转+漏斗埋点、审核台 feed 降权如实改、观测落点统一 mini-desktop
  k3s(不放 mini-infra 569Mi)、k8s DB 接法定死 hostNetwork + QoS 纠错
- 洗 AI 味共 43 句:元叙述/套话/黑话清零(grep 负词全 0)
- 三骨架(生成引擎§10/合规闸门§9/运维§4)升级为指向正式稿;运营 README 接索引

待创始人拍板项见各稿开放问题(P-FED-12 升 P0 走 RTM / 数据回流授权 / 审核台
信用模型与 feed 自动降权 / k8s 范围与时机)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 20:16:36 +00:00
zizi
752b570eb8 docs(recall): 回填创始人三条边界判定(②③⑤ 全做;⑤ 含本阶段上 k8s + blast radius 提示) 
- ② 数据飞轮:三条全做(溯源链+同款创作 / 资产市场 / 收益回流训练),展开跨模块面+落地依赖
- ③ 审核台:全做(双层审核+锁风三档+违规处置+admin 前端)
- ⑤ 观测体系:全做+本阶段上 k8s;诚实标注 k8s=部署架构大变更,建议与观测埋点解耦单独立项
- 回收 README 判定纪要补"三条边界已定"更新

范围已钉、待出正式设计稿;均就地扩活档。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 18:46:20 +00:00
zizi
f4ee23109e docs(recall): 创始人逐条判定 5 条横跨多域优先项落地(2 对齐进档 + 3 立待补设计骨架) 
- ① 对话式创作:定调完整产品形态=对话创作+差量修改+改素材,一句话+选玩法模板=
  启动点位之一 → 前端 README §7.3 产品形态定调(对话式创作不再算 descope、前端 UI
  列待补;未擅改 P1/P0 验收契约)
- ④ 平台吞并风险:应对=深化引擎使用+创作能力 → 商业定位 §3「平台方下场风险与应对」
- ②数据飞轮 / ③审核台 / ⑤观测体系:创始人判"需补设计" → 生成引擎README §10 /
  合规闸门 §9 / 运维README §4 立待补设计骨架+范围建议,待创始人定 MVP 边界后出正式稿
- 回收 README 补判定纪要表(5 条结论+落点;其余约 194 条待逐条过)

均就地扩现行域活档、未新建一次性文件;全为人读散文。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 18:38:06 +00:00
zizi
6467820181 docs(recall): 历史设计点回收 6 领域清单 + 总索引(199 条待创始人逐条判定) 
六领域各派一个 opus agent,穷尽式挖历史/留痕文档(agent-specs/_archive、
brainstorms、plans、memorys、_archive 旧长档)里讨论过、但现行
docs/architecture 没沉淀的设计点/想法/顾虑/约束,按 遗落/过期弃用/不确定
三状态分类,判定列留空供创始人逐条裁定。

- 产品战略 32(遗落17)· 前端 54(不确定43=前端域档边界口径)· 后端数据契约 25
- 生成引擎 28(遗落10)· 运维基建 30 · 运营变现合规 30
- 合计 199 条(遗落60/过期25/不确定114)
- 总索引 README 拎出 5 条横跨多域的优先项(对话式创作UX口径分叉/数据飞轮
  生成侧落点/审核台空白/平台吞并风险章缺失/可观测性栈未部署)+ 判定口径

目的:避免现行架构在反复重写迁家中遗漏历史上认真讨论过、需考虑的约束。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 18:15:52 +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
zizi
5cadf5042c docs: ③ 五决策落地(1B trace 改'待立新类' · 2A 源项目契约另立独立 schema/防撞在产线 · 3A 前端 tier2 承载归属桩 · 4B 护城河对外暂不改+内部备注 · 5B 渠道竞标加 tier2 祛魅交叉引用) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 17:13:29 +00:00
zizi
7ecd616eb8 docs: tier2 口径对齐批量修(① 旧 Cocos 引擎口径→Phaser/Pixi 两轴 · ② 第二轨/控制面在各 SoT 登记;15 档跨知识层/架构/前后端/产品/运营) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 16:58:59 +00:00
zizi
9ee58e19a0 docs(tier2实现详设): 补现行装载基线(engineBundle/GamePackage 从库取)+ spike 跑序(M3 先证路+人验→flash/v4pro 比成本) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 16:42:16 +00:00
zizi
af3d89c970 docs(生成引擎): ③ tier2实现详设(4 mermaid)+ 收尾(重指 supersession→②、README 登记 3 档、删 agent-specs 旧源稿) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 16:18:09 +00:00
zizi
19adbf6078 docs(生成引擎): ① agentic集成架构(控制/管理面)+ ② 补 mermaid(生成循环·引擎决策树·正交两轴) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 16:10:42 +00:00
zizi
1ded0281bf docs: 无AI味写作标准入 AGENTS §6.12 + tier2 自治富游戏引擎设计(生成引擎子树·风格金样板) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 12:28:38 +00:00
zizi
83ca96c802 docs(agentic): 4 份设计稿收敛为 2 份(架构档=tier2+控制面散文重写 / 详细设计档=spike;删决策记录+控制面v2+旧架构-review) 
把围绕 tier2 富游戏自治轨 + agentic 控制/管理面的 4 份 WIP 设计稿收敛成 2 份,
全部以人读散文重讲、去机读电报体:

- 新建主架构档《agentic 生成架构:tier2 富游戏自治轨 + 控制/管理面治理层》,
  合并重讲原 tier2 架构-review + 决策记录 + 控制面/管理面 v2 三份为一条连贯叙事
  (为什么要 tier2 → O2 约束自治 → 引擎选型 → 渠道 → 控制面四组件 → 关键决策 → 建设排序 → 证到哪了)。
- 0号 spike 详细设计档只轻改对老架构稿的交叉引用,runbook 正文保持原样。
- 删除已折叠的 3 份源档(遵守一题一活档)。
- 顺带把 README/tech-decisions 两处 supersession 指针重定向到新架构档(修我自己删档造成的死链)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 11:45:05 +00:00
zizi
c7b5e8382f docs(agentic): 控制面/管理面设计 v2(并入双评审修正+认领线A+砍热加载语义+提前只读看得见) 
并入 Codex+Opus 双评审修正(全部已对代码核实,带 file 锚点):
- 认领线A:配置外置(prompt 同源/models.yaml)= 生成主线架构演进路线 线A 阶段2-3,
  本档不另立分期、只引用,控制面在其上做净增量(审计日志/管理面UI/统一trace contract/
  注册表推广skill·tool·mcp/热加载选型)。
- 砍热加载语义:Prompt Registry 是构建期 maven 快照非热加载(PromptResourceLoader.java),
  "不发版改"砍到"下次任务生效";优先复用 infra_config + ConfigApi 已验证窄通路
  (AigcControlPlaneProperties.PAUSED_CONFIG_KEY);先关 registry STUB(generic-coder)再推广。
- 纠模型现状:已有 AigcExecutorProperties.llmModel + SaaGraphDispatcher.saaForceModel 两入口,
  非"全是 Java 常量";models.yaml 说清两入口迁移/保留。
- 统一trace改真contract:同表+公共核心子集(traceId/step/cost/verdict/timestamp)+各轨JSON扩展段,
  落 contracts/trace/agentic-run-trace.schema.json;split-brain 真口径=诚实镜像不造字段。
- 拓扑降一档:SaaStudioGraph 是唯一布线源(编译期StateGraph),phase-1 只外置节点参数、
  结构配置化推迟;守不变量#5框架可换=管理面只渲染运行时自报、不另持拓扑模型。
- eval门/D12记账诚实化:eval四门部分蓝图(adversary-review未建lint)、D12记账是骨架且仅覆盖SAA、
  tier2 eval门是spike产物现不存在=配置安全门对tier2是接口层非内容层。
- 补配置审计数据模型+权限+GitOps/DB直写选边;tool registry收窄到tier2必需+补
  discovery/healthcheck/permission/timeout/schema-test/kill-switch;MCP后续+fail-closed降级;脚本逃生禁用/白名单。
- 可视化合成(创始人认可):①保留config-is-truth内核②phase-1诚实改名"配置管理+运行可观测控制面"
  并提前不依赖前置的只读"看得见"切片③限版图编辑排进phase-2不推远期。
- 小修:成本对账标依赖F3;删"覆盖90%痛点"无依据数字,改可验收指标。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 10:58:57 +00:00
zizi
cd5e4d8df0 docs(agentic): agentic 控制面/管理面 完整落地设计(创始人核心愿景=配置驱动+可视+可追溯+可审计) 
把仓内散落零件(D12控制平面/9d trace/Prompt Registry/SAA checkpoint观测)合成连贯架构 + 补三缺口(可视化编排 / agent-skill-tool-mcp 统一管理 / 跨两线统一观测审计)。四组件:配置注册表(配置即代码·热加载不发版·声明式+脚本逃生·eval/灰度门)+ 观测审计仓(运行轨迹 + 配置审计两条事实线)+ D12 运行治理门 + 管理UI(读注册表+观测仓的视图/编辑器,非 Dify 式建图器)。守'别过度工程'(裁决§154):配置是数据非新框架·UI 是视图非建图器·一致性靠测试门非重型注册表·可观测靠 schema 完整非堆中间件。分三期:配置地基(=5步路线 step1-2、tier2 前置)→ 管理UI最小版 → 可视化建图远期。跨切平台层、服务 SAA Tier0/1 + tier2,不改生成逻辑。待 Codex+Opus 双评审定稿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 09:53:48 +00:00
zizi
d73c537fec docs(tier2): 0号 spike 详细设计 companion 档(补完整性检查最堵 P0,让 spike 可跑) 
opus tier2 内容完整性检查指 §12 spike 是'判据哲学'非'可跑 runbook',工程师跑不起来。本档补五块:靶子游戏 mini-肥鹅 系统规格(资源/合成/订单三系统+耦合点+胜负)/ 模型矩阵(deepseek-v4-flash·pro + MiniMax-M3,n≥30 承袭基线纪律)/ 过门精确阈值(★建议值:过门率≥50-70%·成本≤¥3/款·max_iters + 退路树数字触发线)/ 两段实施 runbook(纯模型变量→开放自产driver,含Goodhart三层隔离)/ 采集指标字段表(run级+矩阵级)。生死门从哲学变工程可跑。剩余完整性缺口(engine-project 封闭 schema additionalProperties:false 需判别式决策 / dispatcher·callback 复用 delta 漏引 job-in 已有 tier 字段 / tier2 产物进 web feed 接点)待 codex 检查到齐并入主稿 §4/§11。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 08:50:13 +00:00
zizi
66eff15f26 docs(architecture): tier2 引擎 SoT supersession + 纠正 headless MCP 事实错(创始人 go) 
据 Cocos 全无头核实(取证级:Cocos Creator 命令行构建仍需 GUI 环境、无独立 CLI/SDK;其 MCP 是编辑器扩展、需编辑器在跑、非 headless),纠正策展层 SoT 的事实错并立正交两轴:自治生成轨(全无头·富2D=Phaser/Pixi·超休闲=LittleJS)/ 3D·渠道导出轴(Cocos·编辑器+人在环)。Phaser 的 Tier1 冷启动落选属渠道/交付维度、与 tier2 headless 自治维度正交。改 架构/README §2.3(横幅+Cocos/Phaser 单元格+分层段)+ tech-decisions §选型依据。旧 agent-specs/引擎与运行时.md 已由 _index 重定向、Tier1-only 无 Cocos 口径、非本次范围。详见 tier2 架构设计 v2 §3。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 07:33:21 +00:00
lili
5403bdd651 docs(planB): Phase-2 收口报告 + 保真谱系蒸馏（§10）——机械门达/复杂机制保真受当前 gen 配置限 
Plan B Phase-2 game-quality 门对 gen-done 真跑收口：
- 5-bug 账本（Phase-2 逆出）：assets 打包断链(490dc629)/iframe CSP 静止(347dd023)/dist 漏 --mode staging(ff8e52c3)/gen 不忠实(9176abe9+7aeb8f54) 自修；throughput 排队
- Phase-1 判定：core-done 机械门(U2-U9)达；gen-done 简单玩法保真、复杂机制(breakout/snake)受当前 M3+gamedef-path 限
- 自我修正：非绝对天花板（flash/local 曾产可玩打砖块 + §9「单件失败禁归模型造不出」红线），深修=换模型/skeleton-first=Plan A
- 蒸馏 cheap-model-game-generation §10：gamedef 保真谱系 + Phase-2 门≫gen 自评 accept + 裁责三招

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-21 00:32:50 -07:00
zizi
353c51cc57 docs(tier2): v2 补「建设排序」一节(整理创始人 5 步路线进设计稿) 
以创始人五步为骨架,补进:0号 spike 立为 step3 之前的早期 go/no-go 门(便宜验最深赌注、不等平台搭完)+ 失败退路树;step3「搭引擎」隐藏硬工作项显式化(验收地板/Goodhart 安全 driver/成本强制四熔断三层预算/真 Phaser 工程源项目契约/可观测早建/人审做实非亲玩一票);资产IP 归 spike 后复利层;Cocos 置 step5=另一条轴(编辑器人在环·3D复杂渠道)、Phaser 证成后再铺、不与 Phaser 并级。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 06:51:41 +00:00
zizi
2ec00f13fc docs(tier2): v2 补「渠道发布能力」一节(回应创始人渠道发布之问) 
实证裁决:Phaser/Pixi 渠道发布=可建一等能力、非墙——微信官方钦定自研 adapter、仓内 W-CH-α 已为同构 LittleJS 推到 P0 实证可行;几项看似 Cocos 优势其实平权(变现 SDK 所有引擎手动 / 快手全走微信格式转换 / 纯代码全 Linux 打包反优于 Cocos 需 Win-Mac);唯一让步=国内生态成熟度 Cocos 领先。与引擎无关的真墙=渠道禁动态生成代码→tier2 自治富游戏上渠道须降级为精选款固化提审(web feed 热发长尾 / 渠道精选爆款)。渠道不构成保留 Cocos 的理由,待补=W-CH-α P1 真机门用 Phaser 真包跑(卡创始人三件套=日历闸门非技术阻断)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 06:39:28 +00:00
zizi
2abfa9f112 docs(tier2): tier2 富游戏生成轨 O2 架构设计 v2 + 决策记录 
设计稿(O2 约束自治·人风散文)经 Codex+Opus 双评审 + 两项实证后定 v2:O2 降为待 0号 spike 验的假设(非已定地基)、配靶心(56% 表现层)+ 失败退路树;80/10 实测落 44/56(约束有效域=系统/手感 44%、自治承重=表现层 56%);引擎按正交两轴收口(自治生成=Phaser/Pixi 无头 / 渠道导出=Cocos),触发引擎 SoT supersession + 纠正 headless MCP 事实错;修 Goodhart 漏洞、加跨表语义门、spike 两段+四向归因、中台降级、AgentScope L1/L2 纠正等 must-fix。

决策记录(子代理):11 条决策 + 证据链 + 待 spike 验开放项。未含 SoT canonical 同步(待创始人 go)+ 轻评审定稿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 06:10:06 +00:00
lili
77f67fdb13 Merge origin/dev/2.0.0(SAA 生成域 20 提交)—— 设计文档域化重构 8 提交并入 2026-06-20 21:16:28 -07:00
lili
7bd9cd05e6 docs(governance): Phase7 收口——治理门反转 + 源档归档 + 入口对账 + 死链门 
设计文档域化重构总收口:
- §10 治理门反转(engineering-conventions §10.5/10.6/10.7):canonical 根从 agent-specs 改为 docs/architecture 6 域树;品牌门白名单加 architecture/_archive。
- 归档 11 settled 源档(7 根 architecture + 4 非生成 agent-specs canonical)→ 各自 _archive(git mv 保 history + tombstone redirect)。生成域设计链过渡期保留(架构演进中)。
- rewire 17 个活层文件(.agents/knowledge|rules|skills + docs/mvp + AGENTS.md + 新树)指向新树路径;活层零残留旧 canonical 路径。
- AGENTS.md §4 必读表/§3.2 目录树/§3.3-3.4 指针 → 新树;_index.md 瘦身为 trace/spike + 生成域演进链 + 修 line22↔40 自相矛盾。
- 新增死链门 .agents/tools/check-deadlinks.sh(§10.7 死链项的可执行脚本)。
- 全门齐跑:死链 0 / 新树无旧品牌 / 无超 2000 行 / 活层无残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 20:48:38 -07:00
lili
ec7fda2cee docs(architecture): 标记生成引擎子树为「架构演进中」 
review 暴露生成域正处于 gameDefinition→src/ 终态迁移 + 产线化(plan 2026-06-18-001 U1–U4)。给 11 份子树档插「🚧 架构演进中」横幅 + L1 总索引/架构 README 导航处加注,提示现行结论可能随 plan 推进变化、以最新裁定为准。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 20:36:13 -07:00
lili
c6b9569033 docs(architecture): 修复审查发现的过时/错误内容(57 项 · 18 档) 
25 档 opus 审查(对照代码/契约/git)→ 9C+23M+26m 真过时/错误 → 18 档 opus 修复(各自先按 commit/file:line 复核再改,1 项审查误判经复核拒绝)。主要簇:① gameDefinition 终态对齐——固定架构/SAA编排把'真结构化已成立'降级为'通往 src/ 的中间脚手架 + behavior.code 内嵌串=已知债',跨档对齐 README §3.2/设计裁决(06-20 创始人定调);② WG1 门面缺口按 06-14 scale-20 实测修订(预判几乎全推翻);③ 开闸接线改完成时(generic 桥接 7534bdf9 + 5 品类模板回填 046c061d 已落地);④ Flyway 数字 V17/V18→V25;⑤ 会员订阅(V21 ca53a0db)/community(U3 3f35acb4)/资产渲染(U1 73d33916)状态更新;⑥ prompt治理(classpath 加载)/引擎(Phaser gz)/前端(token 名·prefers-color-scheme)/运维(mini-infra=PostgreSQL·push=阿里云Gitea)细节订正。全 26 档过门(≤2000/有图/品牌绘境AI)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 20:21:03 -07:00
lili
c2ec8e07f8 docs(architecture): 写 L1 总文档索引(6 域 + 生成引擎子树导航) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 19:45:23 -07:00
lili
fc0c164678 docs(architecture): fan-out 重写架构/前端/运营/后端/运维 5 域(20 档 · 全 opus) 
Workflow 每目标档一个 opus agent,以产品域 README 为风格样板:架构 L2 主档 + 13模块 + 生成引擎旗舰子树(11 档:README/固定游戏架构/SAA编排/引擎与运行时/验收门-W-G1/prompt治理/设计合理性裁决/OpenGame对照/WG1基准/SAA能力API-dossier/开闸接线)+ 前端 + 运营(README/变现与单位经济/渠道发行/合规闸门)+ 后端瘦主档 + 运维瘦主档。全部:人读散文 + 多图(Mermaid)+ 少黑话(专名首现解释)+ 单档 ≤2000(最大 452)+ 品牌绘境AI + 硬事实保留(门ID/数字/契约/裁决)。源档归档、§10 治理反转、~17 连带引用、L1 总索引、_index/AGENTS 对账、死链门统一留 Phase7。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 19:43:41 -07:00
lili
366a44b4b5 docs(architecture): 重写产品域为 4 级散文设计文档(5 档) 
黄金模板(owner 已验风格)+ SPLIT + forensic 落地:产品/README(L2 域主档)+ 需求清单/需求模块映射(含 2026-06-17 forensic 现状快照)/护城河话术/商业定位(L3)。人读散文 + 多图(Mermaid)+ 少黑话(专名首现解释)+ 单档 ≤2000 + 品牌统一为绘境AI。源档与连带引用改动统一留 Phase7 总收口(避免多域构建期半态);域间前向链接待其余域建好后在 Phase7 验。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 19:20:26 -07:00
lili
7f71932023 docs(architecture): 设计文档域化重构 执行计划(门驱动 + 分域 fan-out recipe) 
配套 review v2 的执行版:文件结构(目标态)+ Phase0 地基(骨架/§10 治理门反转/doc-organizer/死链门)+ Phase1-6 分域重写统一 recipe(harvest→author→archive→rewire→gate→commit)+ Phase7 总收口。门驱动替代 TDD;1a 产品域纯 FOLD 子集作黄金模板含 owner 验收点。批准前零改动,仅计划档已落。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 13:29:48 -07:00
lili
03fe73c7e7 docs(architecture): 设计文档域化重构 评审版 v2(双评审过 + 大厂风格规范) 
将 docs/architecture + docs/agent-specs 的设计文档全量重写为 4 级域树(总索引→域主档→模块子档→详档)、6 域(产品/架构/后端/前端/运营/运维)、落 docs/architecture 单根的设计评审版。过 Codex+Opus 双评审,18 发现已处置(§8):范围 blast radius 补全、C2 头号约束更正(生成域在飞红线已解除)、回灌门可执行 schema、06-17 取代连锁接管;补大厂风格规范(人读散文/多图/少黑话/单档≤2000行)。批准前零改动,仅本评审档已落。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 13:24:48 -07:00
lili
fba7f3e030 Merge branch 'dev/2.0.0' of ssh://101.200.34.71:2222/zizi-al/games-development-ai into feat/mac-gamedef-qc-concurrent 2026-06-20 11:50:59 -07:00
lili
f4c6789312 docs(saa): 蒸馏 M3 thinking 治理/协议/流式 + rc 门修(91.7% 跃迁) → .agents 技能 + 决策档 
§7 知识沉淀（仓库权威版，配套代码提交 4e5a7bbf）：

- .agents/skills/saa-graph-orchestration.md：新增 §3.5「M3 thinking 治理 + 协议/流式」——M3 thinking 二元(无深度/budget、提示词压不住)；openai adaptive 内联污染→只能关；anthropic 原生分离要质量走这条但必配【流式 StreamingCallChatModel + NO_PROXY webClientBuilder】否则阻塞整取大面积 SocketTimeout；#4407 对 1.1.2 过时；rc 门耦合 bug(playNode pass 别前置 rc==0)。e2e 段补 2026-06-20 跃迁(67%→91.7%、证伪模型天花板)。
- docs/plans/2026-06-20-…md：状态 banner→主线达成 + 追加 §7 结果与修正(rc 真根因 / thinking+协议杠杆 / 实测对照 / n=12 达标口径放宽 / 未尽项)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 11:38:59 -07:00
zizi
991264b99b docs(复盘): 架构错误根因复盘 post-mortem(批二第二件) 
「为什么结构化源项目做成了 JSON 生成游戏」的过程复盘。两条根因轴:
- 决策层(元根因): 评审只在范式内审细节、从不质疑「该不该是 JSON」这个前提;
  错前提被一路精致化+自产证据(双证/九门全绿)加固。codex+opus 双验证器独立同指此处。
- 知识层: 设计写对、实现没兑现——「沉默的重解释」(文档自称落地却中途换核心定义、无对账门)
  + AI无状态四放大器 + 整体一致性无主 + 规则没编译成机器门。
更深: AI 系统性偏向「可测量的」而非「好的」。
教训已蒸馏: AGENTS.md §6 条款10/11 + engineering-conventions §10.7 四道门 + 生成主线 ★终态定调。
本会话创始人四次「前提质疑」(agent管理/裸图官方性/SAA价值/九门=工具)实战印证该机制价值。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 17:31:07 +00:00
zizi
dbb0a76856 docs(治理+生成): 文档治理强制门体系 + 整体一致性负责人 + AGENTS.md 全中文化 + 品牌收敛 + 生成产物终态定调 
- AGENTS.md: 品牌「造梦AI→绘境AI」+ 剔除 §9 gstack 安装命令(入口卫生) + 全文简体中文化
  + §6 条款10/11(强制门清单 / 整体一致性负责人=创始人+6c6g文档线 / AGENTS.md 自检)
  + §3.4 关键模块架构设计引用(指向 product-and-architecture.md, 不在入口重写)
- engineering-conventions §10.7: 4 道强制门可执行规格(品牌不变量 / canonical唯一 / doc↔code兑现 / 入口卫生)
  + 白名单(docs/ip 法务 + _archive 留痕豁免) + AGENTS.md 自检清单
- 生成主线架构演进路线.md: ★产物终态定调(创始人 2026-06-20 拍)——终态=src/ 多文件工程,
  gameDefinition 仅中间脚手架, new Function 跑 JSON 内嵌串=债; 配 doc↔code 兑现门;
  就地 reconcile v2/固定架构「都 ACTIVE 却冲突」
- 现行层品牌收敛: .agents/ + docs/architecture/ + docs/mvp/ 共 20 处「造梦AI→绘境AI」

由来: 2026-06-20 架构错误 + 文档治理复盘(codex/opus + 三 agent 对抗验证收敛);
根因 = 规则没编译成机器门 + 整体一致性无主。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 16:55:24 +00:00
zizi
f64a4ed1d7 docs(arch): 生成设计合理性·对抗审查裁决——部分合理,Tier0非通用范式 
4视角对抗深析(逐条file:line核实):地基(确定性受控面+九门自动验收)是真护城河该坚持;但3个fundamental——名实不符(behavior.code承载全部逻辑却没进契约,additionalProperties偷渡)/表达力硬编码焊在4类色块玩具/好玩好看无下限托底(assets在build链零消费者)。是Tier0可靠产线非通用范式,最大风险=对标demo的Marvel/KOF。四改:正名混合范式+愿景分层(创始人级)/逻辑往声明式拽回/打通assets链/好玩从九门剥离。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 11:34:45 +00:00