Knowledge Base Skill - 多业务知识库管理（支持图片 + OCR）

📖 功能概述

支持按业务类型分隔的问答知识库系统，每个业务独立存储、独立查询，自动分页，支持图片附件 + OCR 文字提取。

核心特性

特性	说明
🏢 多业务支持	客服、产品、技术等独立数据库
📄 自动分页

单文件达 500MB 自动创建新页 | | 📸 图片附件 | 保存截图，自动 OCR 提取文字 | | 🔍 智能搜索 | 匹配问题文本 + 图片 OCR 文字 | | ⏳ 待回答管理 | 记录未回答问题，定期提醒 | | 📊 统计分析 | 业务统计、图片统计 | | 📤 导出功能 | 一键导出 Markdown 文档 |

---

🎯 触发词

当用户提到以下关键词时，进入知识库操作模式：

• - 我想操作知识库
• 我想操作业务知识库
• 知识库
• knowledge base
• KB
• 添加一个问题
• 查询知识库

---

🚀 交互流程

方式一：快捷命令（强烈推荐 ⭐）

用户直接使用快捷格式，无需多轮对话：

KB:<业务名> Q:<问题> A:<答案> # 纯文字问答
KB:<业务名> Q:<问题> A:<答案> IMG:<路径> # 带图片问答
KB:<业务名> <问题> # 查询问题
KB:<业务名> list # 查看统计
KB:list # 列出所有业务
KB:img list [业务名] # 列出图片
KB:img stats # 图片统计

示例：

KB:客服 Q:如何退款 A:7 天内无理由退款
KB:技术 Q:登录报 502 错误 A: 检查 Nginx 配置 IMG:/tmp/error.png
KB:客服 退款流程是什么
KB:技术 list
KB:list

方式二：对话模式

步骤 1：触发知识库操作

用户: 我想操作知识库 或 我想操作业务知识库

助理:

📚 已进入知识库操作模式

当前业务：

1. 1. 客服 (120 问答)
2. 产品 (85 问答)
3. 技术 (200 问答)

请告诉我业务类型，或：

• - 输入业务名称（如客服）
• 说list查看所有
• 说new 业务名创建新业务
• 或直接用快捷格式：KB:业务 Q:问题 A:答案

步骤 2：选择业务

用户: 技术 或 切换到技术知识库

助理:

✅ 已选择：技术知识库

当前操作模式：

• - 添加问答：Q: 问题 A: 答案 [IMG:图片路径]
• 查询问题：直接发送问题
• 查看状态：list
• 图片管理：img list / img stats
• 切换业务：switch
• 退出：exit

当前业务：技术 | 已回答：200 条 | 待回答：5 条 | 图片：15 张

步骤 3：执行操作

添加问答（纯文字）:

用户：Q: API 地址是什么 A: https://api.example.com
助理：✅ 问答已添加 (技术知识库)

添加问答（带图片）:

用户：Q: 登录报 502 错误 A: 检查 Nginx 配置 IMG:/tmp/error.png
助理：
📸 保存图片... ✅ 已保存：error.png (256 KB)
🔍 提取 OCR 文字：502 Bad Gateway nginx/1.18.0
✅ 问答已添加 (技术知识库)
📎 附件：1 张图片

查询问题:

用户：502 错误怎么办
助理：
🔍 找到匹配答案（相似度 0.95）：

Q: 登录报 502 错误
A: 检查 Nginx 配置

📎 相关图片：error.png
📝 图片文字：502 Bad Gateway nginx/1.18.0

---

📋 命令格式详解

快捷命令（推荐）

命令	说明	示例
KB:业务 Q:问题 A:答案	添加问答	KB:客服 Q:如何退款 A:7 天内可退款
KB:业务 Q:问题 A:答案 IMG:路径

添加带图片问答 | KB:技术 Q:502 错误 A: 检查 Nginx IMG:/tmp/error.png | | KB:业务 问题 | 查询问题 | KB:客服 退款流程 | | KB:业务 list | 查看业务统计 | KB:技术 list | | KB:list | 列出所有业务 | KB:list | | KB:new 业务名 | 创建新业务 | KB:new 财务 | | KB:export 业务名 | 导出文档 | KB:export 客服 | | KB:img list [业务] | 列出图片 | KB:img list 技术 | | KB:img stats | 图片统计 | KB:img stats |

自然语言命令

用户输入	助理行为
我想在客服知识库添加一个问题	提示用户提供问题和答案
Q: 如何退款 A: 7 天内可退款

添加到当前业务知识库 | | 查询产品知识库中关于价格的问题 | 在产品知识库中搜索 | | 帮我创建一个 HR 知识库 | 创建新业务 | | 切换到技术知识库 | 切换当前业务 | | 导出客服知识库 | 导出 Markdown 文档 |

---

🗂️ 目录结构

knowledge-base/
├── kb-manager.py # 知识库核心管理器
├── image-manager.py # 图片管理器 + OCR
├── kb-image.sh # 图片命令行工具
├── businesses.json # 业务索引
├── attachments/ # 图片附件目录
│ ├── 客服/
│ │ ├── a3f8b2c1.png
│ │ └── d9e4f5a6.jpg
│ ├── 产品/
│ └── 技术/
├── 客服/ # 业务数据库目录
│ ├── qa-database.json
│ └── qa-database-page2.json
├── 产品/
└── 技术/

---

📸 图片处理流程

1. 保存图片

python

自动保存到 attachments/业务名/

生成唯一文件名：{hash}.{ext}

返回文件信息：路径、大小、扩展名

2. OCR 提取文字

python

自动尝试 OCR 引擎：

1. pytesseract (Python 库)

2. tesseract 命令行

3. 其他 OCR 服务

返回提取的文字内容

3. 存储到数据库

json
{
question: 登录报 502 错误,
answer: 检查 Nginx 配置,
attachments: [
{
filename: a3f8b2c1.png,
type: image,
path: attachments/技术/a3f8b2c1.png,
ocr_text: 502 Bad Gateway nginx/1.18.0
}
]
}

4. 搜索时匹配

python

同时搜索：

1. 问题文本相似度

2. 图片 OCR 文字相似度

返回最佳匹配 + 图片附件

---

🔍 搜索策略

优先级

1. 1. 当前业务搜索 - 默认只在当前业务搜索
2. 跨业务搜索 - 如果当前业务无匹配，询问是否跨业务搜索
3. 图片 OCR 搜索 - 同时匹配图片中的文字

相似度阈值

相似度	行为
≥ 0.9	直接返回，高置信度
0.7-0.9

返回并提示相似度 | | 0.6-0.7 | 返回并建议确认 | | < 0.6 | 视为无匹配，建议添加新问答 |

搜索结果格式

json
{
question: 登录报 502 错误,
answer: 检查 Nginx 配置,
similarity: 0.95,
business: 技术,
page: 1