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

28 Commits

Author SHA1 Message Date
lili
c4e8df15b2 docs(config/sot): 阶段二收口涟漪回写(上级档§7表行1-4十三处+§6收口标记/阶段二档status=已实施+六步落地标注+§8执行终局三口径修正/全档/sessions复数)+ 运行时SoT阶段二改真 + W-DSGN文本债四条(evalflow指git存档/消费面三态改真/T-AGC-09随gamedef历史化/验收门SAA承接项冻结)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 11:56:37 -07:00
lili
3495470d89 feat(quality): ⑨升通用底座第12条「核心操作非无脑」落 RICHNESS_CHECKLIST(L2 6→7,前11条一字不动,prompt 计数改动态 len 同源防漂)+ 测试分母随升;图说预算两段式「待实施/CLI仍hard」翻已落实态(cheap_budget 同源工厂+真M3实证) (质量SoT §4 规范一 12条口径,ba55508e 配套;金标复验=C波)
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:51:36 -07:00
lili
6ef0b5d75e docs(gen-engine): 运行时图说 doc-sync 回写实现对账 12 项(W-DSGN) 
以 2026-07-03《生成引擎实现与图说一致性对账》§5 八条 + 重推演 Δ6/Δ9① +
预算两段式裁决为据,把掉队约两周的运行时图说追回现实,写前逐条重核工作树代码。

图说本体(主对象):
- 配置口径反转:ADR-4/A13/§5.2/§5.8/对标表/五列/§二补④ 从「Langfuse 式热取 + GitOps
  四闸」改为「yudao 配置中心版本化(MySQL 版本行)⊕ Nacos 下发 ⊕ AgentScope per-POST
  热重载」,阶段〇+一① 已代码落地;Langfuse 式退历史备选、原表保留作决策留痕。
- §4.2 收敛环:前瞻「go(留观微调)」改为真跑 conditional 结论,补 agent 层 win-balance
  瓶颈(约 1-2/5 thrash)、网关无强档记 conditional no-go、F-1 反馈补厚已落。
- §4.1 便宜档:补运行时载体已 Python 化(cheap-worker 双入口 CLI+Service、复用 tier2
  worker 包;Node 拆两半:gen.mjs 退对照、tools.mjs/serve-and-play.sh/play.cdp.cjs
  九门执行层 shell-out 仍活);「十一插件」核正为十二(8 基元+4 编排)。
- §5.3 续修:回同续修原语迁入 on_reasoning 的 RepairMiddleware(单 POST 内 finish 点
  续修=生产主路,外层 resume 为本地 runner 并存 fallback);预算两段式(软停线 ¥10/¥50
  + 硬地板 ×1.5=¥15/¥75、与轮数/墙钟任一先到即停),§5.2/§5.7 同步。
- §5.1 checkpoint 降准(每外层 resume 落本地 JSON;Redis durable 已编码未真跑);服务壳
  已编码真跑未验证、阶段一 Agent Team 已提前落地默认开启。
- §5.4 删 DockerWorkspace 前置阻断句(06-28 已裁 in-process);A2.5 表行改现·部分;
  补引质量 canonical(D11 权重管辖已移交、四层塔与三层校验共用 L1-L3 但异轴防混)。
- §一 Δ6：第一原则改述为「接缝按变更频率设」(模型月换>品类周扩>引擎季增>框架可能永不换;
  协议脊柱与 judge 独立两资产保留;框架适配验证明确为远期非投入项)。
- §三 Δ9①：A8–A13 加「单实现期不冻、第二消费者出现才抬升」注记(不删行);C5/C6 判分
  闭环两契约入表(PlaySpec 考卷/VerdictFeedback 判卷反馈,已立 schema+校验器、生产接线
  在途,指 contracts/play-loop/)。
- A11(工单第 10 条)复核:图说 §六已是完整 A11 章节，无需重复补——系对账/工单误判。

配套一处:contracts/trace/README.md 廉价线口径 SAA→cheap-worker(便宜档已 Python 化复用
tier2 TraceAdapter/schema,saa-trace-event schema 保留作 SAA 远期轨立位)。
代码触点一处:tier2 agent_loop/studio.py 头注释纠正（「不再外层 repair」与同文件外层
resume 相左）。
收尾:两份配置设计档 sot-impact「收口时回写」翻「已回写」；plan① §11 TODO ⑤⑥ 勾状态。

docs-gate 七检全绿；studio.py 语法校验通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:10:56 -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
9ac0e860d1 docs(gen-engine): A11 切片三收口蒸馏 —— 回写 plan① + 设计面入运行时 SoT §六 
收口 TODO①②(创始人 2026-06-29):
- 回写 plan① 切片三:确定性覆写定性精化(执行仍零 LLM、但 A11 经判意图两段式到达、
  非直接覆写;落点对齐工程规范性)+ 后续细化标记已执行(M1-M5 代码完成、6 提交)
- A11 设计面蒸馏入运行时 SoT:新增 §六 调整回路(试玩后纠错)——两段式判意图/工程规范性改一处/
  两档执行/三断言,散文设计面(兑现 plan① TODO⑥ "A11 无 §5.x facet 专节");§三 A11 行状态更新为
  便宜档代码完成
- .agents/knowledge/tech-decisions §1.2 A11 调整回路简洁蒸馏(指向 §六 + 细化 plan)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 03:08:06 -07:00
lili
8b491d1330 fix(九门): latch 终态口径修法 — 命名同义 + 限时类有进展降 advisory 
便宜档当前 HEAD 九门真实基线诊断(n=5 收敛环):harness 健康、3/5 真可玩;
0/5 主因 = latch 终态词表 bug(只认 gameover、漏 over/win/lose)+ 限时类
driver 玩不到终局。按创始人 2026-06-25 口径修 play.cdp.cjs:
- latch 认 gameover/over/win/lose 同义(对齐 driver 家族 runTapTargets)
- 未达终态但有真进展的限时/无快速失败态类 → latch 降 advisory(不致命),
  无进展仍致命(不放水)
- 验证:base1-5 重跑 0/5→3/5(base1/4/5 真可玩转绿,base2/3 卡 menu 无进展仍正确挂)

SoT① §5.4 同步 latch 口径演进(文档↔代码兑现)。
附:docs/内网凭据与端点.md 登记 glm-5.2(opus 高级档/512K,作复杂档证路高级档)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 22:26:37 -07:00
lili
0000ade12d docs(svg): 全域 SVG reframe doc-sync — 配图两线→三档 + 脚注死链 repoint 
- 结构重画:03-两条生成轨边界 / 07-全局两线与tier体系(两泳道→三档统一 AgentScope、引擎随复杂度选 LittleJS/Phaser)。
- 文字/framing(全域 SVG):两线→三档、SAA 廉价线→便宜档、AgentScope premium 独立轨→统一框架、超休闲档→轻量、tier2 远期/待 spike→accept(实线)。
- 脚注死链:自治富游戏引擎.md / agentic集成架构.md / tier2实现详设.md / tier2四层工程架构.md(均已并入 SoT)→ agentic运行时架构图说.md;全域 SVG 零死链。
- 07-泳道 tier2 框 紫虚线→实线现行(accept、核心已落)。
- MD doc-sync:删 4 处"待重绘 mini-desktop"注(图已重画)、①③ §0 / README / SoT 注脚去 mini-desktop(全归本机)。
- atlas house-style 复验:良构 / 界内 / 脚注全角「：」/ 无裸& 全绿;t2-E-04「两线分立(06-23)」已加注 06-25 reframe 取代之、作留痕。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 13:07:49 -07:00
lili
f5429b1ada docs(生成引擎): §5.2 配置发布边界 — 重要配置走 yudao 审批=受治理发版(后期阶段) 
创始人 2026-06-25:质量/安全、关键 agent、关键玩法模板等重要配置变更走配置发布流程
审批,通过后发布——即使不重新部署服务代码,因影响生产稳定/质量,本质是受治理的「发版」。
复用 game-cloud 现成 yudao 能力(huijing-module-bpm 工作流 + huijing-module-infra 配置管理),
不自研(build-vs-buy 现货优先),后期阶段做。非关键配置仍即时/热更、零服务发版。
落 §5.2 管理面 + ADR-4 write 路细化 + §配置三类「不发版」口径澄清。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:53:29 -07:00
lili
e3a0c3c661 docs(生成引擎): SoT① reframe 新模型 — 框架收敛 AgentScope·三档按 AI 深度·两引擎实现 
把生成运行时 SoT 校准到 2026-06-25 创始人核心 reframe:游戏生成统一由
AgentScope 一套框架编排,按 AI 参与深度分三档(Tier0/1/2);引擎按表现复杂度
选(轻-中档 LittleJS、最富档 Phaser),引擎是实现、不是分档轴;SAA/dify 降为
最低优先级、留作后期"验证框架可插拔"的适配目标,不再是 co-primary 活线。

扫尾把残留旧框架口径(两条线/两线/两实例/富游戏线/SAA 作 co-primary)校准:
§四标题→生成实例(三档·两引擎)、L66 ASCII 图框架行、§二补②可移植性收益、
§5.2/5.5/5.6/5.7/5.8 各 facet"两条线→各档/两引擎"、SAA 能力面框架定位改远期
适配、trace 契约改多框架 adapter。引擎技术内容(engineBundle/Phaser src/工程/
九门 harness/CDP 探针)、gamedef 废弃史、主会话所写段落原样保留;SAA 裸图技术
描述保留,只改其框架定位。

验证:框架线标签词散文清零(仅余 svg 文件名);品牌门 造梦AI=0;死链门=0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 09:36:36 -07:00
lili
a2a8266416 docs(生成引擎): SoT① 36 张 SVG 改渲染嵌入 ![](…)(原反引号路径不渲染) 
§四/§五 各 facet 末尾的 SVG 引用原写成 `assets/x.svg` 反引号路径(只显示路径、不渲染);
按 md 图片嵌入式 ![图 X·描述](assets/x.svg) 逐张转,每图独立成块。36 张全部对应 assets/
真实文件。图本身仍是 spike 前视角(§5 开头 caveat 已注明,svg 重绘待出图管线)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 07:02:39 -07:00
lili
d4eb4b1197 docs(生成引擎): SoT① 收口定稿 — §二补二 成熟度五列 + §二补三 6 条 build-vs-buy ADR + §三 定级冻结 
§6.8「采纳但修」收口:补标准成熟度五列(操作化 §二补①)+ 6 条 build-vs-buy ADR 决策矩阵
(每条 ≥3 具名候选 + 排除理由)。纠 ADR-5/6:agentscope-runtime 独立仓已归档、能力并入
agentscope 2.0.2(Workspace/app/event),改判走 2.0.2 内置件——沙箱=2.0.2 Workspace(工具
沙箱非 CDP)+ tier2 自家 CDP harness;扩容=2.0.2 Agent Service,跨机 durable-exec future-state。
L247 同步。(c)选型 spike /(e)n=5 收敛环留作执行 plan、不在文档完成范围。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 03:25:19 -07:00
lili
452d13d247 docs(生成引擎): SoT① §4.1 — gamedef=已废错误路线,廉价线现行=A-model 写真 src/ 
创始人:gamedef 已删除、失效、是错误路线。SoT① 实例一(廉价线)reframe:
- 范式:便宜模型直接写真 src/(A-model,2026-06-21 起)+ L2 插件 + 九门,取代已废 gamedef JSON
- 护城河 = 九门 harness(引擎无关、判能不能玩不判怎么写,切到 A-model 一行没动)
- 废弃路线 = gameDefinition(声明式数据壳+自由JS核+色块天花板;2026-06-20 裁决揭穿、
  2026-06-21 判废)——不再「坚持它做 Tier0」,整条路被 A-model 取代
- §5.6 左支装载:「声明式结构化源」改「LittleJS engineBundle 装载(A-model 真 src/ 构建)」
门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:59:55 -07:00
lili
1cd3f01983 docs(生成引擎): SoT① 验证方式 n≥30→n=5 收敛环(创始人指令) 
创始人:「n>30 这个设计不希望再看到了。n=5,有错误再追加一次 5」。
SoT① 6 处 n≥30 统计批跑口径改成收敛环:并发跑 5、有错(>1)读日志/分析/修复、再并发
追加一次 5、收敛即 go,不做 n≥30 统计批跑(frontmatter/§4.2/§5 intro/§5.3/§二补⑥e)。
§4.2 原 n≥30 与 n=5 收敛环并存的自相矛盾一并消除。批跑底座件保留(设 n=5)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:34:43 -07:00
lili
441304726b docs(生成引擎): 收尾过时口径 — SoT① svg-caveat + 退役 76KB design(影子 SoT) 
- SoT① §5 引用处加 svg-caveat:25 张 tier2 svg 是 0号 spike 前视角(虚线/「整图状态=建·
  待 spike」是当时标记),现状以各面散文「现/建」为准、不以图虚线为准(svg 重绘待出图管线)
  ——一句覆盖全部,不逐张改(避免 caption 说已落、图画虚线的自相矛盾)
- 退役 76KB design(2026-06-23-接口协议层与可插拔模块-design.md):内容已并入 SoT① §三
  (adapter A1–A13+B类)+§二补(§7 14问题)+003 附段,是同命题影子 SoT,零入链、干净退役;
  完成原整理 plan 漏做的一步(保持同命题唯一设计文档)。其 line 40/42 tier2「待 spike」口径随退役清零。

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:24:22 -07:00
lili
1b97c55ca0 docs(生成引擎): tier2 doc-sync — SoT① §4.2/§5.x 按 HANDOFF 回写真相(§6.8 #1 收口) 
§6.8 评审 #1 阻塞:SoT① 忠实搬运 spike 前源档、把已落 accept 的 tier2 写成「待 spike」。
按 tier2/HANDOFF.md(2026-06-24)+ 内网凭据 P4 回写真相:
- §4.2 headline:翻成「核心已落 + 0号 spike feie-005 accept(n=1 机制验证,n≥30 统计待跑)
  + 服务化@8200,判断=go(留观微调)」
- §5.1-5.8 八面「现/建」全部按 HANDOFF 翻新(已落:Phaser 探针+九门+富游戏三门、
  四道收敛契约机器门、mmx、M3 接法、Tier2TraceMiddleware/成本折¥、L3软检、n≥30底座;
  待:n≥30统计/阶段1 Agent Team/控制面后端/feed第二装载)
- 纠 2 处设计叙述错(spike 实测推翻):① 官方 ReplyBudgetControlMiddleware 2.0.2 不存在
  →自建 on_system_prompt+硬熔断;② 纯内部多轮 ReAct 过早放弃→有界外层 resume(wg1范式回归)
- frontmatter status + §二补⑥(a) 标 doc-sync 已做;003 加「执行现状」块、修「待 spike」全局口径

门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 00:06:38 -07:00
lili
e7d236197b docs(生成引擎): §6.8 双评审修正 — adopt-standards 提案「采纳但修」 
Codex(web 源验)+ Opus(repo 验真)双评审,总判一致采纳但修。文档内修发现项:
- SoT① §二:修 4 处平实错(「全收进 AAIF」归属纠正/可移植「白得」降为分层/
  K-槽非反模式/microVM→SandboxDriver,后两条消 §6.10 兑现门反例)+ 表格
  A2A cancel·MCP Tasks experimental·Langfuse read-write 三单元精修
- SoT① §二补:新增评审修正块(成熟度分层/可移植分层/扩容沙箱降 future-state+
  ≥3候选选型/慢门 job-poll/cancel contract/TraceLedger/自研域清单/收口 TODO)
- SoT① frontmatter:status 改 tier2 已落 accept(待 doc-sync)+ 双评审已过
- ② prompt治理 §5:热取分 read/write(运行时只拉已批准版本,write 走 GitOps)
- 003 附段:双评审结论(doc-sync 前置最高优先/5待决改 ADR/成熟度分层/沙箱扩容拆选型)

最高优先收口 TODO:tier2「待 spike」doc-sync 回写。门:全仓死链 0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 23:49:48 -07:00
lili
fe6a2b4d98 docs(生成引擎): SoT① Step3 — ②prompt治理改热取 + ③验收门收敛 + ④数据飞轮 canonical 
- ② prompt治理:加 canonical frontmatter;§5 新增"目标态:采 Langfuse 式运行时热取"
  (按 id@label 运行时拉取+缓存TTL+后台刷新+回落,替构建期 maven 快照反模式;
  四道闸治理纪律不变;对齐 SoT① A13)
- ③ 验收门:验收门-W-G1.md → 验收门.md(git mv);加 canonical frontmatter
  (topic=对外开闸放行);修 3 处改名断链(生成引擎图说/OpenGame对照/WG1基准)
- ④ 数据飞轮:加 canonical frontmatter(保留)
- SoT① §5.4 指针校准:验收门=开闸放行6门(坐九门之上),九门护城河命题即在 §5.4+A5
- canonical 唯一性:4 topic 各一份,预检通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:43:47 -07:00
lili
bcde9acee2 docs(生成引擎): SoT① Step4 — 退役 17 份被并文档(tombstone 指针)+ 图引用归位 
16 份图说/详设 + 设计合理性裁决,内容已并入 SoT①,替换为 tombstone 指针
(保留路径=保入链,各指向 SoT① 对应章节;原文存 git 历史):
- 并入①:agentic集成架构/自治富游戏引擎/tier2四层工程架构/tier2实现详设/
  tier2细节图说 A-F·H/SAA编排/SAA能力API-dossier/开闸接线/引擎与运行时/固定游戏架构
- 结论并入①后退役:设计合理性裁决
图引用归位:07全局两线→§四、09廉价线端到端→§4.1、08长生命周期→§5.6、
00-06 tier2总览→§4.2(消孤儿);修 typo gamefdef→gamedef。
SoT① 现引用 36 张 svg、全部存在、无 dead 链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:36:27 -07:00
lili
2aa2ffec2f docs(生成引擎): SoT① 补 开闸接线覆盖(§4.1 实例一创作入口开闸) 
一句话直接驱动 + templateId 可选缺省 generic + 玩法模板=品类框架,
补进实例一,使 16 份待并入文档全部被 SoT① 覆盖,可退役。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:33:24 -07:00
lili
27584a1fdb docs(生成引擎): SoT① Step2 — 8 facet 并入(运行时形态/控制面/ReAct/校验九门/能力面/源项目/观测/四层) 
经 4 个非重叠抽取代理浓缩 ~2600 行源文档,亲笔写成散文并入:
- 5.1 运行时形态:Agent Service/session三路/Agent非常驻+AgentState/Workspace双轴/Middleware洋葱
- 5.2 控制面与配置热取:四组件/采Langfuse热取替构建期快照/热改vs GitOps/三层预算强制/管理面三phase
- 5.3 单写ReAct循环:一轮闭环/多轮进Agent内/四熔断+硬闸自建/M3原生接法/承A-model
- 5.4 三层校验与九门:L1/L2/L3+九门逐门+富游戏三门(联动/经济/latch)+advisory分级+自产driver三层隔离
- 5.5 能力面:九工具三类/引擎能力包五件套/prompt两阶段/A-model四插件复用/SAA能力
- 5.6 源项目契约与装载:七要素四组/独立schema不复用/第二装载分支/finish共用schema
- 5.7 观测与成本:统一trace契约(对称核心+扩展段)/采OTel GenAI/成本钉new-api quota
- 5.8 四层职责:职责视角叠真实结构/复用边界二维/六项该删改官方/三类配置

治理:零 file:line/hash/实现代码;九门逐门归本文运行时视角,验收门完整命题指向 ③。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 22:27:39 -07:00
lili
aad4d8c16c docs(生成引擎): SoT① 骨架 — agentic 运行时架构统一 SoT(采标准+adapter+两实例) 
收敛 16 份图说/详设/接口协议草案为单一 SoT 第一步:写框架。
- 命题:可插拔 agent 平台(adapter + 框架可换 + 两块自研护城河)
- 采标准对标:A1/A2→A2A、A2.5→OTel、A7→MCP、skill→SKILL.md、
  沙箱→microVM、扩容→durable-execution、A13→Langfuse 热取;
  自研只剩 checkpoint/续跑 + 确定性验收门
- adapter 协议层:A1–A13 固定协议目录(数据模型/接口,剥 file:line/hash)
  + B 类可插拔模块(引擎包/探针/框架适配器/渠道/资产/模板/合规原子)
- 两实例:SAA·LittleJS 廉价线(Tier0/1,含裁决结论)/ AgentScope·Phaser 富游戏(tier2)
- 八面 facet:Step 2 待并入区,各给 scope + 来源

治理:零实现代码/行号/hash 进文档;采标准方向为提案待 §6.8 双评审。

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