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

566 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
zizi
a0ccb6dd95 Merge 'docs/interface-protocol-design' → dev/2.0.0: 接口协议层与可插拔模块设计(opus 终审通过·无 P0) 
固定契约 vs 可换实现的接口协议层(A1-A13 + B 可插拔),换引擎/框架=接适配器。两轮 workflow 设计+对抗评审 + 主会话纠漂移 + opus 子代理终审整改。§7 14 项开放问题待创始人定。
 2026-06-23 18:40:29 +00: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
b1a12462cf Merge 'chore/agentscope-2.0.2' → dev/2.0.0: agentscope 版本号订正 2.0.3→2.0.2(2.0.3 未发布) 2026-06-23 18:29:06 +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
9929940447 docs(knowledge): agentscope facts 版本更正 2.0.3→2.0.2 + 改名 agentscope-2.0-facts + 补编排/沙箱/部署事实 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 18:03:29 +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
zizi
fd304a1ed1 Merge 'docs/tier2-diagrams-AH' → dev/2.0.0: tier2 扩展五族细图(A/F/G/B/H)+ detail-图说配方蒸馏 
- 扩展五族 19 图 + 5 族图说:A 运行时形态 / F 源项目契约·装载 / G spike runbook / B 控制管理面 / H 观测成本
- 至此 tier2 细节图说全 8 族 32 图齐(核心 D/E/C 13 图已在 6865b88a)
- 每张为总览(agentic运行时架构图说.md 图 1-8)的逐项放大;对抗验证 + 主会话复验全过
- detail-图说 扩展配方 + verify 脚注冒号盲区 蒸馏回 .agents/skills/architecture-diagram-atlas.md
- advisory 跨分支仍标「接」(A-model 未合并 dev/2.0.0)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 10:41:51 +00:00
zizi
4833815ac4 docs(skills): 蒸馏 detail-图说 扩展配方 + verify_svg.py 脚注冒号盲区 → 架构图集 skill 
tier2 8 族 32 图实证的可复用产出写回 .agents:
- detail-图说 扩展配方(draw→对抗验证→族汇编 pipeline / deepen 不 duplicate / 复验脚本放 /tmp / 看图入口回链)
- 复验脚本盲区:脚注半角 vs 全角冒号查不出,主会话须另跑 sweep(本轮补逮 6 张)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 10:39:58 +00: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
6865b88af7 Merge 'docs/tier2-plan' → dev/2.0.0: tier2 实现计划 + 项目初始化 + 核心三族细图图说 
- HOW 实现计划(双审定稿)+ 项目初始化骨架(锁 agentscope 2.0.3 + forbidden-import CI + 交接 brief)
- 接住 A-model 分支(可复用资产对账 + 协调纪律)
- 核心三族细颗粒图说:D 三层校验(5)/ E 能力面(4)/ C 单写循环(4)=13 图 + 3 族图说;对抗验证 + 机器复验全过
- advisory 跨分支标「接」(A-model 未合并 dev/2.0.0,合并后 D2/D4 脚注对账)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 09:17: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
4d694dfa17 feat(tier2): 项目初始化骨架(6c6g)——模块边界+依赖锁2.0.3+forbidden-import CI+交接brief 
在当前设备(6c6g)完成 tier2 富游戏自治生成线项目初始化(plan-stable 部分):tier2/.agent(模块边界/红线/TODO)、README、gen-worker/requirements.txt(独立锁 agentscope==2.0.3)、ci/check-forbidden-import.sh(运行期零碰 SAA 守门·已验通过)、HANDOFF.md(交接 Mac brief)。实现+运行调优转交 Mac/mini-desktop(真跑需 chrome/headless,6c6g 禁)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:48:22 +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
56f2da2a8e Merge 'docs/tier2-impl-plan' → dev/2.0.0: tier2 整体实现方案 + 自治富游戏引擎三层口径 + AgentScope v2 实证 
整体实现方案 brainstorm(顺序软/判据硬·双评审修订) / 自治富游戏引擎验收升三层校验 / 方案对齐 v2 官方文档实证。3 commits 无冲突合入。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 19:44:24 +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
bacb2daaa6 chore(skills): 同步 agentscope-skill 完整版到 dev/2.0.0 主线 
用 feat 完整版替换 dev 旧版:references 补 studio-rest-api + v2-overview/v2-building-blocks/v2-deploy(docs.agentscope.io 2026-06-22 快照),SKILL.md 补索引。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 19:24:18 +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
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
bf461e723a docs(knowledge): README knowledge 表挂 agentscope-2.0.3-facts 索引 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:16:24 +00:00
zizi
b6563df434 docs(knowledge): 蒸馏 AgentScope 2.0.3 真实架构速查 + README 索引 
- 新增 .agents/knowledge/agentscope-2.0.3-facts.md: 3 路源码实证的 2.0.3 真实 API 速查(对象关系/API纠偏/服务化/Agent Team/模型记忆熔断观测/官方没有/tier2接法+reuse) — 免下次重查源码
- README knowledge 表挂索引

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:14:13 +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
c7e37a739b docs(skills): 蒸馏架构图集生成配方(§7 知识沉淀)——第一期实证 
配方含 house style 规格/图说文档结构/三范式纪律(单源·防漂移·状态双层)/按域并行编排/
复验脚本/双评审揪出的六坑/分两期+跨session协调;供第二期(生成引擎子树)、在飞 session、
后续加域复用。.agents/README.md 索引同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 12:38:05 +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
zizi
7a68530f67 chore(skills): 装入 agentscope-skill 知识包(项目本地 .claude/skills) 
AgentScope(Python)库开发知识包,对应 long-term premium agentic 轨
(参 saa-agentic-infra-decision);short-term 主线仍走 SAA(Java)。
含 SKILL.md + references(部署/多agent编排) + scripts(查模块签名/PyPI版本)。
仅装项目本地作用域;settings.local.json 与 .claude/worktrees 不入库。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 04:01:35 +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