feat(knowledge): enhance knowledge base management with improved interfaces and components
refactor(interfaces): add comprehensive documentation and type definitions feat(components): implement empty state handling and team filtering in KnowledgeGridView refactor(hooks): optimize knowledge list fetching with better parameter handling style(interfaces): improve code readability with detailed comments
This commit is contained in:
@@ -1,168 +1,355 @@
|
||||
import type { RunningStatus } from '@/constants/knowledge';
|
||||
|
||||
// knowledge base
|
||||
/**
|
||||
* 知识库接口定义
|
||||
* 包含知识库的基本信息、配置和状态
|
||||
*/
|
||||
export interface IKnowledge {
|
||||
/** 知识库头像，可选字段 */
|
||||
avatar?: any;
|
||||
/** 知识库中的文档块数量 */
|
||||
chunk_num: number;
|
||||
/** 创建日期（字符串格式） */
|
||||
create_date: string;
|
||||
/** 创建时间戳 */
|
||||
create_time: number;
|
||||
/** 创建者ID */
|
||||
created_by: string;
|
||||
/** 知识库描述 */
|
||||
description: string;
|
||||
/** 知识库中的文档数量 */
|
||||
doc_num: number;
|
||||
/** 知识库语言 */
|
||||
language: string;
|
||||
/** 知识库唯一标识符 */
|
||||
id: string;
|
||||
/** 知识库名称 */
|
||||
name: string;
|
||||
/** 解析器配置 */
|
||||
parser_config: ParserConfig;
|
||||
/** 解析器ID */
|
||||
parser_id: string;
|
||||
/** 管道ID */
|
||||
pipeline_id: string;
|
||||
/** 管道名称 */
|
||||
pipeline_name: string;
|
||||
/** 管道头像 */
|
||||
pipeline_avatar: string;
|
||||
/** 权限设置 */
|
||||
permission: string;
|
||||
/** 相似度阈值 */
|
||||
similarity_threshold: number;
|
||||
/** 知识库状态 */
|
||||
status: string;
|
||||
/** 租户ID */
|
||||
tenant_id: string;
|
||||
/** 令牌数量 */
|
||||
token_num: number;
|
||||
/** 更新日期（字符串格式） */
|
||||
update_date: string;
|
||||
/** 更新时间戳 */
|
||||
update_time: number;
|
||||
/** 向量相似度权重 */
|
||||
vector_similarity_weight: number;
|
||||
/** 嵌入模型ID */
|
||||
embd_id: string;
|
||||
/** 昵称 */
|
||||
nickname: string;
|
||||
/** 操作权限级别 */
|
||||
operator_permission: number;
|
||||
/** 知识库大小（字节） */
|
||||
size: number;
|
||||
/** Raptor任务完成时间，可选 */
|
||||
raptor_task_finish_at?: string;
|
||||
/** Raptor任务ID，可选 */
|
||||
raptor_task_id?: string;
|
||||
/** 思维导图任务完成时间，可选 */
|
||||
mindmap_task_finish_at?: string;
|
||||
/** 思维导图任务ID，可选 */
|
||||
mindmap_task_id?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* 知识库查询结果接口
|
||||
* 包含知识库列表和总数
|
||||
*/
|
||||
export interface IKnowledgeResult {
|
||||
/** 知识库列表 */
|
||||
kbs: IKnowledge[];
|
||||
/** 知识库总数 */
|
||||
total: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Raptor配置接口
|
||||
* 用于配置是否启用Raptor功能
|
||||
*/
|
||||
export interface Raptor {
|
||||
/** 是否使用Raptor */
|
||||
use_raptor: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析器配置接口
|
||||
* 定义文档解析的各种参数和选项
|
||||
*/
|
||||
export interface ParserConfig {
|
||||
/** 起始页码，可选 */
|
||||
from_page?: number;
|
||||
/** 结束页码，可选 */
|
||||
to_page?: number;
|
||||
/** 自动关键词数量，可选 */
|
||||
auto_keywords?: number;
|
||||
/** 自动问题数量，可选 */
|
||||
auto_questions?: number;
|
||||
/** 每个文档块的令牌数量，可选 */
|
||||
chunk_token_num?: number;
|
||||
/** 分隔符，可选 */
|
||||
delimiter?: string;
|
||||
/** 是否将HTML转换为Excel格式，可选 */
|
||||
html4excel?: boolean;
|
||||
/** 是否启用布局识别，可选 */
|
||||
layout_recognize?: boolean;
|
||||
/** Raptor配置，可选 */
|
||||
raptor?: Raptor;
|
||||
/** 标签知识库ID列表，可选 */
|
||||
tag_kb_ids?: string[];
|
||||
/** 顶部标签数量，可选 */
|
||||
topn_tags?: number;
|
||||
/** GraphRAG配置，可选 */
|
||||
graphrag?: { use_graphrag?: boolean };
|
||||
}
|
||||
|
||||
/**
|
||||
* 知识库文件解析器配置接口
|
||||
* 定义文件解析的具体参数
|
||||
*/
|
||||
export interface IKnowledgeFileParserConfig {
|
||||
/** 每个文档块的令牌数量 */
|
||||
chunk_token_num: number;
|
||||
/** 是否启用布局识别 */
|
||||
layout_recognize: boolean;
|
||||
/** 页面范围数组 */
|
||||
pages: number[][];
|
||||
/** 任务页面大小 */
|
||||
task_page_size: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* 知识库文件接口
|
||||
* 定义知识库中单个文件的信息和状态
|
||||
*/
|
||||
export interface IKnowledgeFile {
|
||||
/** 文件中的文档块数量 */
|
||||
chunk_num: number;
|
||||
/** 创建日期（字符串格式） */
|
||||
create_date: string;
|
||||
/** 创建时间戳 */
|
||||
create_time: number;
|
||||
/** 创建者ID */
|
||||
created_by: string;
|
||||
/** 文件唯一标识符 */
|
||||
id: string;
|
||||
/** 所属知识库ID */
|
||||
kb_id: string;
|
||||
/** 文件存储位置 */
|
||||
location: string;
|
||||
/** 文件名称 */
|
||||
name: string;
|
||||
/** 解析器ID */
|
||||
parser_id: string;
|
||||
/** 处理开始时间，可选 */
|
||||
process_begin_at?: any;
|
||||
/** 处理持续时间 */
|
||||
process_duration: number;
|
||||
progress: number; // parsing process
|
||||
progress_msg: string; // parsing log
|
||||
run: RunningStatus; // parsing status
|
||||
/** 解析进度百分比 */
|
||||
progress: number;
|
||||
/** 解析进度消息 */
|
||||
progress_msg: string;
|
||||
/** 解析运行状态 */
|
||||
run: RunningStatus;
|
||||
/** 文件大小（字节） */
|
||||
size: number;
|
||||
/** 文件来源类型 */
|
||||
source_type: string;
|
||||
status: string; // enabled
|
||||
thumbnail?: any; // base64
|
||||
/** 文件状态（启用/禁用） */
|
||||
status: string;
|
||||
/** 文件缩略图（base64编码），可选 */
|
||||
thumbnail?: any;
|
||||
/** 文件中的令牌数量 */
|
||||
token_num: number;
|
||||
/** 文件类型 */
|
||||
type: string;
|
||||
/** 更新日期（字符串格式） */
|
||||
update_date: string;
|
||||
/** 更新时间戳 */
|
||||
update_time: number;
|
||||
/** 解析器配置 */
|
||||
parser_config: IKnowledgeFileParserConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* 租户信息接口
|
||||
* 定义租户的各种服务配置
|
||||
*/
|
||||
export interface ITenantInfo {
|
||||
/** 自动语音识别服务ID */
|
||||
asr_id: string;
|
||||
/** 嵌入模型服务ID */
|
||||
embd_id: string;
|
||||
/** 图像转文本服务ID */
|
||||
img2txt_id: string;
|
||||
/** 大语言模型服务ID */
|
||||
llm_id: string;
|
||||
/** 租户名称 */
|
||||
name: string;
|
||||
/** 解析器ID列表 */
|
||||
parser_ids: string;
|
||||
/** 租户角色 */
|
||||
role: string;
|
||||
/** 租户ID */
|
||||
tenant_id: string;
|
||||
/** 聊天服务ID */
|
||||
chat_id: string;
|
||||
/** 语音转文本服务ID */
|
||||
speech2text_id: string;
|
||||
/** 文本转语音服务ID */
|
||||
tts_id: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* 文档块接口
|
||||
* 定义知识库中单个文档块的信息
|
||||
*/
|
||||
export interface IChunk {
|
||||
available_int: number; // Whether to enable, 0: not enabled, 1: enabled
|
||||
/** 是否启用，0：未启用，1：启用 */
|
||||
available_int: number;
|
||||
/** 文档块唯一标识符 */
|
||||
chunk_id: string;
|
||||
/** 带权重的内容 */
|
||||
content_with_weight: string;
|
||||
/** 所属文档ID */
|
||||
doc_id: string;
|
||||
/** 所属文档名称 */
|
||||
doc_name: string;
|
||||
/** 关联图像ID */
|
||||
image_id: string;
|
||||
/** 重要关键词列表，可选 */
|
||||
important_kwd?: string[];
|
||||
question_kwd?: string[]; // keywords
|
||||
/** 问题关键词列表，可选 */
|
||||
question_kwd?: string[];
|
||||
/** 标签关键词列表，可选 */
|
||||
tag_kwd?: string[];
|
||||
/** 位置信息数组 */
|
||||
positions: number[][];
|
||||
/** 标签特征映射，可选 */
|
||||
tag_feas?: Record<string, number>;
|
||||
}
|
||||
|
||||
/**
|
||||
* 测试文档块接口
|
||||
* 用于知识库测试和检索的文档块信息
|
||||
*/
|
||||
export interface ITestingChunk {
|
||||
/** 文档块唯一标识符 */
|
||||
chunk_id: string;
|
||||
/** 内容的LTKS表示 */
|
||||
content_ltks: string;
|
||||
/** 带权重的内容 */
|
||||
content_with_weight: string;
|
||||
/** 所属文档ID */
|
||||
doc_id: string;
|
||||
/** 所属文档名称 */
|
||||
doc_name: string;
|
||||
/** 图像ID（旧字段） */
|
||||
img_id: string;
|
||||
/** 图像ID */
|
||||
image_id: string;
|
||||
/** 重要关键词列表 */
|
||||
important_kwd: any[];
|
||||
/** 所属知识库ID */
|
||||
kb_id: string;
|
||||
/** 相似度分数 */
|
||||
similarity: number;
|
||||
/** 词汇相似度分数 */
|
||||
term_similarity: number;
|
||||
/** 向量表示 */
|
||||
vector: number[];
|
||||
/** 向量相似度分数 */
|
||||
vector_similarity: number;
|
||||
/** 高亮显示的内容 */
|
||||
highlight: string;
|
||||
/** 位置信息数组 */
|
||||
positions: number[][];
|
||||
/** 文档名称关键词 */
|
||||
docnm_kwd: string;
|
||||
/** 文档类型关键词 */
|
||||
doc_type_kwd: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* 测试文档接口
|
||||
* 用于知识库测试的文档统计信息
|
||||
*/
|
||||
export interface ITestingDocument {
|
||||
/** 文档中的块数量 */
|
||||
count: number;
|
||||
/** 文档ID */
|
||||
doc_id: string;
|
||||
/** 文档名称 */
|
||||
doc_name: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* 测试结果接口
|
||||
* 知识库测试的完整结果
|
||||
*/
|
||||
export interface ITestingResult {
|
||||
/** 匹配的文档块列表 */
|
||||
chunks: ITestingChunk[];
|
||||
/** 匹配的文档列表 */
|
||||
documents: ITestingDocument[];
|
||||
/** 总匹配数量 */
|
||||
total: number;
|
||||
/** 标签统计，可选 */
|
||||
labels?: Record<string, number>;
|
||||
}
|
||||
|
||||
/**
|
||||
* 下一代测试结果接口
|
||||
* 改进版本的知识库测试结果
|
||||
*/
|
||||
export interface INextTestingResult {
|
||||
/** 匹配的文档块列表 */
|
||||
chunks: ITestingChunk[];
|
||||
/** 文档聚合统计 */
|
||||
doc_aggs: ITestingDocument[];
|
||||
/** 总匹配数量 */
|
||||
total: number;
|
||||
/** 标签统计，可选 */
|
||||
labels?: Record<string, number>;
|
||||
/** 是否已运行，可选 */
|
||||
isRuned?: boolean;
|
||||
}
|
||||
|
||||
export type IRenameTag = { fromTag: string; toTag: string };
|
||||
/**
|
||||
* 重命名标签类型
|
||||
* 用于标签重命名操作
|
||||
*/
|
||||
export type IRenameTag = {
|
||||
/** 原标签名 */
|
||||
fromTag: string;
|
||||
/** 新标签名 */
|
||||
toTag: string;
|
||||
};
|
||||
|
||||
/**
|
||||
* 知识图谱接口
|
||||
* 定义知识库的图谱结构
|
||||
*/
|
||||
export interface IKnowledgeGraph {
|
||||
/** 图谱数据结构 */
|
||||
graph: Record<string, any>;
|
||||
/** 思维导图数据（已注释） */
|
||||
// mind_map: TreeData;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user