# 知识库

路径 `/knowledge`。知识库用来沉淀品牌资料、产品文档、行业资讯，作为 AI 文章生成时的上下文检索源。**没有官网的品牌，必须先在这里建好公司资料**，否则 AI 在文章生成时拿不到品牌上下文。

## 1. 页面结构

页面分两大块：

- **左侧分组树**：支持一级分组 + 二级子目录两层
- **右侧内容列表**：所选分组下的全部知识条目

顶部按钮：**添加知识**（默认打开"文档"上传弹窗）。

## 2. 分组管理

### 新建分组

- 左侧 **新建分组**：在根目录下创建一级分组
- 一级分组的"…"菜单 → **新建子目录**：在该分组下创建二级子目录

> 树最多两层：一级分组 + 子目录。子目录下不能再嵌子目录。

### 编辑 / 删除分组

每个分组节点的"…"菜单都有 **编辑** / **删除**：

- 编辑只改名
- 删除有强提示：
  - 删除一级目录会一并删掉它名下的二级目录和全部知识条目
  - 删除二级目录会一并删掉它名下的全部知识条目

## 3. 添加知识

点击右上角 **添加知识** 弹出的对话框里有三种来源类型：

### 文档（document）

- 支持本地文件批量上传（PDF、Word、Markdown 等）
- 上传后进入 AI 学习队列；学习完成后可作为生成文章时的检索源
- 文件大小、格式限制以平台后端为准

### 网站（website）

- 在文本框里粘贴网址，每行一条 URL
- **单次最多 3 个 URL**：超过会提示「URL 数量超出上限」并禁用提交按钮
- 后端会异步抓取页面正文 → 入索引 → 对外表现为一条知识条目

### 文本（text）

- 直接粘贴纯文本片段
- 支持一次提交多条；点击 **+ 添加文本** 可在弹窗里追加
- 每条需要填 **文本名称**（≤ 20 字）和 **文本内容**

> 添加任何类型的知识前，**必须先创建至少一个分组**，否则会提示「请先创建目录后再新增内容」。

## 4. 内容列表

字段：

| 列 | 说明 |
| --- | --- |
| **名称** | 文档名 / 网站标题 / 文本名 |
| **类型** | 文档 / 网站 / 文本 |
| **大小** | 字节数（自动单位换算） |
| **AI 学习** | 状态徽标（见下） |
| **上传时间** | 创建时间 |
| **操作** | 重试 / 查看 / 删除 |

### AI 学习状态

| 状态 | 含义 |
| --- | --- |
| **待处理** (`pending`) | 已收到但尚未开始解析 |
| **处理中** (`processing`) | 解析或向量化中 |
| **学习完成** (`completed`) | 已可被生成模块检索 |
| **失败** (`failed`) | 解析失败；列表里会显示 **重试** 按钮 |
| **已删除** (`deleted`) | 已逻辑删除，不再参与生成 |

> 失败原因常见：网页抓取超时、PDF 加密、文档过大被截断。失败后点击 **重试** 重新进队列。

### 操作

- **重试**（仅失败状态可见）：重新触发解析任务
- **查看**：抽屉式预览原文 + 解析摘要
- **删除**：二次确认，删除后该条目不再参与文章生成

## 5. 在文章生成里使用知识

知识库与生成模块的连接点：

- **模版向导第 1 步**：选了品牌后，AI 分析阶段会自动检索"该品牌相关的知识条目"作为上下文
- **仿写创作 → 引用知识库**：可在仿写表单里勾选具体知识条目，作为生成补充参考
- **自定义生成 / 自由创作**：当前版本不支持显式引用知识库（按品牌检索为隐式行为）

## 6. 起手最佳实践

如果你的品牌没有公司官网，建议至少补齐以下几条：

1. **网站类**：行业头部资讯网站、品牌过往媒体报道（粘贴 URL 即可）
2. **文档类**：公司介绍 PDF、产品白皮书、品牌故事文档
3. **文本类**：手写一段品牌定位 + 核心产品列表 + 目标用户描述（300~500 字即可）

把以上三类各放 1~2 条，AI 在写品牌相关文章时就能稳定拿到上下文，效果立竿见影。

## 7. 常见问题

- **添加按钮置灰**：先去左侧创建至少一个分组
- **网站 URL 提交后一直 pending**：网页站点防爬严格时常见；可考虑把页面正文复制后用「文本」方式重新添加
- **删除某条知识后文章生成结果没变**：检索结果有缓存，下次新建任务时才会生效