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>

docs/brainstorms/2026-06-22-tier2-整体实现方案-requirements.md

@@ -24,7 +24,7 @@ tier2 这条线的"要造什么"已经想透并经 2026-06-20 对抗审查拍板
 
 - **起步只跑单写实现（阶段 2），工作室 Agent Team（阶段 1）后置；这是范围裁剪、不是永久颠倒。** 早期迭代先把单个写者 agent 的 ReAct 多轮循环 + L1 校验跑通，最快拿到"M3+mmx 能不能产出过门的 mini-肥鹅"这个真信号。生产态正式流程仍是阶段 1 工作室设计 → 阶段 2 单写实现；起步只跑阶段 2，是 spike / 早期证路对范围的裁剪，证据出来后恢复阶段 1。
 
-- **集成方法论 = 用 agentscope-skill 逐条源码核对"复用 vs 自建"，并含一项版本迁移。** 集成阶段不靠记忆里的 API 印象动手，而是用 `.claude/skills/agentscope-skill`：读已 clone 的源码（`/root/oss/agentscope`，2.0.3）、查真实签名、浏览 `examples/` 的装配样例。要特别认一项工作：种子 `studio.py` 现依赖 `agentscope==2.0.1`，fork 起步包含一项从 2.0.1 迁到 2.0.3 的 API 适配（参照四层档 §验证状态已列的纠偏清单），不是纯拷贝放开 max_iters 就能跑。
+- **集成方法论 = 用 agentscope-skill 逐条源码核对"复用 vs 自建"，并含一项版本迁移。** 集成阶段不靠记忆里的 API 印象动手，而是用 `.claude/skills/agentscope-skill`：读已 clone 的源码（`/root/oss/agentscope`，2.0.3）、查真实签名、浏览 `examples/` 的装配样例。集成的离线权威 = 该 skill 现含的 AgentScope 2.0 官方文档镜像（`references/v2-building-blocks` / `v2-deploy` / `studio-rest-api`，snapshot 2026-06-22）+ 源码；**注意该 skill 的 SKILL.md 正文示例仍是 1.x（`ReActAgent` / `MsgHub`），2.0.3 已无/已删，别照抄——v2 镜像 + 源码才是权威**。还要特别认一项工作：种子 `studio.py` 现依赖 `agentscope==2.0.1`，fork 起步包含一项从 2.0.1 迁到 2.0.3 的 API 适配（参照四层档 §验证状态已列的纠偏清单），不是纯拷贝放开 max_iters 就能跑。
 
 - **沙箱用自带 Workspace；浏览器探针对 Phaser 是重写、且是 spike 前置阻断项。** 2.0.3 自带 `Workspace`（`Local/Docker/E2B`），代码、构建、shell 隔离开箱即用，不是阻断项。L1 确定性门要的"浏览器真跑 + 低层探针"不在内置里，接仓内现成 CDP harness（`play.cdp.cjs`）——但其探针硬编码 LittleJS 专属选择器与帧源，对 Phaser 是**重写适配层、不是参数化**；这条路径可行性（含 BrowserSandbox 是否够用、不够则自建薄沙箱）是属主标记的 **spike 前置阻断项**，须在迭代开跑前出结论。
 
@@ -71,7 +71,7 @@ flowchart TB
 
 **重机器 · B 门通过后才投**
 
-- R13. 阶段 1 工作室（Agent Team 星形）：leader + `AgentCreate` 设计 worker + `TeamSay` 收敛，设计 worker 只读（`PermissionMode.EXPLORE`）已有工程代码与工程内设计文档、与用户跨 session 多轮对话，设计结论写成工程内文档供下次迭代只读。
+- R13. 阶段 1 工作室（Agent Team 星形）：leader + `AgentCreate` 设计 worker + `TeamSay` 收敛，设计 worker 只读（`PermissionMode.EXPLORE`）已有工程代码与工程内设计文档、与用户跨 session 多轮对话，设计结论写成工程内文档供下次迭代只读。只读设计 worker 是 AgentScope **原生机制**（非自建）：经 `create_app(sub_agent_templates=...)` 注册 `SubAgentTemplate(permission_context=PermissionMode.EXPLORE)`，leader 的 `AgentCreate` 按 `subagent_type` 拉起只读 worker——正是官方为"read-only explorer vs full-access coder"设计的能力边界。
 - R14. tier2 自己的源项目契约（类型标记 / 文件树 manifest / 入口 / 构建 profile / 依赖锁 / 内容哈希 / 落库寻址七要素）与第二装载分支，与 Tier0/1 的 ECS-lite 装载契约解耦并存、绝不回归现有产线；finish 工具的参数 schema 与该契约共用一份定义。
 - R15. 完整配置外置（prompt / 编排 / 模型可配不发版）认领并引用《生成主线架构演进路线》（线A）阶段 2-3，不另立分期。
 - R16. 接入共用控制面：tier2 入口接 D12 运行治理门（现仅覆盖 SAA、需补 tier2 入口与预算扣减 / 并发释放 / 失败补偿），轨迹按统一 trace 契约（`contracts/trace/` additive 立位）写入，观测走官方 `TracingMiddleware`→OTel→Studio。
@@ -125,6 +125,6 @@ flowchart TB
 ## Sources / Research
 
 - 属主设计档：`docs/architecture/架构/生成引擎/` 下《自治富游戏引擎》《tier2 四层工程架构》《tier2 实现详设》《agentic 集成架构》《agentic 运行时架构图说》（含 9 图）与《生成引擎图说》总入口。
-- 框架实证：AgentScope 2.0.3 源码 `/root/oss/agentscope`；速查 `.agents/knowledge/agentscope-2.0.3-facts.md`；集成方法论 `.claude/skills/agentscope-skill`。仓内实证：种子依赖 `wg1/gen-worker/requirements-l2.txt`（`agentscope==2.0.1`）、`wg1/gen-worker/worker/agent_loop/studio.py:159`（`ReActConfig(max_iters=1)`）、CDP 探针 `play.cdp.cjs`（LittleJS 专属硬编码）。
+- 框架实证：AgentScope 2.0.3 源码 `/root/oss/agentscope`；速查 `.agents/knowledge/agentscope-2.0.3-facts.md`；集成方法论 + v2 离线权威 `.claude/skills/agentscope-skill`（含 AgentScope 2.0 官方文档镜像 `references/v2-*.md` + `studio-rest-api.md`，snapshot 2026-06-22；SKILL.md 正文示例为 1.x、勿照抄）。仓内实证：种子依赖 `wg1/gen-worker/requirements-l2.txt`（`agentscope==2.0.1`）、`wg1/gen-worker/worker/agent_loop/studio.py:159`（`ReActConfig(max_iters=1)`）、CDP 探针 `play.cdp.cjs`（LittleJS 专属硬编码）。
 - 廉价线对照：`引擎与运行时.md`（装载契约 / CDP harness 门坑）、`固定游戏架构.md`、`设计合理性裁决.md`（tier2 另起一轨的判决理由）。
 - 关键记忆：`saa-agentic-infra-decision`、`m3-agentic-anthropic-protocol`、`generation-lifecycle-project-model`、`true-structured-foundation-proven`（Tier0/1 声明式数据壳已证、与 tier2 硬区分）、`mmx-asset-pipeline`、`tiered-engine-cocos-decision`。