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

This commit is contained in:
2026-06-04 00:11:33 +08:00
parent b489dc1b37
commit 70d58c62fe
5 changed files with 228 additions and 155 deletions

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 解释
-> 风险与导出决策
-> 飞书协同闭环
```
治理台负责回答“规则和知识如何维护”,工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。
治理台负责回答“规则和知识如何维护”,审核智能体负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。