# 知识库与治理台原型设计

## 1. 页面目标

作为整套原型的治理能力承载层，统一展示法规知识、RAG 证据、字段标准、模板映射、责任人和飞书配置如何被维护，并明确支持完整 CRUD。

在最新版产品形态中，`知识库` 已升级为四个一级入口之一；同时仍允许从审核智能体、资料包和处理历史页通过治理入口快速打开对应对象详情。

## 2. 适用角色

- 规则维护人员
- 平台管理员
- 注册资料平台主管
- 演示讲解人

## 3. 治理台布局分区

建议采用“左侧治理对象导航 + 中部列表 + 右侧详情 / 编辑抽屉”的结构。

左侧对象导航固定包含：

1. 法规规则包
2. RAG 文档源
3. RAG 切片
4. 字段 Schema
5. Word 模板与字段映射
6. 责任人映射
7. 飞书通知配置

## 4. 法规规则包 CRUD

### 4.1 列表字段

- 规则包名称
- 适用流程
- 版本号
- 启用状态
- 最近更新时间
- 维护人

### 4.2 必备操作

- 新增规则包
- 编辑规则包
- 复制新版本
- 启用 / 停用
- 删除未生效草稿
- 查看章节要求详情

### 4.3 原型交互要求

- 点击规则包行，右侧打开章节树与要求项详情。
- 点击“新增规则包”，打开表单弹窗。

## 5. RAG 文档源 CRUD

### 5.1 列表字段

- 文档名称
- 文档类型
- 来源类别
- 版本号
- 入库状态
- 切片数量
- 最近同步时间

### 5.2 必备操作

- 上传新文档源
- 替换版本
- 编辑元数据
- 停用文档源
- 删除失效文档源
- 重新入库

### 5.3 原型交互要求

- 支持按“法规 / 模板 / 业务资料”过滤。
- 点击文档源查看切片预览和召回配置。

## 6. RAG 切片 CRUD

### 6.1 列表字段

- 切片 ID
- 所属文档
- 章节
- 片段摘要
- 切片长度
- 召回状态
- 最近更新时间

### 6.2 必备操作

- 新增手工切片
- 编辑切片摘要
- 合并切片
- 拆分切片
- 删除切片
- 重建向量
- 调整召回阈值

### 6.3 原型交互要求

- 点击切片行，右侧展示原文预览和命中场景。
- 支持“查看证据命中历史”的详情抽屉。

## 7. 字段 Schema CRUD

### 7.1 列表字段

- 字段编码
- 中文名
- 字段类型
- 是否可回填
- 是否强一致
- 启用状态
- 版本号

### 7.2 必备操作

- 新增字段
- 编辑字段
- 启停字段
- 删除草稿字段
- 复制 schema 版本

### 7.3 原型交互要求

- 点击字段查看来源优先级和适用页面。
- 支持切换“回填字段 / 强一致字段 / 全部字段”。

## 8. Word 模板与字段映射 CRUD

### 8.1 列表字段

- 模板名称
- 输出类型
- 版本号
- 占位符数量
- 启用状态
- 最近更新时间

### 8.2 必备操作

- 上传模板
- 编辑模板元数据
- 编辑占位符映射
- 启用 / 停用版本
- 删除未发布版本
- 预览模板

### 8.3 原型交互要求

- 点击模板打开占位符和字段映射详情。
- 支持查看“阻断条件影响哪些占位符”。

## 9. 责任人映射 CRUD

### 9.1 列表字段

- 映射类型
- 章节 / 风险类型
- 责任角色
- 责任人姓名
- 部门
- 飞书用户 ID
- 飞书 Open ID
- 飞书昵称
- 是否启用通知
- 启用状态
- 备注

### 9.2 必备操作

- 新增映射
- 编辑映射
- 启停映射
- 删除映射
- 批量导入映射

### 9.3 原型交互要求

- 点击某条映射可联动查看受影响风险项或飞书卡片预览。

## 10. 飞书通知配置 CRUD

### 10.1 列表字段

- 配置名称
- 群聊 / 机器人标识
- 消息模板
- 触发原因
- Web 链接模板
- 启用状态
- 最近测试状态

### 10.2 必备操作

- 新增配置
- 编辑配置
- 切换消息模板
- 启用 / 停用
- 删除草稿配置
- 发送测试消息

### 10.3 原型交互要求

- 支持查看 interactive card 模板预览。
- 支持查看最近一次回执记录。
- 固定展示两类触发原因：`task_completed`、`task_failed`。

## 11. 与业务页面的入口关系

各主页面的治理入口分配如下：

- 资料包导入页：RAG 文档源、章节点规则
- 法规完整性检查页：法规规则包、RAG 切片
- 字段抽取页：字段 Schema、字段来源优先级
- 一致性核查页：强一致规则
- 风险预警页：风险规则、责任人映射
- Word 回填页：模板与字段映射
- 飞书通知视图：责任人映射、飞书通知配置

## 12. 演示话术重点

- 强调这套系统不是一次性写死，而是可以被维护和演进。
- 强调法规判断、RAG 证据、字段标准、模板映射和飞书配置都能被可视化治理。
- 强调 CRUD 的存在，说明平台具备从 Demo 走向实际业务平台的治理基础。