docs(原型设计): 重构Agent化原型文档主线

docs/原型设计/1.1.资料包导入页原型设计.md

@@ -4,6 +4,8 @@
 
 把注册申报资料的导入、解包、扫描、目录汇总和章节点识别结果集中展示出来，让用户第一眼就明白本平台的输入对象是“资料包”，不是单篇文档。
 
+本页还需要明确表达：资料包不是孤立文件集合，而是会与一个审核会话绑定，对话标题默认采用解析后的产品名称。
+
 ## 2. 适用角色
 
 - 注册资料专员
@@ -69,6 +71,8 @@
 
 表格列建议：
 
+- 产品名称
+- 关联会话
 - 原始相对路径
 - 文件名
 - 文件类型
@@ -86,6 +90,8 @@
 关键字段：
 
 - `batch_id`
+- `product_name`
+- `conversation_id`
 - `file_count`
 - `supported_file_count`
 - `failed_file_count`
@@ -112,6 +118,8 @@
 - 点击目录树节点，可在右侧高亮对应文件。
 - 点击异常项，可筛选下方表格。
 - 点击单个文件行，可打开“文档详情抽屉”，展示页数统计方式和章节点识别结果。
+- 点击资料包标题或“查看对话”，跳转到关联会话。
+- 页面顶部搜索框支持按产品名称或批次号搜索资料包。
 - 点击“进入法规完整性检查”，跳转下一页。
 
 ## 7. 与上下游页面的数据关系
@@ -127,6 +135,7 @@
 ## 8. 演示话术重点
 
 - 强调本平台处理的是整套注册资料，不是单文档聊天。
+- 强调资料包会与会话绑定，用户后续是围绕该产品资料持续对话和追溯。
 - 强调压缩包、目录层级、页数和章节点是后续审核的事实基础。
 - 强调异常箱的价值在于把“资料问题”前置，而不是等到审核后才发现。
 

docs/原型设计/1.2.审核任务工作台原型设计.md

@@ -1,120 +0,0 @@
-# 审核任务工作台原型设计
-
-## 1. 页面目标
-
-作为整套原型的首页，先把当前批次的审核进度、任务状态、关键风险和操作入口集中展示，让用户在 10 秒内理解平台价值和当前处理位置。
-
-## 2. 适用角色
-
-- 注册申报负责人
-- 项目经理
-- 复试演示讲解人
-
-## 3. 页面布局分区
-
-页面建议采用“总览头图 + 流程卡片 + 风险与待办双栏”。
-
-分区如下：
-
-- 顶部 Hero：批次、产品、流程、总体结论
-- 中部七卡任务区
-- 下方左侧：风险总览
-- 下方右侧：待办动作与推荐下一步
-
-## 4. 核心卡片 / 表格 / 状态区
-
-### 4.1 批次总览 Hero
-
-展示：
-
-- 批次编号
-- 产品名称
-- 当前流程类型
-- 当前审核阶段
-- 最高风险等级
-- 是否允许正式导出
-
-### 4.2 七个流程任务卡片
-
-固定七张卡片：
-
-1. 资料包导入
-2. 目录汇总
-3. 法规完整性检查
-4. 字段抽取
-5. 一致性核查
-6. 风险预警
-7. Word 回填导出
-
-每张卡片展示：
-
-- 任务名称
-- 当前状态
-- 关键指标
-- 最近执行时间
-- 进入页面按钮
-
-### 4.3 风险总览区
-
-展示：
-
-- 高 / 中 / 低风险数量
-- 当前阻断原因
-- 需要人工复核的字段数
-
-### 4.4 待办动作区
-
-展示：
-
-- 缺失项补充建议
-- 字段冲突待确认项
-- 推荐下一步操作
-
-## 5. 关键字段定义
-
-建议聚合使用以下对象：
-
-- `registration_overview_report`
-- `registration_completeness_report`
-- `registration_field_extraction_report`
-- `registration_consistency_report`
-- `registration_risk_report`
-- `registration_word_export_report`
-
-工作台摘要字段：
-
-- `task_name`
-- `task_status`
-- `last_run_at`
-- `summary_label`
-- `summary_value`
-- `entry_target`
-
-## 6. 关键交互
-
-- 点击任务卡片进入对应页面。
-- 点击“查看总体风险”滚动到风险区。
-- 点击“打开治理台”查看规则版本、字段 Schema、模板版本。
-- 鼠标悬浮卡片显示“本任务输入来自哪里，输出流向哪里”。
-
-## 7. 与上下游页面的数据关系
-
-上游：汇总所有页面结果。
-
-下游：为各页面提供统一入口，不产生独立业务结果。
-
-## 8. 演示话术重点
-
-- 先讲“流程闭环”，再讲某个点上的智能能力。
-- 突出这不是自由问答，而是受控的任务执行工作台。
-- 强调每个任务卡片都有状态、有输入输出、有结构化结果。
-
-## 9. 与知识库 / 治理台的关联入口
-
-工作台页右上角提供：
-
-- `规则版本总览`
-- `模板版本总览`
-- `责任人映射总览`
-
-适合作为讲解治理能力的总入口。

docs/原型设计/1.2.审核智能体页原型设计.md

@@ -0,0 +1,162 @@
+# 审核智能体页原型设计
+
+## 1. 页面目标
+
+作为整套原型的主入口，以 Agent 对话为核心承接资料上传、任务模板触发、节点式审核推进和结构化结果讲解，让用户在 10 秒内理解“这是一个审核智能体，而不是传统报表后台”。
+
+## 2. 适用角色
+
+- 注册申报负责人
+- 项目经理
+- 复试演示讲解人
+
+## 3. 页面布局分区
+
+页面建议采用“顶部对话上下文 + 三栏工作区”。
+
+分区如下：
+
+- 顶部：产品定位、提示词模板、当前会话摘要
+- 左栏：对话历史
+- 中栏：对话区 + 节点导航
+- 右栏上部：上传栏
+- 右栏下部：任务能力卡 / 结构化结果卡
+
+## 4. 核心卡片 / 表格 / 状态区
+
+### 4.1 顶部对话上下文区
+
+展示：
+
+- 批次编号
+- 产品名称
+- 当前流程类型
+- 当前审核阶段
+- 当前最高风险等级
+- 是否允许正式导出
+- 推荐提问模板
+
+### 4.2 左栏对话历史
+
+展示：
+
+- 历史会话标题
+- 会话对应产品名称
+- 风险状态
+- 最近更新时间
+- 资料包绑定标记
+
+交互：
+
+- 点击某条会话，切换到对应产品资料的审核上下文。
+- 会话标题默认采用解析后的 `product_name`。
+
+### 4.3 中栏对话区与节点导航
+
+展示：
+
+- 用户问题
+- Agent 执行计划
+- 节点结果消息
+- 结构化摘要片段
+- RAG 命中依据提示
+
+节点条固定包含：
+
+1. 资料包导入
+2. 目录汇总
+3. 法规完整性检查
+4. 字段抽取
+5. 一致性核查
+6. 风险预警
+7. Word 回填导出
+8. 飞书通知
+
+交互：
+
+- 点击节点，定位到该阶段的消息和结构化结果。
+- 当前执行节点状态实时变化为 `处理中 / 已完成 / 待复核 / 已阻断`。
+
+### 4.4 右栏上传区
+
+展示：
+
+- 当前资料包上传入口
+- 最近上传文件
+- 文件解析状态
+- 支持格式说明
+
+### 4.5 右栏任务能力卡
+
+根据当前选中的节点或任务模板，展示不同信息：
+
+- 目录汇总时展示文件数、页数、章节点覆盖
+- 完整性检查时展示缺失项、错放项、法规依据摘要
+- 字段抽取时展示字段数、低置信度、待复核状态
+- 一致性核查时展示冲突字段、混档风险
+- 风险预警时展示总风险等级、是否允许导出、整改建议
+- Word 导出时展示回填字段、拦截项和导出状态
+- 飞书通知时展示 `@` 处理人、通知原因和 Web 详情链接
+
+
+## 5. 关键字段定义
+
+建议聚合使用以下对象：
+
+- `registration_overview_report`
+- `registration_completeness_report`
+- `registration_field_extraction_report`
+- `registration_consistency_report`
+- `registration_risk_report`
+- `registration_word_export_report`
+
+工作台摘要字段：
+
+- `conversation_id`
+- `product_name`
+- `batch_id`
+- `task_name`
+- `task_status`
+- `last_run_at`
+- `summary_label`
+- `summary_value`
+- `entry_target`
+- `notify_reason`
+
+## 6. 关键交互
+
+- 点击历史会话切换产品审核上下文。
+- 点击预设提问模板，自动填充对话输入框。
+- 点击节点条跳转到对应执行阶段。
+- 上传附件后，右栏任务卡片按 `文档解析中 -> 解析完成 -> 数据处理中 -> 处理完成` 实时更新。
+- 点击能力卡查看来源证据、结构化结果或治理入口。
+- 点击“打开治理台”查看规则版本、字段 Schema、模板版本和责任人映射。
+
+## 7. 与上下游页面的数据关系
+
+上游：
+
+- 资料包页提供当前 `batch_id`、`product_name` 和会话绑定关系。
+- 知识库页提供法规、模板、字段和飞书配置能力。
+
+下游：
+
+- 本页串联所有审核节点结果，是主执行页面。
+- 处理历史页回看本页产生的节点消息、结构化结论和通知记录。
+
+## 8. 演示话术重点
+
+- 先讲“对话驱动的审核闭环”，再讲某个点上的智能能力。
+- 突出这不是传统分页后台，而是带任务节点和结构化结果的审核智能体。
+- 强调每个节点都有状态、有输入输出、有结构化结果，并且能追溯到知识库依据和资料包。
+
+## 9. 与知识库 / 治理台的关联入口
+
+本页右侧或右上角提供：
+
+- `规则版本总览`
+- `模板版本总览`
+- `责任人映射总览`
+- `飞书配置总览`
+
+适合作为讲解治理能力的总入口。

docs/原型设计/1.8.飞书通知视图原型设计.md

@@ -2,7 +2,9 @@
 
 ## 1. 页面目标
 
-把风险预警和导出状态转成一张可发送的飞书消息卡片，展示责任人 `@`、消息摘要、Web 详情链接和发送回执，形成工作台外部协同闭环。
+把风险预警和导出状态转成一张可发送的飞书消息卡片，展示责任人 `@`、消息摘要、Web 详情链接和发送回执，形成审核智能体之外的协同闭环。
+
+当前 Demo 固定口径为：任务执行完成后直接通知，或在执行异常后直接通知，并 `@` 对应处理人。
 
 ## 2. 适用角色
 
@@ -37,6 +39,7 @@
 展示：
 
 - 触发来源
+- 通知原因
 - 飞书群聊 ID
 - 消息类型
 - 是否包含责任人通知
@@ -58,6 +61,7 @@
 关键字段：
 
 - `send_status`
+- `notify_reason`
 - `message_type`
 - `mentioned_users[]`
 - `web_detail_url`
@@ -76,6 +80,7 @@
 - 点击“发送通知”切换为已发送状态。
 - 点击责任人标签，查看角色映射详情。
 - 点击 Web 详情按钮，跳转到 mock 审计详情链接。
+- 点击“切换通知原因”，在 `task_completed / task_failed` 两类消息之间切换。
 
 ## 7. 与上下游页面的数据关系
 
@@ -89,7 +94,7 @@
 ## 8. 演示话术重点
 
 - 强调平台不止有 Web 界面，还有飞书协同入口。
-- 强调系统可以把风险结果直接转换成责任人可执行的通知载荷。
+- 强调系统可以在任务完成或异常后，直接把结果转换成责任人可执行的通知载荷。
 - 强调通知里保留 Web 详情链接，便于追溯。
 
 ## 9. 与知识库 / 治理台的关联入口

docs/原型设计/1.整体原型设计.md

@@ -19,18 +19,17 @@
 
 ## 2. 演示总动线
 
-推荐演示顺序：
+最新版原型采用“顶层 4 个 Tab + 对话内节点推进”的组织方式，推荐演示顺序如下：
 
-1. 从“审核任务工作台”进入，先看 7 个流程任务卡片和当前批次状态。
+1. 先进入 `审核智能体`，展示左侧会话历史、中间对话区、右侧上传区和任务卡片区。
-2. 跳到“资料包导入页”，解释资料包、目录、页数和章节点识别。
+2. 在对话页上传资料包，触发目录汇总、完整性检查、字段抽取、一致性核查和风险结论节点。
-3. 进入“法规完整性检查页”，展示缺失项、错放项和法规依据。
+3. 点击对话节点，解释每一步的结构化结果如何在右侧卡片实时更新状态。
-4. 进入“字段抽取与字段池页”，展示统一字段池、置信度和待复核字段。
+4. 切换到 `资料包`，展示资料包列表、按产品名称搜索、资料包与会话绑定关系，以及目录、页数、章节点结果。
-5. 进入“一致性核查页”，展示字段冲突和混档风险。
+5. 切换到 `知识库`，说明法规资料、业务资料、RAG 切片、字段 Schema、模板映射、责任人映射和飞书配置如何治理。
-6. 进入“风险预警页”，说明总风险等级、是否通过、整改建议和责任角色。
+6. 切换到 `处理历史`，说明如何按批次、产品和风险状态回看历史会话、资料规模和通知留痕。
-7. 进入“Word 回填导出页”，说明自动回填、导出拦截和下载入口。
+7. 返回对话中的风险与导出节点，最后展示飞书完成通知或异常通知如何直接 `@` 处理人并携带 Web 详情链接。
-8. 最后展示“飞书通知视图”，形成协同闭环。
 
-知识库与治理台不作为独立主线页面插入，而是作为上述页面的配置入口、侧边抽屉或管理弹层出现，用来回答“规则从哪里来、谁来维护、如何增删改查”。
+法规依据不再以单独一级页面存在，而是作为知识库中的法规资料，由 RAG 在对话节点中返回依据说明。
 
 ## 3. 统一视觉风格
 
@@ -44,8 +43,8 @@
 
 ### 3.2 色彩建议
 
-- 主背景：浅灰蓝与米白渐变，形成轻量但不空泛的工作台底色。
+- 主背景：以白色为主，辅以极浅灰蓝，保证整体简洁和专业。
-- 主强调色：深青蓝，用于导航、主按钮、激活态和重点数值。
+- 主强调色：克制的深青蓝，用于导航、主按钮、激活态和重点数值。
 - 风险色：铜橙、深红，用于缺失、冲突、高风险、阻断状态。
 - 成功色：低饱和绿色，用于完成、可通过、已同步状态。
 - 中性色：冷灰，用于说明文字、边框、标签和禁用态。
@@ -60,16 +59,19 @@
 
 ### 4.1 全局导航
 
-- 顶部固定展示：平台名称、当前批次、产品名称、流程类型、全局风险状态。
+- 顶部固定展示：平台名称、顶层 Tab、右上角用户信息。
-- 左侧流程导航固定展示 8 个主页面入口。
+- 顶层 Tab 固定为：`审核智能体 / 资料包 / 知识库 / 处理历史`。
-- 每个页面右上角保留“打开治理台”入口。
+- `审核智能体` 内部采用三栏布局，不再使用左侧 8 页面流程导航。
+- 每个页面保留“打开治理台”或同等治理入口。
 
 ### 4.2 统一交互规则
 
-- 所有结果页都支持“查看来源证据”。
+- 对话是主执行入口，页面切换是不同信息视角，而不是不同执行系统。
+- 所有结果区都支持“查看来源证据”。
 - 所有关键对象都支持“打开详情抽屉”。
 - 所有治理对象都遵循“列表 -> 详情 -> 新增 / 编辑 / 启停 / 删除”的统一 CRUD 结构。
-- 风险阻断项必须在 Word 导出页和飞书通知视图里继续可见，保证前后呼应。
+- 风险阻断项必须在对话节点、Word 导出区和飞书通知视图里持续可见，保证前后呼应。
+- 资料包必须可跳转到关联会话，会话标题默认采用解析后的 `product_name`。
 
 ### 4.3 状态规范
 
@@ -99,6 +101,7 @@
 - `batch_id`: `SUB-20260603-001`
 - `workflow_type`: `registration`
 - `product_name`: `新型冠状病毒 2019-nCoV 核酸检测试剂盒`
+- `conversation_id`: `conv-001`
 - `applicant_name`: `示例生物科技（上海）有限公司`
 - `chapter_scope`: `CH1 ~ CH6`
 
@@ -111,7 +114,7 @@
 3. 说明书与申请表中的产品名称存在文本不一致。
 4. 储存条件字段存在待人工复核状态。
 5. 风险等级为高，当前批次不允许正式导出，仅允许生成草稿。
-6. 飞书通知需要 `@注册资料负责人` 和 `@注册申报负责人`。
+6. 飞书通知在任务完成或出现异常后直接 `@注册资料负责人` 和 `@注册申报负责人`。
 
 ### 5.3 共用对象定义
 
@@ -137,17 +140,23 @@
 
 ## 6. 页面跳转关系
 
-主页面跳转关系如下：
+主页面关系调整为：
 
 ```text
-审核任务工作台
+顶部导航
-  -> 资料包导入页
+  -> 审核智能体
-  -> 法规完整性检查页
+  -> 资料包
-  -> 字段抽取与字段池页
+  -> 知识库
-  -> 一致性核查页
+  -> 处理历史
-  -> 风险预警页
+
-  -> Word 回填导出页
+审核智能体内部节点
-  -> 飞书通知视图
+  -> 资料包导入
+  -> 法规完整性检查
+  -> 字段抽取与字段池
+  -> 一致性核查
+  -> 风险预警
+  -> Word 回填导出
+  -> 飞书通知
 ```
 
 跨页关系约束：
@@ -173,16 +182,19 @@
 ### 7.2 HTML 结构要求
 
 - 一个全局 App Shell
-- 八个主页面 section
+- 四个顶层页面 section
+- 一个以对话节点为核心的审核智能体 section
 - 一个治理台抽屉层
 - 一份统一 mock 数据对象
 - 一组轻量 JavaScript 交互
 
 ### 7.3 必备交互
 
-- 切换 8 个页面视图
+- 切换 `审核智能体 / 资料包 / 知识库 / 处理历史` 视图
+- 切换会话历史
+- 点击对话节点定位到对应执行阶段
 - 展开 / 收起目录树
-- 切换流程任务卡片选中态
+- 资料包按产品名称或批次号搜索
 - 打开治理台抽屉
 - 切换治理对象 CRUD 子视图
 - 模拟 Word 导出状态切换
@@ -193,7 +205,7 @@
 本轮分页文档如下：
 
 1. [1.1.资料包导入页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.1.资料包导入页原型设计.md)
-2. [1.2.审核任务工作台原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.2.审核任务工作台原型设计.md)
+2. [1.2.审核智能体页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.2.审核智能体页原型设计.md)
 3. [1.3.法规完整性检查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.3.法规完整性检查页原型设计.md)
 4. [1.4.字段抽取与字段池页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.4.字段抽取与字段池页原型设计.md)
 5. [1.5.一致性核查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.5.一致性核查页原型设计.md)
@@ -225,7 +237,12 @@
 这套原型的核心讲法应统一为：
 
 ```text
-资料包治理 -> 法规完整性核查 -> 字段池沉淀 -> 一致性检查 -> 风险预警 -> Word 回填导出 -> 飞书协同闭环
+以对话为核心的审核智能体
+  -> 资料包解析与会话绑定
+  -> 节点式审核推进
+  -> 知识库 / RAG 解释
+  -> 风险与导出决策
+  -> 飞书协同闭环
 ```
 
-治理台负责回答“规则和知识如何维护”，工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。
+治理台负责回答“规则和知识如何维护”，审核智能体负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。