# 中台智能体运行时加固（MARH）任务清单

## Phase 1：护栏与超时口径统一

- [x] T-MARH-01 在 `respond` 主流程接入输出护栏强制执行（关联：AC-MARH-01）
- [x] T-MARH-02 护栏触发信息写入 trace 与审计日志（关联：AC-MARH-02）
- [x] T-MARH-03 统一 ReAct 循环上限到 3~5（关联：AC-MARH-07）
- [x] T-MARH-04 统一单工具超时 <=2000ms（关联：AC-MARH-08）
- [x] T-MARH-05 统一全链路超时 <=8000ms 并降级（关联：AC-MARH-09）

## Phase 2：打断语义与 KB 默认工具链

- [x] T-MARH-06 实现 interrupted_segments 重规划输入处理（关联：AC-MARH-03）
- [x] T-MARH-07 实现中断异常兜底逻辑（关联：AC-MARH-04）
- [x] T-MARH-08 在 Agent 模式接入默认 KB 检索工具调用（关联：AC-MARH-05）
- [x] T-MARH-09 实现 KB 失败时可观测降级路径（关联：AC-MARH-06）

## Phase 3：拟人分段与观测闭环

- [x] T-MARH-10 实现分段策略组件（语义/长度切分）（关联：AC-MARH-10）
- [x] T-MARH-11 实现 delay 策略租户化配置（关联：AC-MARH-11）
- [x] T-MARH-12 补齐运行时观测字段与统计（关联：AC-MARH-12）

## Phase 4：KB 动态检索工具（元数据驱动）

- [x] T-MARH-13 实现 MetadataFilterBuilder 组件（关联：AC-MARH-05）
- [x] T-MARH-14 实现 kb_search_dynamic 工具并注册到 ToolRegistry（关联：AC-MARH-05/06）
- [x] T-MARH-15 在 Agent 主链路集成 kb_search_dynamic 工具（关联：AC-MARH-05）
- [x] T-MARH-16 添加 KbSearchDynamicResult 数据模型（关联：AC-MARH-05/06）

## Phase 5：高风险检测工具（元数据驱动）

- [x] T-MARH-17 实现 HighRiskCheckTool 工具（元数据驱动）（关联：AC-IDMP-05/20）
- [x] T-MARH-18 添加 HighRiskCheckResult 数据模型（关联：AC-IDMP-05/20）
- [x] T-MARH-19 注册 high_risk_check 工具到 ToolRegistry（关联：AC-IDMP-05）
- [x] T-MARH-20 在 dialogue 主链路集成 high_risk_check（高风险优先）（关联：AC-IDMP-05/20）
- [x] T-MARH-21 更新 policy_router 支持高风险检测结果（关联：AC-IDMP-05/20）

## 验收关卡（DoD）

- [x] openapi.provider.yaml 达到 L2 并可契约测试
- [x] 所有 AC 在 requirements/openapi/design/tasks 可追踪
- [x] 仅中台范围，不引入渠道侧实现耦合

## 实现文件清单

| 文件 | AC 关联 | 说明 |
|------|---------|------|
| `services/mid/output_guardrail_executor.py` | AC-MARH-01/02 | 输出护栏强制执行器 |
| `services/mid/interrupt_context_enricher.py` | AC-MARH-03/04 | 中断上下文增强器 |
| `services/mid/default_kb_tool_runner.py` | AC-MARH-05/06 | KB 默认工具执行器 |
| `services/mid/metadata_filter_builder.py` | AC-MARH-05 | 元数据过滤器构建器 |
| `services/mid/kb_search_dynamic_tool.py` | AC-MARH-05/06 | KB 动态检索工具 |
| `services/mid/high_risk_check_tool.py` | AC-IDMP-05/20 | 高风险检测工具（元数据驱动） |
| `services/mid/segment_humanizer.py` | AC-MARH-10/11 | 分段拟人化组件 |
| `services/mid/runtime_observer.py` | AC-MARH-12 | 运行时观测器 |
| `services/mid/timeout_governor.py` | AC-MARH-08/09 | 超时治理（已更新） |
| `services/mid/policy_router.py` | AC-IDMP-02/05/16/20 | 策略路由器（已更新支持高风险检测） |
| `api/mid/dialogue.py` | AC-MARH-01~12, AC-IDMP-05/20 | 主入口（已集成高风险检测） |
| `models/mid/schemas.py` | AC-MARH-05/11/12, AC-IDMP-05/20 | 数据模型（已更新） |
