Bruce/DEMO-AGENT
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
bruce
2026-06-04 00:11:33 +08:00
parent b489dc1b37
commit 70d58c62fe
5 changed files with 228 additions and 155 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -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. 演示话术重点
- 强调本平台处理的是整套注册资料，不是单文档聊天。
- 强调资料包会与会话绑定，用户后续是围绕该产品资料持续对话和追溯。
- 强调压缩包、目录层级、页数和章节点是后续审核的事实基础。
- 强调异常箱的价值在于把“资料问题”前置，而不是等到审核后才发现。

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

@@ -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. 与知识库 / 治理台的关联入口
工作台页右上角提供：
- `规则版本总览`
- `模板版本总览`
- `责任人映射总览`
适合作为讲解治理能力的总入口。

162
docs/原型设计/1.2.审核智能体页原型设计.md Normal file
View File

@@ -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. 与知识库 / 治理台的关联入口
本页右侧或右上角提供：
- `规则版本总览`
- `模板版本总览`
- `责任人映射总览`
- `飞书配置总览`
适合作为讲解治理能力的总入口。

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

@@ -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. 与知识库 / 治理台的关联入口

83
docs/原型设计/1.整体原型设计.md
View File

@@ -19,18 +19,17 @@
## 2. 演示总动线
推荐演示顺序：
最新版原型采用“顶层 4 个 Tab + 对话内节点推进”的组织方式，推荐演示顺序如下：
1. 从“审核任务工作台”进入，先看 7 个流程任务卡片和当前批次状态。
2. 跳到“资料包导入页”，解释资料包、目录、页数和章节点识别。
3. 进入“法规完整性检查页”，展示缺失项、错放项和法规依据。
4. 进入“字段抽取与字段池页”，展示统一字段池、置信度和待复核字段。
5. 进入“一致性核查页”，展示字段冲突和混档风险。
6. 进入“风险预警页”，说明总风险等级、是否通过、整改建议和责任角色。
7. 进入“Word 回填导出页”，说明自动回填、导出拦截和下载入口。
8. 最后展示“飞书通知视图”，形成协同闭环。
1. 先进入 `审核智能体`，展示左侧会话历史、中间对话区、右侧上传区和任务卡片区。
2. 在对话页上传资料包，触发目录汇总、完整性检查、字段抽取、一致性核查和风险结论节点。
3. 点击对话节点，解释每一步的结构化结果如何在右侧卡片实时更新状态。
4. 切换到 `资料包`，展示资料包列表、按产品名称搜索、资料包与会话绑定关系，以及目录、页数、章节点结果。
5. 切换到 `知识库`，说明法规资料、业务资料、RAG 切片、字段 Schema、模板映射、责任人映射和飞书配置如何治理。
6. 切换到 `处理历史`，说明如何按批次、产品和风险状态回看历史会话、资料规模和通知留痕。
7. 返回对话中的风险与导出节点，最后展示飞书完成通知或异常通知如何直接 `@` 处理人并携带 Web 详情链接。
知识库与治理台不作为独立主线页面插入，而是作为上述页面的配置入口、侧边抽屉或管理弹层出现，用来回答“规则从哪里来、谁来维护、如何增删改查”。
法规依据不再以单独一级页面存在，而是作为知识库中的法规资料，由 RAG 在对话节点中返回依据说明。
## 3. 统一视觉风格
@@ -44,8 +43,8 @@
### 3.2 色彩建议
- 主背景：浅灰蓝与米白渐变，形成轻量但不空泛的工作台底色。
- 主强调色：深青蓝，用于导航、主按钮、激活态和重点数值。
- 主背景：以白色为主，辅以极浅灰蓝，保证整体简洁和专业。
- 主强调色：克制的深青蓝，用于导航、主按钮、激活态和重点数值。
- 风险色：铜橙、深红，用于缺失、冲突、高风险、阻断状态。
- 成功色：低饱和绿色，用于完成、可通过、已同步状态。
- 中性色：冷灰，用于说明文字、边框、标签和禁用态。
@@ -60,16 +59,19 @@
### 4.1 全局导航
- 顶部固定展示：平台名称、当前批次、产品名称、流程类型、全局风险状态。
- 左侧流程导航固定展示 8 个主页面入口。
- 每个页面右上角保留“打开治理台”入口。
- 顶部固定展示：平台名称、顶层 Tab、右上角用户信息。
- 顶层 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 解释
-> 风险与导出决策
-> 飞书协同闭环
```
治理台负责回答“规则和知识如何维护”，工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。
治理台负责回答“规则和知识如何维护”，审核智能体负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。