70 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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