110 lines
4.2 KiB
Markdown
110 lines
4.2 KiB
Markdown
|
# 知识库
|
|||
|
|
|
|||
|
|
路径 `/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**：网页站点防爬严格时常见；可考虑把页面正文复制后用「文本」方式重新添加
|
|||
|
|
- **删除某条知识后文章生成结果没变**：检索结果有缓存，下次新建任务时才会生效
|