# 知识库

> 面向图文快印门店的本地化行业知识管理平台，集成智能问答、文档管理、供应商、产品价格、客户资料与传道授业经验沉淀，所有数据本地 SQLite 存储，隐私安全可控。

- 分类：AI 功能
- 关键词：知识库、供应商、产品价格、客户资料、传道授业、智能问答、文档管理、OCR 解析、本地存储
- 在线原文：https://www.xyltools.com/docs/knowledge-base

---

## 什么是知识库

知识库是效率工具箱内置的行业知识管理平台，专为图文快印、广告设计门店打造。它把供应商报价、产品手册、客户档案、师徒经验等散落各处的业务知识集中沉淀，再通过 AI 智能问答让团队随时检索、查询。

所有业务数据保存在本机 SQLite 数据库（Data/kb.db），附件存放在本地 Data 目录下，不上传任何第三方云端，店内数据隐私可控。AI 推理过程仅传输必要的检索片段，不外泄完整文档。

![知识库主界面](https://www.xyltools.com/docs/light/knowledge-base-1.png)

> **数据本地存储**：知识库主数据库与全部附件均保存在程序所在盘的 Data/ 目录，建议定期通过"导出"功能备份；多台电脑可通过导出包同步数据。

## 五大功能标签

知识库主页面顶部含 5 个标签，覆盖从信息录入到智能问答的完整闭环。顶部全局搜索框会自动同步到当前激活的标签页，方便跨模块快速过滤。

| 标签 | 核心功能 | 典型用途 |
| --- | --- | --- |
| 🔍 智能问答 | 从文档/供应商/产品中检索答案，引用原文出处 | 查报价、查参数、查工艺、查供应商 |
| 📄 文档管理 | 导入并解析外协文档；同时管理"传道授业"经验知识 | 归档供应商资料、沉淀师傅经验 |
| 🏭 供应商 | 维护供应商名录、联系方式、分类标签 | 查供应商电话、维护合作记录 |
| 📦 产品价格 | 统一管理产品报价，支持多供应商比价、有效期管理 | 查询最新报价、找最优价格 |
| 👤 客户资料 | 独立的客户档案，每位客户可挂多文档与多图片 | 维护客户信息、归档客户资料 |

## 智能问答

智能问答是基于本地知识库内容的 AI 对话助手。与通用 AI 聊天不同，它会先从你导入的文档、供应商资料、产品价格库中检索相关片段，再让大模型基于这些片段生成回答，并标注引用来源，确保有据可依。

- 左侧问答历史：自动按会话保存对话，可搜索、删除、新建会话。
- 推荐问题：进入空会话时显示常用提问示例（"有哪些供应商？""铜板纸最新报价是多少？""有哪些纸张材料可以选择？""最近导入了哪些文档？"），点击直接发送。
- 图片搜索：输入区支持上传或 Ctrl+V 粘贴图片，AI 会以图找货，匹配最相似的产品。
- 引用展示：AI 回复中标注引用的文档、产品或供应商，点击可直接定位原始记录。
- 生成控制：发送中可点击"停止生成"中断流式输出，避免浪费额度。

> **让回答更准的诀窍**：智能问答的效果与知识库数据量直接相关。建议优先把常用供应商报价单、主力产品手册先导入，AI 命中率会显著提升。

## 文档管理

文档管理标签下含两个子页签："📁 外协文档"用于沉淀供应商报价单、产品手册等业务材料；"📖 传道授业"用于录入门店内部师傅的经验知识。两类内容物理隔离，互不影响。

1. **选择 OCR 解析引擎**：顶部下拉框可在内置的多种识别引擎之间切换，针对图片报价单、扫描件等不同质量的素材选用最合适的解析模型。
2. **导入外协资料**：点击"导入外协资料"批量选文件，支持 PDF、Word、Excel、图片等格式。系统自动按文件哈希去重，并启动后台 OCR 解析与结构化抽取。
3. **手机扫码录入**：点击 📱 按钮显示局域网二维码，用手机扫码后可直接拍照上传到本机知识库，免去拷贝步骤，特别适合现场拍报价单。
4. **查看与筛选**：列表支持按类型（报价单 / 产品手册 / 图片 / 其他）筛选，配合顶部全局搜索可快速定位。每条记录显示解析状态：待处理 / 解析中 / 等待复核 / 已完成 / 失败。

| 文档类型 | 自动提取内容 | 说明 |
| --- | --- | --- |
| 报价单 | 产品名称、规格、单价、供应商 | 解析后可一键导入产品价格库，参与多供应商比价 |
| 产品手册 | 产品参数、工艺说明、规格信息 | 索引后可被智能问答直接检索引用 |
| 图片 | 产品图片、工艺流程图 | AI 自动识别图片内容并生成描述用于搜索 |
| 其他 | 通用文本提取 | 保留原文供问答检索 |

> **智能去重**：导入时通过 SHA-256 文件哈希精确去重；同时基于 SimHash 做近似去重，内容近似但版本不同的文档会被提示确认更新还是跳过。

## 供应商管理

供应商管理用于集中维护合作伙伴信息（联系方式、产品目录、合作记录）。供应商与产品价格、文档管理通过 ID 关联，一处录入处处可查。

- 基础信息：名称、分类、联系人、电话、微信、地址、备注、标签。
- 产品关联：每位供应商列表中显示其在售产品数量，点击可直接跳到产品价格库的过滤视图。
- 搜索筛选：按名称、分类、标签等条件快速查找。
- 状态管理：支持新增、编辑、停用。停用后历史价格记录仍保留，但不再出现在比价默认列表中。

## 产品价格库

产品价格库集中管理所有产品报价，支持按供应商、产品名、规格等多维度筛选与比价。导入报价单解析完成后，可一键把识别出的价格批量录入此库。

- 价格录入：手动新增或通过报价单解析结果一键导入。每条含产品名、规格、单位、单价、税率、供应商、有效期、备注等字段。
- 多供应商比价：同一产品不同供应商的报价同屏对比，方便选最优价格。
- 严格去重：以"供应商 + 产品名 + 规格 + 单价"四元组识别重复条目，避免同一价格被多次录入。
- 有效期管理：每条价格可设置有效期，过期会被自动标记并参与提醒。
- 分页加载：默认每页 50 条，支持分页浏览大数据量的价格库。

## 客户资料

客户资料是独立于报价知识的客户档案模块，每位客户可挂多份文档与多张图片，集中管理客户的合同、设计稿、沟通记录等多媒体资料。

- 基础字段：标题、客户名、联系人、电话、邮箱、地址、文本内容、标签。
- 多文档附件：每位客户可上传任意数量的文件（合同、设计稿等），文件保存在本地客户专属目录。
- 多图片附件：支持批量上传图片（产品图、效果图、现场照），独立目录存储。
- 搜索与软删除：支持按标题/客户名/联系人/备注/标签搜索；删除采用软删除策略，可恢复。

> **客户资料独立分类**：客户资料拥有独立的数据库表与文件目录，与外协文档、传道授业彻底分离，导出/导入时可单独勾选。

## 传道授业（经验知识）

"传道授业"是文档管理中的第二个子标签，用于沉淀门店内部师傅的实战经验，把零散的口口相传变成可检索的团队资产。每条经验支持图文+视频+录音三种形态，并附带 AI 自动转录与摘要。

- 经验分类：接单技巧 / 制作技巧 / 安装事项 / 客户资源 / 客户画像 / 收费规则 / 其他。
- 多媒体录入：支持上传图片、视频、录音，每个素材独立存元数据；录音可自动转录文本并提炼摘要（涉及人物、需求、关键数据、结论、经验）。
- 微信扫码白名单：员工通过专属二维码申请加入团队空间，由唯一管理员审批通过后才能录入经验，记录创建人微信身份。
- 跨端录入：桌面端与 H5 端均可录入，自动标记来源（desktop / h5_scan）。
- 安全保护：首次使用需绑定唯一管理员（微信扫码登录），关键操作需操作密码二次确认。

![传道授业经验录入弹窗](https://www.xyltools.com/docs/light/knowledge-base-2.png)

> **为什么单独叫"传道授业"**：区别于供应商报价等结构化数据，"传道授业"专门承载门店运营经验、客户应对话术、特殊工艺心得这类难以量化但极其宝贵的"暗知识"，让师傅经验跨人跨班次沉淀。

## 三分类独立导出导入

为了方便多店同步、备份恢复和数据迁移，知识库的导出/导入按"报价知识 / 客户资料 / 传道授业"三大独立分类组织，可单独勾选某一类，也可任意组合。

| 分类 | 包含内容 | 独立存储 |
| --- | --- | --- |
| 报价知识 | 供应商、产品价格、外协文档及附件 | 独立的数据库表与文件目录 |
| 客户资料 | 客户档案、客户文档与图片附件 | 独立的 kb_customers 表与 KbCustomers 目录 |
| 传道授业 | 经验知识、图片/视频/录音、白名单 | 独立的 kb_experiences 表与 kb_videos / kb_audios 目录 |

- 导出：勾选要导出的分类，系统打包对应数据库记录与附件文件成单一压缩包。
- 导入：导入对话框可选择要导入哪些分类，并提供"跳过已存在 / 覆盖已存在"两种冲突处理策略。
- 物理隔离：三类数据无论数据库表还是物理目录都完全分离，一类异常不会影响其他分类。

## 数据存储与隐私

知识库所有业务数据均保存在本机，绝不上传到任何第三方云端，店内敏感信息（供应商报价、客户档案、内部经验）始终掌握在自己手中。

| 数据类型 | 本地存储位置 | 说明 |
| --- | --- | --- |
| 主数据库 | Data/kb.db（SQLite WAL 模式） | 所有结构化数据：供应商、产品、文档、客户、经验等 |
| 客户附件 | Data/KbCustomers/customer_<id>/files 与 images | 每位客户独立子目录，files 存文档、images 存图片 |
| 经验视频 | Data/kb_videos/ | 传道授业上传的视频文件 |
| 经验录音 | Data/kb_audios/ | 传道授业上传的录音文件 |

> **日常备份建议**：建议定期使用"导出"功能把数据打包到外部硬盘或 NAS 备份；多店之间同步可通过导出包互相导入，并选择合适的冲突策略。

---

## 相关文章

- [AI 聊天](https://www.xyltools.com/docs/ai-chat)
- [记账开单助手](https://www.xyltools.com/docs/ai-accounting)
- [在线AI调用扣费说明](https://www.xyltools.com/docs/ai-billing-explanation)