clowder-labs · mindfn · Mar 11, 2026 · Mar 10, 2026
@@ -1,6 +1,6 @@
 # AgentScope 迁移 Domain 执行清单（详细设计输入版：依赖/重要度/复杂度拆分）
 
-> 更新日期：2026-03-04  
+> 更新日期：2026-03-10
 > 输入基线：  
 > - `docs/design/archive/agentscope-migration-framework-gaps.md`  
 > - `examples/10-agentscope-compat-single-agent/DESIGN.md`  
@@ -37,9 +37,9 @@
 | CLM-20260309-D2CUT | D2 transport cutover follow-up | lang | done | 2026-03-09 | 2026-03-12 | `archive/2026-03-09-transport-typed-payload-cutover` | `CLM-20260304-AG6` | transport legacy raw payload / `event_type` 兼容已清理完毕，reply typed payload 契约已归档。 |
 | CLM-20260309-D1INPUT | D1/D3 message input boundary cleanup | lang | done | 2026-03-09 | 2026-03-12 | `archive/2026-03-09-message-input-boundary-cleanup` | `CLM-20260304-AG6` | 收口 canonical `Message` 输入边界：agent 直收 `Message`、`Task.input_message`、transport poll 保真、不再把用户输入重新退化成 `Task.description`，并已归档。 |
 
-对账快照（2026-03-04）：
-- 未完成域 `D1/D3/D6/D8` 均已存在 `planned` claim（TODO 级）。
-- 已完成域 `D2/D4/D5/D7` 均已有 `done` claim 并与项目级聚合 claim 对账。
+对账快照（2026-03-10）：
+- 已完成域 `D1/D2/D3/D4/D5/D7` 均已有 `done` claim 并与项目级聚合 claim 对账。
+- 未完成域 `D6/D8` 均已存在 `planned` claim（TODO 级）。
 
 ## 0.2 消息管线重构拆分约束（2026-03-07）
 
@@ -108,10 +108,10 @@
 
 | ID | 任务 | 主要代码改动 | 支持能力 | 依赖 | 状态 | 输出证据 |
 |---|---|---|---|---|---|---|
-| D1-1 | 定义 `EnvelopePayload` 抽象与四类 payload | typed payload + schema 校验 | transport/message 契约统一 | 无 | todo | 单测：合法/非法输入 |
-| D1-2 | 定义 `AttachmentRef` | URI 字段规范 + 校验 | 富媒体入口 | 无 | todo | 单测：URI 错误码稳定 |
-| D1-3 | 升级 canonical `Message` | `text/attachments/data` 结构 | chat/图片/tool 统一表达 | D1-1/2 | todo | assemble 可消费 |
-| D1-4 | 约束与限制策略 | 字段矩阵/空值/超限错误模型 | 稳定输入治理 | D1-1/2/3 | todo | 压测与边界测试 |
+| D1-1 | 定义 `EnvelopePayload` 抽象与四类 payload | typed payload + schema 校验 | transport/message 契约统一 | 无 | done | `dare_framework/transport/types.py`（`EnvelopePayload`/`MessagePayload`/`SelectPayload`/`ActionPayload`/`ControlPayload`）；`tests/unit/test_transport_typed_payloads.py` |
+| D1-2 | 定义 `AttachmentRef` | URI 字段规范 + 校验 | 富媒体入口 | 无 | done | `dare_framework/context/types.py`（`AttachmentRef` + `AttachmentKind`）；`tests/unit/test_context_message_types.py::test_attachment_ref_rejects_invalid_kind` |
+| D1-3 | 升级 canonical `Message` | `text/attachments/data` 结构 | chat/图片/tool 统一表达 | D1-1/2 | done | `dare_framework/context/types.py`（`Message(role/kind/text/attachments/data)`）；`tests/unit/test_context_message_types.py` |
+| D1-4 | 约束与限制策略 | 字段矩阵/空值/超限错误模型 | 稳定输入治理 | D1-1/2/3 | done | `Message.__init__`/`AttachmentRef.__post_init__`/`MessagePayload.__post_init__` 校验；`tests/unit/test_context_message_types.py`（边界测试） |
 
 ---
 
@@ -159,10 +159,10 @@
 
 | ID | 任务 | 主要代码改动 | 支持能力 | 依赖 | 状态 | 输出证据 |
 |---|---|---|---|---|---|---|
-| D3-1 | 接入归一化管线 | assemble 前置 normalize | typed message 统一进入模型 | D1-3 + D2-2 | todo | 输入到模型链路测试 |
-| D3-2 | URI 构建策略 | resolver + policy | 附件/富媒体引用处理 | D1-2 | todo | URI 成功/失败路径测试 |
-| D3-3 | 降级策略 | text-only fallback 规则 | 多模型兼容执行 | D3-2 | todo | 不支持模态时行为稳定 |
-| D3-4 | 组装链路回归 | context 集成测试 | 旧文本流程不回归 | D3-1/2/3 | todo | 回归全绿 |
+| D3-1 | 接入归一化管线 | assemble 前置 normalize | typed message 统一进入模型 | D1-3 + D2-2 | done | `dare_framework/agent/base_agent.py`（`_coerce_transport_prompt`）；`dare_framework/agent/_internal/session_orchestrator.py`；`tests/unit/test_session_orchestrator_message_input.py` |
+| D3-2 | URI 构建策略 | resolver + policy | 附件/富媒体引用处理 | D1-2 | done | `dare_framework/a2a/server/message_adapter.py`（`_build_inline_attachment_uri`）；inline base64 / remote URL / local temp 三策略落地 |
+| D3-3 | 降级策略 | text-only fallback 规则 | 多模型兼容执行 | D3-2 | done | OpenAI/Anthropic/OpenRouter adapter 非 image 抛 `ValueError`；A2A non-image 降级为 text placeholder；`tests/unit/test_openai_model_adapter.py`、`test_anthropic_model_adapter.py`、`test_openrouter_adapter.py` |
+| D3-4 | 组装链路回归 | context 集成测试 | 旧文本流程不回归 | D3-1/2/3 | done | `tests/unit/test_checkpoint_message_schema.py`、`tests/unit/test_transport_typed_payloads.py`、`tests/unit/test_base_agent_transport_contract.py`、`tests/unit/test_context_implementation.py` |
 
 ---
 
@@ -330,8 +330,8 @@
 | Priority | TODO | 依赖声明 | 是否拆分 | 拆分切片 | 状态 | Owner |
 |---|---|---|---|---|---|---|
 | P0 | `D7` | 独立，可并行 | 否 | `D7` | done | lang |
-| P1 | `D1` | 无 | 是 | `D1_a/D1_b/D1_c` | planned |  |
-| P1 | `D3` | `D2 -> D3` | 是 | `D3_a/D3_b/D3_c` | planned |  |
+| P1 | `D1` | 无 | 是 | `D1_a/D1_b/D1_c` | done | lang |
+| P1 | `D3` | `D2 -> D3` | 是 | `D3_a/D3_b/D3_c` | done | lang |
 | P1 | `D6` | `D1 + D2 -> D6` | 是 | `D6_a/D6_b/D6_c` | planned |  |
 | P2 | `D8` | `D6 -> D8` | 是 | `D8_a/D8_b/D8_c` | planned |  |
 

@@ -24,7 +24,7 @@
 | CLM-20260302-AG3 | T5-5（D7 子范围） | lang | done | 2026-03-02 | 2026-03-03 | `agentscope-d7-plan-state-tools` | `CLM-20260302-D7` | PR #138 已合入主干，D7 子范围执行闭环完成。 |
 | ~~CLM-20260302-AG4~~ | ~~T5-3（历史聚合）~~ | ~~lang~~ | ~~deprecated~~ | ~~2026-03-02~~ | ~~2026-03-04~~ | ~~`agentscope-d1-d3-message-pipeline`~~ | ~~`CLM-20260302-D1D3`~~ | 历史聚合认领已废弃；后续以 AG6（TODO 级 claim）为准。 |
 | ~~CLM-20260303-AG5~~ | ~~T5-4（历史聚合）~~ | ~~N/A~~ | ~~deprecated~~ | ~~2026-03-03~~ | ~~2026-03-04~~ | ~~`pending`~~ | ~~`CLM-20260303-D6D8`~~ | 聚合占位 claim 已废弃；后续以 AG7（TODO 级 claim）为准。 |
-| CLM-20260304-AG6 | T5-3 |  | planned | 2026-03-04 | 2026-03-11 | `agentscope-d1-d3-message-pipeline` | `CLM-20260304-D1 + CLM-20260304-D3` | TODO 级认领；切片仅在 AgentScope 详细区维护。 |
+| CLM-20260304-AG6 | T5-3（D1+D3 子范围） | lang | done | 2026-03-04 | 2026-03-11 | `archive/2026-03-09-agentscope-d1-d3-message-pipeline` | `CLM-20260304-D1 + CLM-20260304-D3` | D1+D3 子范围已完成：canonical rich-media message schema、typed payload、adapter codec、assemble normalization、URI 策略、降级策略已归档。剩余 T5-3 范围（audio/video kind、跨适配器能力矩阵、正式降级策略文档、示例用例）需新 claim。 |
 | CLM-20260304-AG7 | T5-4 |  | planned | 2026-03-04 | 2026-03-11 | `pending` | `CLM-20260304-D6 + CLM-20260304-D8` | TODO 级认领；切片仅在 AgentScope 详细区维护。 |
 | CLM-20260304-AG8 | T1-2 + T1-5 |  | planned | 2026-03-04 | 2026-03-11 | `pending` | `—` | 项目层高复杂 TODO 组待分配；切片见详细拆分区。 |
 | CLM-20260304-AG9 | T2-3 + T2-4 |  | planned | 2026-03-04 | 2026-03-11 | `pending` | `—` | 项目层治理 TODO 组待分配；切片见详细拆分区。 |
@@ -38,6 +38,7 @@
 
 对账快照（2026-03-11）：
 - AgentScope 聚合 claim（AG1/AG2/AG3/AG6/AG7）均可在 `agentscope_domain_execution_todos.md` 中找到明细 claim 对应。
+- AG6（T5-3 D1+D3 子范围）已完成并归档，剩余范围（audio/video、能力矩阵、降级文档、示例）需新 claim。
 - 项目层独立 claim（AG8/AG9/AG10/AG11/AG12/AG13/AG14/AG15/AG16）不在 AgentScope 明细板拆分。
 - AG10（T0-6）已由 PR #181 合入主干；本表状态已回写为 `done`。
 
@@ -242,8 +243,23 @@ AgentScope 补齐详细 TODO 入口：`docs/todos/agentscope_domain_execution_to
 
 - [ ] T5-3 图片/音频/视频富媒体消息格式支持
   Status: `planned`
-  范围：定义并落地多模态消息格式基线。保留 `TransportEnvelope.kind = message/select/action/control`，以 typed payload 替代 `payload: Any + event_type`；升级 canonical `Message` 为 `text + attachments + data` 结构，覆盖模型输入、上下文存储、transport 传输与适配器能力探测；统一替代“图片/富媒体一等支持”的原 T4-4 范围（含 A2A 附件链路规范化）。
+  范围：定义并落地多模态消息格式基线。保留 `TransportEnvelope.kind = message/select/action/control`，以 typed payload 替代 `payload: Any + event_type`；升级 canonical `Message` 为 `text + attachments + data` 结构，覆盖模型输入、上下文存储、transport 传输与适配器能力探测；统一替代”图片/富媒体一等支持”的原 T4-4 范围（含 A2A 附件链路规范化）。
   交付：跨适配器能力矩阵 + 不支持能力时的降级策略 + 示例用例。
+  已完成子范围（D1+D3 子范围，已归档）：
+  - canonical `Message(role/kind/text/attachments/data)` schema 已落地（`dare_framework/context/types.py`）
+  - `AttachmentRef(kind=IMAGE)` 定义与校验已落地（`dare_framework/context/types.py`）
+  - typed payload families (`MessagePayload`/`SelectPayload`/`ActionPayload`/`ControlPayload`) 已落地（`dare_framework/transport/types.py`）
+  - assemble normalization pipeline 已落地（`base_agent.py`、`session_orchestrator.py`）
+  - URI 构建策略（inline base64 / remote URL / local temp）已落地（`a2a/server/message_adapter.py`）
+  - 三适配器（OpenAI/Anthropic/OpenRouter）image 序列化已落地
+  - transport typed payload cutover + message input boundary cleanup 已归档
+  Evidence: `openspec/changes/archive/2026-03-09-agentscope-d1-d3-message-pipeline/`、`archive/2026-03-09-transport-typed-payload-cutover/`、`archive/2026-03-09-message-input-boundary-cleanup/`
+  剩余范围：
+  - `AttachmentKind` 扩展 `AUDIO`/`VIDEO`（当前仅 `IMAGE`）
+  - 跨适配器能力矩阵文档 + 运行时 capability probing 接口
+  - 正式降级策略规格文档（retry/fallback 规则）
+  - `examples/` 富媒体消息示例用例
+  Last Updated: `2026-03-10`
 
 - [ ] T5-4 全链路日志输出整理（模块分层与规范化）  
   Status: `planned`