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

355 Commits

Author SHA1 Message Date
zizi
99a6afe08c docs(review): 非后端四模块代码评审收口 + _index 登记 
game-runtime / game-studio / tier2 / wg1 四个非后端源码模块的跨模块代码评审：
4 个并行后台 workflow × 三阶段（静态分析在 mini-desktop / 接口协议+大厂规范+项目铁律深审 / 逐条 file:line 对抗证伪）。
结果 0 P0、9 P1、7 P2、9 P3（另 1 条候选证伪）。核心代码语言规范达大厂基线、无 error 级问题；
真风险 = 生成 worker 成本与幂等闸、活层 3 处旧品牌+品牌门覆盖洞、契约真空/v1→v2 漂移、game-studio 构建门。
逐模块明细嵌于评审档 §七，_index §6 已登记。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 12:41:33 +00:00
zizi
9945e2aa9a docs(tier2): 部署档补 B1 控制面真驱配方 + 凭据/chat 体口径 + setsid 起服务铁律 
团队共享(创始人「记录部署位置/端点」铁律):
- B1 control_plane 跑一款到门绿落库的 detached 命令 + game_id=session_id 评门口径;
- 凭据注册体 {data:{...}} / chat input.content 须内容块列表(smoke 实证定稿);
- 起常驻服务必 setsid 脱离 ssh 会话(nohup 会挂通道致启动被 timeout 打断)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 08:00:39 +00:00
zizi
1a4c6970b0 docs(deploy): 记 tier2 P4 服务化部署拓扑(团队共享)——Agent Service @ mini-desktop:8200 + 真落库 MySQL/MinIO + 运行环境 
内网开发阶段、明文记端点+凭据(铁律授权)。Agent Service 起法/REST 路由/Redis 后端、BackendStore 的 MySQL 库表+MinIO 桶+key 约定、venv/worktree/装依赖法,全部落档供团队共享。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 07:20:13 +00:00
zizi
78ff9f5d86 docs(creds): 补基建数据面凭据(Redis/MySQL/MinIO @mini-infra)——tier2 P4 服务化/落库用 
从 mini-infra docker 容器 env 抠出落档(内网 Tailscale 凭据按铁律入仓):
Redis 6379(requirepass)/ MySQL 3306(root)/ MinIO 9000(ragflow)。tier2 Agent Service MessageBus + 第二装载落库要用。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 06:15:29 +00: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
lili
0ccce16aa2 feat(amodel-gen): gen.mjs --brief-file + SAA→A-model 执行版 plan(集成C) 
--brief-file 容大段富化设计稿(避 argv 长度/引号坑;U3 Java shell-out 复用),design+saa 双模式生效。plan 已折叠两轮 Codex+Opus 双评审。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-23 19:45:33 -07:00
zizi
456653cbe1 docs(design): 接口协议 plan opus 终审整改(无 P0)——行号 696→692 / 成本血统钉 new-api / verdict 硬前置与 Q2 口径统一 / readState per-品类层 / §7 补 Q14(A4.5)/ 去元叙述 
opus 子代理对抗终审判'无 P0、可合',逐条整改其 P1/P2:
- P1-1: _bash.py 行号 696→692(实锤;§4 行号读的就是本机 v2.0.2 tag、准确,不软化)
- P1-3: A2.5 成本归集留 §7 Q6 定 + 成本权威钉 new-api 计费行(trace 只携关联键、agent 自报金额不作账)
- P1-2: §7 补 Q14(A4.5 构建产物+feed→play 入口 提独立A类 vs 字段待spike)
- P2-1: A6 readState 劈引擎级(per-engine)vs 语义 state(per-品类·接 A10)
- P2-2: §6 verdict 硬前置=纪律(机器判禁自评焊契约层),结构选择归 §7 Q2,消两处口吻冲突
- P2-3: 去元叙述(诚实说在前面/必须纠正)
状态置 opus 终审通过、作设计基线合入。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:40:26 +00:00
zizi
1a36a7279e docs(design): 接口协议草案 agentscope 2.0.3→2.0.2 + 克隆路径订正 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:31:42 +00:00
zizi
f1ca3b792f Merge dev/2.0.0: agentscope 2.0.2 版本订正入设计分支 2026-06-23 18:31:41 +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
zizi
01771b7437 docs(design): 接口协议层与可插拔模块草案——固定契约 vs 可换实现(两轮 workflow + 对抗评审 + 主会话纠漂移) 
回答'换引擎/框架=接适配器、哪些写死、哪些 skill/mcp、探针能否是 skill、多语言'。两轮 workflow(11 子代理)+ 源码核实 + 对抗评审:
- 第一轮 生成/引擎/框架内核:A1-A7(+补 A2.5 trace/A3.5 版本寻址/A4.5 构建+feed入口)+ B-ENG/PROBE/FRAMEWORK;§4 AgentScope 机制实证(MCP=多语言支柱·2.0.3 无 register_tool_function 纠偏)+§5 现状 7 耦合接缝
- 第二轮 平台级面:A8-A13(送审/资产/玩法模板/试玩HITL/通用检查门/配置)+平台级 B(资产源/品类模板/渠道提审/配置注册表)
- 对抗评审揪正'想要≠已是':verdict 锁死 Tier0/1 须 fork+焊纪律、dispatcher 仅 dispatch()无 cancel、trace/GenerationState/配置注册表 contracts/零命中=反锁死真 GAP
- 主会话复验补:A4 projectType→engineBundle 装载分流漂移纠正、A8-A13 tier2 段标 v1 directional

草案·待 Codex+Opus 双评审 + 创始人定(§7 共 13 个开放问题)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 17:49: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
zizi
32adda9517 docs(tier2): 核心三族细图——C 单写循环×4 / D 三层校验×3新 / E 能力面×3新 + 三族图说 
10 张新图经 draw→对抗验证→族汇编 workflow(23 个 opus 子代理)产出,保留首批 3 张手绘样板:
- C 单写循环:单写ReAct循环 / M3 Anthropic原生接法 / 四道熔断+预算闸 / 多轮范式承amodel-gen
- D 三层校验:富游戏专属门(三联动+经济+latch) / advisory分级+Goodhart隔离 / CDP探针Phaser重写
- E 能力面:引擎能力包五件套 / prompt两阶段角色 / A-model 4插件复用

对抗验证逮修真问题:D3 'P3'命名碰撞(张冠李戴·grep证伪后改)/ D5 半角冒号 / E2 虚实线图例自相矛盾。
全 13 张复验 界内/良构/脚注/ok。3 份族图说带防漂移 commit hash + 人读散文(正反例传下子代理)。
D 族 advisory 跨分支状态校准:A-model 分支已落、未合并 dev/2.0.0,主干视角=接(非现)。
3 份细节图说接进 agentic运行时架构图说.md 看图入口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 08:17:45 +00:00
zizi
9237fdf7a8 docs(tier2): 核心细图首批3张——三层校验全景(D1)+九门逐门(D2)+skills清单(E1) 
颗粒度样板,覆盖创始人点名的两个头号问题(哪九门/有哪些skill)。
内容对 tier2实现详设.md / 自治富游戏引擎.md 取证,house-style 复验全过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 07:43:07 +00:00
zizi
ccb00bb9f2 docs(tier2): 接住 A-model 分支(Tier1 agentic 优化)——前提对齐+可复用资产+协调 
feat/mac-amodel-foundation 让廉价线也 agentic 化(ReAct+M3+插件库+九门,仍 LittleJS),部分推翻 tier2「廉价线=声明式壳天花板」前提。创始人 2026-06-23 裁:维持 tier2、两线分立(A-model=LittleJS 轻量经营 / tier2=Phaser 重表现富游戏),边界从「能力档」精确为「引擎/复杂度档」。计划新增「与 A-model 分支的关系」节集中承载:① 插件契约(scene-fsm/hud-ui/session-score/timer-scheduler 引擎无关零语义+sim-business 配方)复用→U6/能力包(最大协同,原漏接);② amodel-gen 循环范式参照→U2/U7;③ play.cdp.cjs 基线(SAA-mode+driven 感知 advisory 分级)刷新→U3/U6;④ 源项目契约维持独立+溯源→KTD7/U9;⑤ L1/L2/L3 术语消歧。brainstorm+plan Problem Frame 前提措辞对齐;HANDOFF 补 A-model 协调。子代理(opus)分析实证。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 05:51:52 +00:00
zizi
cf0695abd3 docs(plan): tier2 实现方案双审定稿——Codex 挂回落 Opus + R/U 漂移修正 
Codex 评审做完分析但终评迟迟未落盘=实质挂起,按铁律 Codex 挂回落 Opus 单评;提取 Codex 已暴露信号(R 编号/U 单元映射漂移)自核——修 U8 错误引用 R1(R1=pre-spike 不上 service,U8=B 门后上 service 即 R1 deferred 部分,非新需求)。Opus 3 P0 已于 a1539e9e 整改。双审定稿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:48:22 +00:00
zizi
a1539e9eb8 docs(plan): tier2 富游戏自治生成线实现方案(ce-plan)+Opus 评审整改 
ce-plan 产出 HOW 计划:Deep·10 单元(Phase A 详 7 到 A/B 证据门 / Phase B 纲要 3·B 门后投)。纳入 Opus 源码级对抗评审 3 P0:① U2 重定性——种子 validate/run/roles/prompt 是 LittleJS 专属、对 Phaser 完全反转、需重写≈net-new(非 fork+钉版本);② M3 成本取证补 RecordingChatModel(AnthropicChatModel) 变体(原只覆盖 OpenAI 路、A/B 门经济性断链);③ M3 thinking 下结构化 finish 降级、补 spike-grade 最小产物收尾(原误 gated 到 Phase B)。+ 环境切分逐单元(6c6g 骨架/Mac·mini-desktop 真跑)+ A 门两段与(先过 L1 再试玩)+ 闭环端到端独立验收门 + client_reuse 复用面纠偏(参数化 BASE_URL/key+NO_PROXY 副作用非包 chat)。Codex 评审后台跑中,delta 待并。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:39:37 +00:00
zizi
0b18321e70 docs(tier2): 方案对齐 AgentScope 2.0 官方文档实证(v2 离线镜像) 
读 agentscope-skill 新增的 v2 离线镜像(v2-deploy/v2-building-blocks)核方案:R1(create_app 需 Redis+message_bus+workspace_manager 重基建,起步本地 runner 对)/R3(内置 Workspace 无浏览器探针,接 CDP harness 对)/R8(AnthropicChatModel+thinking)/R13/R16 全站得住。回填三处实证:R13 阶段1 只读设计 worker = 原生 SubAgentTemplate(PermissionMode.EXPLORE)经 create_app 注册·非自建;KD3 标 v2 镜像+源码为集成权威·SKILL.md 正文 1.x(ReActAgent/MsgHub)勿照抄;Sources 补 v2 镜像引用。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 19:36:10 +00:00
zizi
4858e6cf3f docs(gen-engine): 《自治富游戏引擎》验收口径升三层校验(L1/L2/L3) 
旧'验收切两层(机器判/人判)'落后图说与实现详设一版,升到创始人三层校验:L1 硬约束+L2 设计符合=确定性归机器、L3 效果(M3 视觉软检)只评分不阻塞、好不好玩最终归人。无冲突对齐(不碰 gamedef/在飞会话);承 tier2 整体实现方案 R19。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 19:05:16 +00:00
zizi
4f2239ac57 docs(tier2): 整体实现方案 brainstorm——顺序软/判据硬·先集成再用 M3+mmx 迭代 
按图说整条架构组织的 tier2 实现主轴:先 AgentScope 集成+环境(单写起步·不上 Service)→ M3(代码/逻辑)+mmx(资产)连续迭代;0号 spike 软化为顺序、判据保持离散(A门 M3 证路软 / B门便宜档 n≥30 硬 / 退路树沿用实现详设数字触发线)。

纳入 Codex+Opus 双评审修订:R1 拆 pre/post-spike·种子 studio.py 2.0.1→2.0.3 迁移·CDP 对 Phaser 是重写且为 spike 前置阻断项·两道证据门+硬区分历史证据(Tier0/1 声明壳≠Phaser 富游戏自治)·mmx 最简形态·阈值引实现详设不复列·forbidden-import 升 pre-spike CI。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 19:05:16 +00:00
zizi
14c3ce4896 docs(recall): 清理历史回收过程留痕(删 12 清单+README,保判定记录) 
回收→判定→落档闭环已闭合,捡回项已写进现行设计档(带来源标记)。删 12 份回收
清单(第一轮 6 + 第二轮 6)+ README 总索引,git history 永久保留可随时翻;保留
创始人判定.md 作判定追溯权威。同步修 5 处指向被删清单的断链(前端 README 2 +
观测体系 3,改为文字引用 + 判定记录指针)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 18:28:21 +00:00
zizi
c9db9f7d36 docs(agent-specs): 域化重构收尾(保守批)——归档18档+清引用+_index瘦身 
确立 docs/architecture 为设计/现状唯一真源,agent-specs 仅留正在演进的设计。
回灌核对(review §2.4)后将 18 份「已迁入 architecture 或纯留痕」的设计/过程档
git mv 进 _archive(各带 SUPERSEDED tombstone 指新落点);生成域在飞设计链
(架构演进路线/生命周期范式/多session总账/任务普查)+ 3 待定档暂留,待二次收尾。

- 归档 18 档:SAA编排/引擎运行时/验收门/prompt治理(settled 底座,内容在子树)
  + WG1/设计裁决/OpenGame/开闸接线/固定架构review/传承演进/并行编排(已迁子树)
  + 完成度总账(FOLD 进需求模块映射)+ SAA-dossier残留 + 根因复盘/目录治理/
  深度重构plan/文档整理plan/planB-closeout(纯留痕)
- 清 7 处死引用:5 处 .agents/plans 旧 agent-specs 路径→新树 + 2 处 architecture
  树内回链(开闸接线/观测体系→验收门新树路径)
- 修 7 处归档连带死链(指已归档档→新树现行档 或 _archive 留痕)
- _index 补 2026-06-22 收尾 banner + 6 处指针改新树/_archive
- 死链门 check-deadlinks.sh = 0;收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md

待二次收尾(创始人选保守暂留):总体架构-review/固定架构-execution/产品开发路线图
(architecture 仍当其权威源回链,需先补迁详义)+ 对话素材v1(留痕,牵连保留档链接)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:18:31 +00:00
zizi
bb7c2baf7b docs(arch-atlas): 完整性补图16张——新人据图通读全系统 
9 opus 子代理新人视角审查→补 16 图(P0+P1+P2),目标=读图即懂整个系统:
- 00: 端到端跨域全链泳道(8泳道15步+钱流并联,旗舰)+ 系统上下文外部依赖边界(C4 L1)
- 01 B端客户旅程 / 02 逻辑→单体物理拓扑+契约跨域接缝+模块状态热力图 / 03 postMessage信封数据模型
- 04 核心对象生命周期状态机+两套身份 / 05 对话式创作闭环+生成任务UI闭环+feed交互
- 06 运营状态机合集+IP授权锁风来源+短信vs邀请码 / 07 端到端trace贯穿
5 新 SVG 经脚本核(良构/零溢出/脚注/转义)+ 11 Mermaid 配平;8 篇纯追加(既有图零改)。
子代理忠于源码/设计档纠偏:B端P-BIZ编号/feed第四互动=举报/BIZ五态按设计档真态/契约命名漂移诚实标。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:12:15 +00:00
zizi
1b3e375a68 docs(arch): 历史回收判定落档——约 60 条捡回项写进 21 份现行设计档 
按 _recall/创始人判定.md(创始人 2026-06-22 逐条判定),6 域并行 additive 落档,
每处标来源、人读散文、涉契约者给 contract-first 待落地清单:
- 产品:商业定位补竞品现任者/IP 关键人风险/增长冷启动/验收北极星;护城河话术补
  腰尾部 IP/真资产 reframe/自有吉祥物红线;Doc A 就地改格(P-PUB-01→P1、
  P-OPS-01→P0-lite,ACC 进 P0↔PUB 出 P0 保住 55 锚)+ P-CRT-02 注记每类 workflow
  生成/rig 留 premium 远期/补 P-id
- 前端:README §9 前端域承载(admin 审核台四页+观测三入口/C 端收益页溯源条 AIGC
  标识/43 口径引用/移动端适配/Debug 插件)
- 后端:数据模型 §7 待落地缺口(026 game_id/029 留存/030 锁风 JSON/031 信用台账/
  绘豆)、鉴权与权限 032 封号级联+018 短信防护、契约总览 Pact/Registry 远期
- 生成引擎:029 硬门 A-E 回填验收门+OpenGame对照/031 Phase 路线/033 创作期回灌/
  035 反锁死/036 harness 护城河/037 整图串行/001 对话式/002 透传/007 绘豆预算
- 运维:观测体系 §3.7 网关健康巡检、README §5/6/7 job 调度面/flag 纪律/数据可靠性
- 运营:渠道发行广告运行时红线/审核台事中召回/变现端到端资金切换护栏/变现与单位经济
  月增速+eCPM 口径统一+成本漏算+成本假设待测

contract-first 待落地项均标"勿当已建"。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 18:08:05 +00:00
lili
2c220c1302 docs(amodel): 3 层架构边界设计(评审版)+ §6.8 双审折叠 + D9=全注入 
创始人提 3 层模型(L1 工程骨架/L2 标准能力库/L3 游戏代码),目标=降低 LLM 必写量、只写游戏逻辑、根除 host-config wiring 错类(reading 'w')。

设计:3 opus fork 顺序设计 L1→L2→L3 边界(每层 边界=不做什么/标准/在哪里),综合成评审版。
双审(§6.8):Opus 对抗式 fork 全程(3 major)+ codex:codex-rescue(读全 api.d.ts+文档,捞 burst 幻觉;末步 stalled)。已折叠(§0):
- M3 强制三分→必写1(game-logic),core/render 推荐拆/可内联(真达成'省 LLM 活');
- M1 全11 registerOrder 是新组合两参考序冲突→实现期显式定义+L1控制门前置;
- Codex 捞 juice.burst 幻觉(我文档自犯)→手感范式以 api.d.ts 为准、禁臆造;
- minors 入 §9.1。
创始人裁:D9=全注入+实测(A)。

转实现:M1 控制门(全11插件一起 boot 验证)→ game.js 拆 wrapper+game-logic → host-config 注入全11 → harness/prompt/skill 对齐 → standalone+e2e 验证。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 10:51:52 -07:00
zizi
f05f7d8349 docs(recall): 创始人逐条判定 6 域历史回收清单收口(_recall/创始人判定.md) 
创始人 2026-06-22 逐个文档判完 6 域(产品战略/前端/后端数据契约/生成引擎/
运维基建/运营变现合规)的历史回收清单(第一轮 199 + 第二轮 43)。判定记录:
- 捡回约 60 条(含 P-FED-12 升 P0/P-OPS-01 升 P0-lite/P-PUB-01 降 P1 等验收契约调整)
- 形态定调:六资产=每类 workflow(dify)生成、玩法模板保持 P0、rig 留 premium 远期
- 新设计点:绘豆(类积分体系,取代旧 point_rate=10)
- 不捡:30/40 分层工作集、反同质化 feed 侧、种子创作者 BD、Pact/Schema Registry 等
- 待办:对外融资口径锁单值、staging 数据脱敏归属
落档(把捡回项写进对应设计档)待统一执行。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 17:38:30 +00:00
zizi
79f4d34fa9 docs(ip): 软著说明书 + 专利交底书 模型接入描述对齐现状·去AI味 
- 软著说明书(§2.2/§3/§6) + 专利交底书(§5.1 图1)：模型接入由「唯一 OpenAI 兼容出口 / 绝不直连厂商 SDK」改为「new-api 网关统一端点·协议不锁(OpenAI 兼容 / 厂商原生均经网关接入)」
- 只陈述当前实现现状、无变更过程措辞、去 AI 味
- 软著尚未提交，直接 commit(创始人确认)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 16:01:59 +00:00
zizi
b52afc5ea2 docs(arch-atlas): 按领域拆成 00-07 编号文档(全放顶层)——创始人反馈全量主档太大 
结构经三次反馈收敛终态:导览式多文件(跨子目录不渲染)→ 合并一篇(太大 1721 行)→
拆 8 篇编号文档都放 docs/architecture 顶层:
- 00-系统总览图说.md = 总图(7 系统级图)+ 目录(链 01-07)+ 通用图例 + 按角色路径
- 01-产品…07-运维图说.md = 每域一篇,各含该域全部图 + 讲解(散文逐字保留)
顶层文档引子目录 assets(运维/assets/xx.svg)单向下引、全图真渲染;SVG/各域README不动。
复验:8 篇共 35 图嵌入零缺失、36 Mermaid 配平、00 链 7 域有效。
配方/记忆/计划/README索引同步终态(铁律:图集文档放顶层引子目录assets,别让子目录文档跨引另一子目录图)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:33:46 +00:00
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
lili
6e388d9bbb feat(amodel-gen): agentic A-model 生成 harness(ReAct+M3)+ skill + 四层设计 
spike 验证通过:M3 经 new-api(openai+tools)agentic 自闭环产出可玩 A-model 游戏。

- harness game-runtime/tools/amodel-gen/(tools/play/m3/prompt/gen.mjs,零三方依赖):
  scaffold(clone _template)→ ReAct(read/write/list/check/build/done;done 门=check+build 绿;
  compaction + loop-detection)→ 循环外 play(headless Chrome boot+截图+交互 = 能跑能玩)。
- 3/3 玩法干净自闭环实证:打地鼠 / 陨石躲避 / 反应点击(13-22 步,175-378K token,play PASS)。
- skill .agents/skills/agentic-amodel-generation.md(链路/配方/8 坑/M3 实证/主流定性)+ README/AGENTS 索引同步。
- 设计 docs/agent-specs/2026-06-21-agentic-amodel-generation-design.md(§0 整链路 current→new + 四层 + §0.8 主流对照;draft 待 §6.8 双评审)。

取代旧 gamedef/factory 单次产线(A-model 生产形态);production 删 gamedef 待双评审(D1=A 无退路)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 18:50:38 -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