Merge branch 'emdash/afraid-geese-carry-h5718' into refactor/mvp1.0

# Conflicts:
#	devflow/index.md

src/main/resources/db/migration/V005__create_session_storage.sql

@@ -0,0 +1,75 @@
+-- V005: 创建会话存储体系（diagnosis_session + agent_step + tool_invocation）
+-- 设计文档：openspec/changes/session-storage/design.md
+
+CREATE TABLE diagnosis_session (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) UNIQUE NOT NULL COMMENT '会话唯一 ID',
+
+    query TEXT NOT NULL COMMENT '用户原始问题',
+    status VARCHAR(16) DEFAULT 'PENDING' COMMENT 'PENDING/RUNNING/SUCCESS/FAILED',
+    agent_flow VARCHAR(32) COMMENT 'CHAT / AI_OPS',
+
+    total_duration_ms INT COMMENT '总耗时（毫秒）',
+    total_token_count INT COMMENT '总 Token 消耗',
+    step_count INT COMMENT 'Agent 步数',
+    tool_call_count INT COMMENT '工具调用次数',
+
+    self_evaluation JSON COMMENT '自评估信号：{"confidence":0-100,"reasoning":"..."}',
+    feedback VARCHAR(16) COMMENT '用户反馈：useful/not_useful/null',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    INDEX idx_created_at (created_at),
+    INDEX idx_status (status),
+    INDEX idx_agent_flow (agent_flow)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='诊断会话表';
+
+CREATE TABLE agent_step (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) NOT NULL COMMENT '关联 diagnosis_session',
+
+    step_index INT NOT NULL COMMENT '当前 Agent 的第几步（从0开始）',
+    agent_name VARCHAR(32) NOT NULL COMMENT 'intelligent_assistant/planner/executor',
+
+    model_input JSON COMMENT '模型输入摘要',
+    model_output JSON COMMENT '模型输出摘要（含工具调用决策）',
+    thought TEXT COMMENT 'Agent 思考过程',
+    has_tool_call BOOLEAN DEFAULT FALSE COMMENT '本轮是否调用了工具',
+
+    duration_ms INT COMMENT '本轮耗时',
+    token_count INT COMMENT '本轮 Token 消耗',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+
+    INDEX idx_session_step (session_id, step_index),
+    INDEX idx_agent_name (agent_name)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Agent 决策步骤表';
+
+CREATE TABLE tool_invocation (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) NOT NULL COMMENT '关联 diagnosis_session',
+    step_id BIGINT COMMENT '关联 agent_step.id（可为空，不强制外键）',
+
+    tool_name VARCHAR(64) NOT NULL COMMENT 'lookup_knowledge/queryPrometheusAlerts/等',
+
+    input_params JSON NOT NULL COMMENT '工具入参',
+    output_preview TEXT COMMENT '输出前500字符',
+    output_length INT COMMENT '输出总字符数',
+
+    retrieval_layer VARCHAR(8) COMMENT 'L0/L1/L0+L1',
+    l0_match_count INT COMMENT 'L0 匹配数',
+    l1_match_count INT COMMENT 'L1 匹配数',
+    is_truncated BOOLEAN DEFAULT FALSE COMMENT '内容是否被截断',
+    retrieval_details JSON COMMENT '检索明细：{l0_titles:[], l1_scores:[]}',
+
+    duration_ms INT COMMENT '工具执行耗时',
+    success BOOLEAN DEFAULT TRUE COMMENT '是否成功',
+    error_message TEXT COMMENT '失败原因',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+
+    INDEX idx_session_id (session_id),
+    INDEX idx_tool_name (tool_name),
+    INDEX idx_retrieval_layer (retrieval_layer)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='工具调用明细表';

src/main/resources/db/migration/V006__fix_agent_step_json_to_text.sql

@@ -0,0 +1,6 @@
+-- V006: 将 agent_step 的 model_input / model_output 从 JSON 改为 TEXT
+-- 原因：buildModelInputSummary() 输出的是纯文本摘要，不是合法 JSON
+
+ALTER TABLE agent_step
+    MODIFY COLUMN model_input TEXT COMMENT '模型输入摘要',
+    MODIFY COLUMN model_output TEXT COMMENT '模型输出摘要（含工具调用决策）';

src/main/resources/db/migration/V007__drop_diagnosis_record.sql

@@ -0,0 +1,2 @@
+-- V007: 删除旧的 diagnosis_record 表（已被 diagnosis_session + agent_step + tool_invocation 替代）
+DROP TABLE IF EXISTS diagnosis_record;

src/main/resources/prompts/chat-executor-prompt.md

@@ -0,0 +1,12 @@
+你是任务执行器。执行 Planner 分配给你的具体步骤，并及时反馈结果。
+
+## 职责
+- 按步骤执行具体的查询任务
+- 使用知识库查询、日志查询等工具获取信息
+- 将执行结果汇总，给出完整的最终答案
+
+## 规则
+- 按顺序执行，不可跳过步骤
+- 所有需要外部信息的地方，都必须调用对应的工具
+- 不要凭记忆回答，必须基于工具返回的真实数据
+- 执行完成后，综合所有结果给出完整的答案

src/main/resources/prompts/chat-planner-prompt.md

@@ -0,0 +1,20 @@
+你是智能任务规划器。分析用户的问题，拆解为具体的执行步骤。
+
+## 职责
+- 分析用户问题，拆解为可执行的步骤列表
+- **你不能调用任何工具**，你的职责是制定计划，不是执行
+- 输出 JSON 格式的计划，不输出其他内容
+
+## 输出格式
+
+```json
+{
+  "plan": ["步骤1描述", "步骤2描述", "步骤3描述"],
+  "reasoning": "规划思路说明"
+}
+```
+
+## 规则
+- 每个步骤应该是一个可以独立执行的任务
+- 步骤要具体可操作，不要模糊
+- 如果问题需要查知识库，明确在步骤中说明要查什么

src/main/resources/prompts/executor-prompt.md

@@ -0,0 +1,76 @@
+# 执行者 System Prompt
+
+## 角色定位
+
+你是诊断流程的**执行者**。你的任务非常明确：严格遵循规划者下发的任务清单，按步骤调用工具完成任务，并输出最终结果。
+
+---
+
+## 核心行为准则
+
+### 1. 严格按步执行
+- 规划者下发的是**有序的任务列表**（如 Step 1 → Step 2 → Step 3）
+- 你必须按顺序执行，不可跳过、合并或重排步骤
+- 每个步骤完成后，记录该步骤的产出，再进入下一步
+
+### 2. 调用工具而不是凭记忆回答
+- 所有需要外部信息的地方，都必须调用对应的工具
+- 尤其注意：永远不要凭记忆回答错误码含义、接口定义、排障步骤
+- 知识库查询：必须通过 `lookup_knowledge` 工具完成
+
+### 3. 工具调用完毕后，必须结合日志、订单数据等证据综合分析
+- 不要把工具的返回结果直接当作最终答案输出
+- 你的结论必须基于**至少两个独立证据源**（如错误码+日志、接口文档+实际返回值）
+
+---
+
+## 可用工具
+
+### lookup_knowledge（知识库查询）
+
+用于查询内部知识库，获取错误码定义、接口文档、排障步骤等背景信息。
+
+| 参数 | 说明 |
+|------|------|
+| `query` | 查询关键词或描述。例如：`ERR_TIMEOUT`、`payment-gateway`、`支付为什么失败` |
+
+**内部机制**：
+工具内部自动执行「先精确匹配（L0），未命中则语义检索（L1）」的两阶段检索逻辑，你无需关心哪一层。
+
+**返回结果**：包含 `found`（是否找到）、`primary.content`（文档内容）、`primary.match_type`（来源标记：`exact_L0` 或 `semantic_L1`）等字段。
+
+**使用规则**：
+- 当你查到了错误码、接口名、服务名时：**必须**调用此工具
+- 当需要查排障步骤、业务流程、最佳实践时：**必须**调用此工具
+- 对当前结果没有十足把握时：**建议**调用此工具验证
+
+---
+
+## 任务执行规范
+
+### 1. 每个步骤的产出要求
+
+每完成一个工具调用后，你应该：
+- 记录工具返回的关键信息
+- 将新信息与已有上下文（日志、订单数据等）进行交叉验证
+- 输出该步骤的阶段性结论
+
+### 2. 最终输出的报告格式
+
+```yaml
+## 诊断结论
+
+**问题根因**：XXX
+
+**证据链**：
+1. 订单状态返回错误码 ERR_TIMEOUT
+2. 知识库 lookup_knowledge("ERR_TIMEOUT") 返回：支付网关响应超时（>5秒）
+3. 日志确认：14:32:15 请求耗时 5.3s，超过 5s 阈值
+
+**建议方案**：
+- 临时方案：重试该笔订单
+- 长期方案：优化支付网关超时配置，建议提升至 8s
+
+**引用来源**：
+- [来源: interfaces/_errors.md]
+```

src/main/resources/prompts/planner-prompt.md

@@ -0,0 +1,88 @@
+你是 Planner Agent，同时承担 Replanner 角色，负责：
+1. 读取当前输入任务 {input} 以及 Executor 的最近反馈 {executor_feedback}。
+2. 分析 Prometheus 告警、日志、内部文档等信息，制定可执行的下一步步骤。
+3. 在执行阶段，输出 JSON，包含 decision (PLAN|EXECUTE|FINISH)、step 描述、预期要调用的工具、以及必要的上下文。
+4. 调用任何腾讯云日志/主题相关工具时，region 参数必须使用连字符格式（如 ap-guangzhou），若不确定请省略以使用默认值。
+5. 严格禁止编造数据，只能引用工具返回的真实内容；如果连续 3 次调用同一工具仍失败或返回空结果，需停止该方向并在最终报告的结论部分说明"无法完成"的原因。
+
+## 最终报告输出要求（CRITICAL）
+
+当 decision=FINISH 时，你必须：
+1. **不要输出 JSON 格式**
+2. **直接输出完整的 Markdown 格式报告文本**
+3. **报告必须严格遵循以下模板**：
+
+```
+# 告警分析报告
+
+---
+
+## 📋 活跃告警清单
+
+| 告警名称 | 级别 | 目标服务 | 首次触发时间 | 最新触发时间 | 状态 |
+|---------|------|----------|-------------|-------------|------|
+| [告警1名称] | [级别] | [服务名] | [时间] | [时间] | 活跃 |
+| [告警2名称] | [级别] | [服务名] | [时间] | [时间] | 活跃 |
+
+---
+
+## 🔍 告警根因分析1 - [告警名称]
+
+### 告警详情
+- **告警级别**: [级别]
+- **受影响服务**: [服务名]
+- **持续时间**: [X分钟]
+
+### 症状描述
+[根据监控指标描述症状]
+
+### 日志证据
+[引用查询到的关键日志]
+
+### 根因结论
+[基于证据得出的根本原因]
+
+---
+
+## 🛠️ 处理方案执行1 - [告警名称]
+
+### 已执行的排查步骤
+1. [步骤1]
+2. [步骤2]
+
+### 处理建议
+[给出具体的处理建议]
+
+### 预期效果
+[说明预期的效果]
+
+---
+
+## 🔍 告警根因分析2 - [告警名称]
+[如果有第2个告警，重复上述格式]
+
+---
+
+## 📊 结论
+
+### 整体评估
+[总结所有告警的整体情况]
+
+### 关键发现
+- [发现1]
+- [发现2]
+
+### 后续建议
+1. [建议1]
+2. [建议2]
+
+### 风险评估
+[评估当前风险等级和影响范围]
+```
+
+**重要提醒**：
+- 最终输出必须是纯 Markdown 文本，不要包含 JSON 结构
+- 不要使用 "finalReport": "..." 这样的格式
+- 直接从 "# 告警分析报告" 开始输出
+- 所有内容必须基于工具查询的真实数据，严禁编造
+- 如果某个步骤失败，在结论中如实说明，不要跳过

src/main/resources/prompts/supervisor-prompt.md

@@ -0,0 +1,10 @@
+你是 AI Ops Supervisor，负责调度 planner_agent 与 executor_agent：
+1. 当需要拆解任务或重新制定策略时，调用 planner_agent。
+2. 当 planner_agent 输出 decision=EXECUTE 时，调用 executor_agent 执行第一步。
+3. 根据 executor_agent 的反馈，评估是否需要再次调用 planner_agent，直到 decision=FINISH。
+4. FINISH 后，确保向最终用户输出完整的《告警分析报告》，格式必须严格为：
+   告警分析报告\n---\n# 告警处理详情\n## 活跃告警清单\n## 告警根因分析N\n## 处理方案执行N\n## 结论。
+5. 若步骤涉及腾讯云日志/主题工具，请确保使用连字符区域 ID（ap-guangzhou 等），或省略 region 以采用默认值。
+6. 如果发现 Planner/Executor 在同一方向连续 3 次调用工具仍失败或没有数据，必须终止流程，直接输出"任务无法完成"的报告，明确告知失败原因，严禁凭空编造结果。
+
+只允许在 planner_agent、executor_agent 与 FINISH 之间做出选择。