M2-08 Knowledge Ops Module #28

New Issue

wangdl · 2026-05-22T21:09:50+08:00

wangdl commented

2026-05-22 21:09:50 +08:00

目标

设计知习知识库运维模块（Knowledge Ops），为 Admin 提供导入任务监控、失败重试、Qdrant 索引状态查看、chunk 管理和候选知识点质量巡检能力。

本 Issue 只做模块架构设计，不直接实现代码。

背景说明

当用户上传资料后，Admin 需要能监控导入任务的进度、排查失败原因、手动重试失败任务。同时需要能查看 Qdrant 的索引状态、检查 chunk 质量、巡检候选知识点的生成质量。

Knowledge Ops 是 Admin 运维知识库的视角，不直接操作 C 端数据，而是通过各模块的 QueryService 读取数据和触发操作。

模块职责

本模块负责：
- 导入任务 Admin 视图（列表、状态、进度、错误信息）
- 失败任务手动重试
- Qdrant 索引状态查看（collection 信息、向量数量、索引状态）
- Chunk 状态查看（按 Material/Source）
- 候选知识点质量巡检（查看 Candidate 列表、抽查质量）
- RAG 召回调试（输入查询文本查看检索结果）
本模块不负责：
- 直接修改 C 端数据
- 导入任务的业务逻辑（走 Ingestion Module）
- Qdrant 的运维配置（走 Vector Module 的 Admin 接口）
- 知识库本身的 CRUD（走 Workspace & KnowledgeBase Module）

核心对象（复用已有模块）

DocumentImport（来自 Ingestion）
KnowledgeChunk（来自 Material & Source）
ImportCandidate（来自 Artifact）
VectorPoint（来自 Vector & Retrieval）
Qdrant Collection（来自 Vector & Retrieval）

基础设施依赖

本模块为纯 Admin 视图层，不引入新的基础设施依赖。所有数据通过各模块的 QueryService 读取。

API 设计

AAPI：

导入任务列表和详情
失败任务重试
Qdrant 状态查询
Chunk 列表（按 Material）
Candidate 质量巡检列表
RAG 召回调试（输入查询，返回检索结果）

Admin 视图设计

导入任务监控页：
- 任务列表（状态、进度、创建时间、耗时）
- 详情（步骤日志、错误信息）
- 失败任务重试按钮
- 按状态/时间筛选
Qdrant 状态页：
- Collection 概览（名称、向量数、状态）
- 索引重建触发
Chunk 状态页：
- 按 Material 查看 chunks
- Chunk 内容和状态
候选知识点巡检页：
- Candidate 列表（按质量/状态筛选）
- 抽查 Candidate 内容和对应的 Source 来源
RAG 调试页：
- 输入查询文本
- 查看检索结果（含相关度和来源）
- 查看 rerank 前后对比

交付检查

路由归属：AAPI
是否需要 Prisma migration：否（复用已有模块表）
是否需要 MySQL：否（通过 QueryService 只读）
是否需要 AuditLog：是（手动重试操作需审计）
是否需要 Admin 视图：是

验收标准

导入任务 Admin 监控视图设计
失败重试流程设计
Qdrant 状态查看视图设计
Chunk 管理视图设计
候选知识点巡检视图设计
RAG 召回调试工具设计
集成测试覆盖 Admin 视图数据查询

禁止事项

禁止 Knowledge Ops 绕过 QueryService 直接操作数据库
禁止 Knowledge Ops 绕过业务模块直接修改 C 端数据
禁止手动重试不做审计记录
禁止 RAG 调试工具暴露给 C 端用户

不建议当前阶段实现

批量重试和自动重试规则
Chunk 质量自动评估
候选知识点自动质量评分

## 目标设计知习知识库运维模块（Knowledge Ops），为 Admin 提供导入任务监控、失败重试、Qdrant 索引状态查看、chunk 管理和候选知识点质量巡检能力。本 Issue 只做模块架构设计，不直接实现代码。 ## 背景说明当用户上传资料后，Admin 需要能监控导入任务的进度、排查失败原因、手动重试失败任务。同时需要能查看 Qdrant 的索引状态、检查 chunk 质量、巡检候选知识点的生成质量。 Knowledge Ops 是 Admin 运维知识库的视角，不直接操作 C 端数据，而是通过各模块的 QueryService 读取数据和触发操作。 ## 模块职责 1. 本模块负责： - 导入任务 Admin 视图（列表、状态、进度、错误信息） - 失败任务手动重试 - Qdrant 索引状态查看（collection 信息、向量数量、索引状态） - Chunk 状态查看（按 Material/Source） - 候选知识点质量巡检（查看 Candidate 列表、抽查质量） - RAG 召回调试（输入查询文本查看检索结果） 2. 本模块不负责： - 直接修改 C 端数据 - 导入任务的业务逻辑（走 Ingestion Module） - Qdrant 的运维配置（走 Vector Module 的 Admin 接口） - 知识库本身的 CRUD（走 Workspace & KnowledgeBase Module） ## 核心对象（复用已有模块） - DocumentImport（来自 Ingestion） - KnowledgeChunk（来自 Material & Source） - ImportCandidate（来自 Artifact） - VectorPoint（来自 Vector & Retrieval） - Qdrant Collection（来自 Vector & Retrieval） ## 基础设施依赖本模块为纯 Admin 视图层，不引入新的基础设施依赖。所有数据通过各模块的 QueryService 读取。 ## API 设计 AAPI： - 导入任务列表和详情 - 失败任务重试 - Qdrant 状态查询 - Chunk 列表（按 Material） - Candidate 质量巡检列表 - RAG 召回调试（输入查询，返回检索结果） ## Admin 视图设计 1. 导入任务监控页： - 任务列表（状态、进度、创建时间、耗时） - 详情（步骤日志、错误信息） - 失败任务重试按钮 - 按状态/时间筛选 2. Qdrant 状态页： - Collection 概览（名称、向量数、状态） - 索引重建触发 3. Chunk 状态页： - 按 Material 查看 chunks - Chunk 内容和状态 4. 候选知识点巡检页： - Candidate 列表（按质量/状态筛选） - 抽查 Candidate 内容和对应的 Source 来源 5. RAG 调试页： - 输入查询文本 - 查看检索结果（含相关度和来源） - 查看 rerank 前后对比 ## 交付检查 - [ ] 路由归属：AAPI - [ ] 是否需要 Prisma migration：否（复用已有模块表） - [ ] 是否需要 MySQL：否（通过 QueryService 只读） - [ ] 是否需要 AuditLog：是（手动重试操作需审计） - [ ] 是否需要 Admin 视图：是 ## 验收标准 1. 导入任务 Admin 监控视图设计 2. 失败重试流程设计 3. Qdrant 状态查看视图设计 4. Chunk 管理视图设计 5. 候选知识点巡检视图设计 6. RAG 召回调试工具设计 7. 集成测试覆盖 Admin 视图数据查询 ## 禁止事项 - 禁止 Knowledge Ops 绕过 QueryService 直接操作数据库 - 禁止 Knowledge Ops 绕过业务模块直接修改 C 端数据 - 禁止手动重试不做审计记录 - 禁止 RAG 调试工具暴露给 C 端用户 ## 不建议当前阶段实现 - 批量重试和自动重试规则 - Chunk 质量自动评估 - 候选知识点自动质量评分

wangdl added this to the M2：知识库主链路闭环（P1） milestone 2026-05-22 21:09:50 +08:00

wangdl self-assigned this 2026-05-22 21:09:50 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#28