# 知识库管理
文档归集、智能解析、分块检索 —— 构建你的专属知识资产
# 功能概览
知识助理 的知识库管理是整个平台的基础 —— 将各类文档上传入库后，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 知识库并上传文档后，系统执行两阶段解析：
- 文档解析：与普通知识库一致，先完成正文解析与向量化
- Wiki 整理：解析完成后自动生成 Wiki 页面、图谱节点与目录结构，页面内展示解析进度，完成后自动刷新
单知识库文档数上限 100 篇（包含 Wiki 整理环节的资源开销）。
# Wiki 图谱
图谱以 节点 - 连线 形式展示知识实体之间的关系：
| 节点类型 | 说明 |
|---|---|
| 概述 | 文档核心内容总结 |
| 实体 | 文档中的具体事物（如人名、产品、组织） |
| 概念 | 抽象概念与定义 |
| 综合 | 跨文档的归纳结论 |
| 对比 | 多个实体的对比关系 |
- 鼠标悬停节点可查看该节点对应内容的摘要
- 点击节点选中后，可查看详情并在侧栏联动展示
- 图谱支持按节点类型筛选，只看某一类关系
# 目录树
Wiki 知识库提供层级目录树，按 概述 / 实体 / 概念 等类型组织文档内容，点击条目可快速定位到对应 Wiki 页面。
# 入口
- 知识库详情页顶部提供 「文档列表」/「Wiki」 两个 Tab 切换
- Wiki 知识库才显示 Wiki Tab（普通知识库无此入口）
- 支持 URL 带
?tab=wiki直达 Wiki 视图