# 知识库管理

> 文档归集、智能解析、分块检索 —— 构建你的专属知识资产

---

## 功能概览

知识助理 的知识库管理是整个平台的基础 —— 将各类文档上传入库后，AI 对话才能"言之有据"。支持 PDF、Word、Markdown、纯文本、图片等多种格式，系统自动解析并切分为可检索的知识片段。

---

## 1. 知识库列表

以 **卡片网格** 形式展示所有知识库，一目了然：

**每张卡片展示：**
- 知识库名称与描述
- 文档数量统计
- 创建时间
- 置顶标记（常用知识库可固定在顶部）

**顶部统计栏** 展示全局数据：
- 知识库总数
- 知识文档总数
- 存储用量与配额进度条

### 系统知识库

知识助理 预置了两个系统级知识库，配有专属图标，始终置顶显示：

| 系统知识库 | 说明 |
|------------|------|
| **微信转发** | 通过微信转发的文章、文档自动归集于此 |
| **网页笔记** | 通过浏览器插件收藏的网页内容存放于此 |

系统知识库不可删除或重命名，是 知识助理 **全渠道知识收集** 的核心载体。

---

## 2. 创建与管理知识库

### 创建知识库

点击 **「创建知识库」** 按钮，选择知识库类型并填写名称、描述即可创建：

| 类型 | 说明 |
|------|------|
| **Wiki 知识库（推荐）** | 上传文档后 AI 自动解析，生成结构化 Wiki 页面、知识图谱与目录树，适合知识沉淀与可视化浏览 |
| **普通知识库** | 仅做文档解析与检索，不生成 Wiki 图谱，适合简单场景 |

> 已创建的 Wiki 知识库卡片会带 **Wiki 徽标**，鼠标悬停可查看说明。

### 管理操作

| 操作 | 说明 |
|------|------|
| **置顶 / 取消置顶** | 将常用知识库固定在列表顶部 |
| **重命名** | 修改知识库名称 |
| **删除** | 删除知识库及其所有文档（需二次确认） |

### 搜索

- 顶部搜索栏支持按名称搜索知识库
- 快捷键 ⌘/Ctrl + K 打开全局搜索

**搜索命中按类型分组展示**，每组按相关度降序排列：

| 分组 | 说明 |
|------|------|
| **知识库** | 知识库名称 / 描述匹配（仅列表页全局搜索显示） |
| **文件名匹配** | 文档文件名或标题命中 |
| **关键词匹配** | 文档正文分词命中 |
| **语义检索** | 向量语义相似度召回 |

同一条文档若命中多个分组，按 **文件名 > 关键词 > 语义** 的优先级去重，避免重复展示。全局搜索支持键盘方向键导航和回车跳转。

---

## 3. 文档上传

进入知识库详情页后，可通过多种方式添加文档：

### 文件上传

| 方式 | 说明 |
|------|------|
| **单文件上传** | 选择单个文件 |
| **批量上传** | 同时选择多个文件 |
| **文件夹上传** | 选择整个文件夹，自动遍历所有文件 |
| **拖拽上传** | 将文件拖入页面即可上传 |

**支持的文件格式：**

| 格式 | 扩展名 |
|------|--------|
| 文档 | `.pdf` `.docx` `.doc` `.txt` `.md` |
| 图片 | `.png` `.jpg` `.jpeg` `.gif` `.webp` |

### 网页抓取

输入 URL 地址，系统自动抓取网页内容并解析入库。适合收集在线文章、技术文档等内容。

### 手动编辑

内置 Markdown 编辑器，左右分栏布局（编辑器 + 实时预览），支持在线创建和编辑文档。

---

## 4. 文档解析

上传的文档会经过智能解析流水线自动处理：

**文档上传 → 格式识别 → 内容提取 → 文本分块 → 向量化 → 入库完成**

### 解析状态

| 状态 | 说明 |
|------|------|
| **解析中** | 文档正在处理，系统自动轮询直到完成 |
| **收尾中** | 正文解析完成，正在生成向量索引等收尾工作 |
| **已完成** | 解析成功，可用于知识检索 |
| **失败** | 解析出错，可查看错误信息并重试 |
| **删除中** | 文档正在被删除，删除完成后从列表移除 |

### 分块查看

解析完成后，可查看文档被切分的知识片段：

- 展示每个分块的文本内容
- 图片分块显示缩略图
- 支持编辑单个分块内容

---

## 5. 批量操作

选中多个文档后，可进行批量处理：

| 操作 | 说明 |
|------|------|
| **批量删除** | 删除选中文档 |
| **批量下载** | 打包下载 |
| **批量移动** | 移动到其他知识库 |
| **批量打标签** | 添加分类标签 |

---

## 6. 文档预览

点击文档可打开全屏预览弹窗：

- PDF 文档在线渲染
- 图片文档放大查看
- Markdown 文档格式化展示
- 支持下载原始文件

---

## 7. Wiki 知识库

Wiki 知识库是基于 AI 自动整理的专项知识库类型，上传文档后系统自动解析内容，生成结构化 Wiki 页面、知识图谱与目录树，方便快速浏览知识体系。

### 解析流程

创建 Wiki 知识库并上传文档后，系统执行两阶段解析：

1. **文档解析**：与普通知识库一致，先完成正文解析与向量化
2. **Wiki 整理**：解析完成后自动生成 Wiki 页面、图谱节点与目录结构，页面内展示解析进度，完成后自动刷新

> 单知识库文档数上限 100 篇（包含 Wiki 整理环节的资源开销）。

### Wiki 图谱

图谱以 **节点 - 连线** 形式展示知识实体之间的关系：

| 节点类型 | 说明 |
|------|------|
| **概述** | 文档核心内容总结 |
| **实体** | 文档中的具体事物（如人名、产品、组织） |
| **概念** | 抽象概念与定义 |
| **综合** | 跨文档的归纳结论 |
| **对比** | 多个实体的对比关系 |

- 鼠标悬停节点可查看该节点对应内容的摘要
- 点击节点选中后，可查看详情并在侧栏联动展示
- 图谱支持按节点类型筛选，只看某一类关系

### 目录树

Wiki 知识库提供层级目录树，按 **概述 / 实体 / 概念** 等类型组织文档内容，点击条目可快速定位到对应 Wiki 页面。

### 入口

- 知识库详情页顶部提供 **「文档列表」/「Wiki」** 两个 Tab 切换
- Wiki 知识库才显示 Wiki Tab（普通知识库无此入口）
- 支持 URL 带 `?tab=wiki` 直达 Wiki 视图