Files
geo/user-manual/06-知识库.md
T
root ab62d666b4 docs(user-manual): add product user manual aligned to live code
Cover onboarding, workspace, article creation, brand library, media
publishing, knowledge base, image library, GEO tracking, desktop client,
KOL marketplace, AI points, and FAQ — sourced from actual views and i18n
rather than the v1 PRD.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 00:20:47 +08:00

110 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 知识库
路径 `/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**:网页站点防爬严格时常见;可考虑把页面正文复制后用「文本」方式重新添加
- **删除某条知识后文章生成结果没变**:检索结果有缓存,下次新建任务时才会生效