dify-app/docs/knowledge-base-structure.md

企业知识库结构设计

西安云美电子科技有限公司 - 企业知识库 文档版本：v1.0 创建时间：2026-06-06

---

1. 知识库总体架构

云美电子科技企业知识库采用 分层分类 结构，覆盖公司运营全链路：

企业知识库
├── 📁 公司概况
│   ├── 公司简介
│   ├── 组织架构
│   ├── 发展历程
│   └── 联系方式
│
├── 📁 产品技术
│   ├── 产品手册（按产品线分类）
│   ├── 技术规范
│   ├── 技术方案
│   ├── 研发文档
│   └── 常见技术问题 FAQ
│
├── 📁 质量管理
│   ├── 质量管理体系（QMS）
│   ├── 检测标准
│   ├── 计量规程
│   ├── 不合格品处理流程
│   └── 质量案例库
│
├── 📁 制度流程
│   ├── 行政管理制度
│   ├── 财务管理制度
│   ├── 人力资源制度
│   ├── 采购管理制度
│   └── 项目管理流程
│
├── 📁 培训学习
│   ├── 新员工入职培训
│   ├── 岗位技能培训
│   ├── 安全培训
│   └── 外部培训资料
│
├── 📁 项目档案
│   ├── 项目立项文档
│   ├── 项目验收报告
│   ├── 客户资料
│   └── 合同模板
│
└── 📁 常见问题 FAQ
    ├── 通用 FAQ
    ├── IT 支持 FAQ
    ├── 行政 FAQ
    └── 产品售后 FAQ

2. 分类详细说明

2.1 公司概况

子分类	内容说明	更新频率
公司简介	公司介绍、业务范围、核心优势	半年
组织架构	部门设置、岗位职责、汇报关系	季度
发展历程	大事记、里程碑事件	年度
联系方式	内外联系方式、通讯录	按需

2.2 产品技术

子分类	内容说明	更新频率
产品手册	各产品线的产品说明书、操作指南	随产品更新
技术规范	行业标准、企业标准、检测依据	按需
技术方案	项目技术方案、可行性分析	按需
研发文档	研发过程中的技术记录、设计文档	持续
技术 FAQ	产品使用中的技术问题及解答	持续

2.3 质量管理

子分类	内容说明	更新频率
质量管理体系	ISO 体系文件、质量手册、程序文件	年度审核
检测标准	各类检测方法标准、判定依据	按标准更新
计量规程	设备计量校准规程、管理要求	年度
不合格品处理	不合格品处理流程、评审记录模板	按需
质量案例库	典型质量问题案例、改进措施	持续

2.4 制度流程

子分类	内容说明	更新频率
行政管理	考勤、出差、办公用品、车辆管理	年度
财务管理	报销流程、费用标准、审批权限	年度
人力资源	招聘、绩效考核、薪酬福利	年度
采购管理	采购流程、供应商管理、审批流程	年度
项目管理	项目立项、执行、验收、归档流程	年度

2.5 培训学习

子分类	内容说明	更新频率
新员工培训	入职培训材料、公司文化介绍	年度
岗位技能	各岗位专业技能培训材料	按需
安全培训	安全生产、消防安全培训	年度
外部培训	外部培训资料、行业学习资源	按需

2.6 项目档案

子分类	内容说明	更新频率
立项文档	项目立项申请、可行性分析	按项目
验收报告	项目验收报告、交付文档	按项目
客户资料	客户信息、需求文档、沟通记录	按需
合同模板	各类合同标准模板	年度

2.7 FAQ

子分类	内容说明	更新频率
通用 FAQ	公司常见问题（工作地点、福利等）	持续
IT 支持	系统使用、软件安装、网络问题	持续
行政 FAQ	报销、请假、出差等流程问题	持续
产品售后	产品使用、售后问题	持续

3. 文档分段策略

3.1 分段参数配置

参数	推荐值	说明
分段长度	500 tokens	约 300-400 个中文字符
重叠长度	50 tokens	上下文重叠，保持语义连贯
最大分段数/文件	20	单文件最大分段数
分隔符	\n、\n\n、。、！、？、；	中文优先分隔符

3.2 分段优先级规则

1. 按标题分层：一级标题 → 二级标题 → 三级标题
2. 按段落分割：在自然段落边界处分割
3. 按句号分割：超出长度限制时在句号处分割
4. 硬截断兜底：超出最大长度时强制截断

3.3 不同文档类型的分段建议

文档类型	建议分段长度	特殊处理
产品手册	300-500 tokens	保留产品型号、参数表格
技术规范	500-800 tokens	保留规范编号、章节号
管理制度	400-600 tokens	保留条款编号
FAQ	按问答对分段	每对为一个分段
培训材料	500-700 tokens	保留课程结构
合同模板	按条款分段	保留条款编号和标题

3.4 元数据标签建议

每个知识库文档建议添加以下元数据标签，便于精准检索：

- department: 所属部门（产品部/质量部/行政部...）
- doc_type: 文档类型（手册/规范/制度/FAQ...）
- product: 关联产品（如适用）
- version: 文档版本号
- status: 状态（有效/废止/草稿）
- last_updated: 最后更新时间

4. 知识库导入流程

4.1 批量导入步骤

1. 文件整理：按上述分类结构整理文件目录
2. 格式检查：确保文件为支持的格式（PDF、Word、Markdown、TXT、Excel）
3. 元数据标注：为每个文件添加元数据标签
4. 创建知识库：在 Dify 中按分类创建独立知识库
5. 上传文档：按分类批量上传，应用对应分段策略
6. 索引验证：检查分段结果，确认无明显截断错误
7. 测试检索：使用典型问题测试检索效果

4.2 知识库命名规范

KB-{分类英文缩写}-{名称}

示例：
KB-COMP-公司概况
KB-PROD-产品技术
KB-QUAL-质量管理
KB-RULE-制度流程
KB-TRAIN-培训学习
KB-PROJ-项目档案
KB-FAQ-常见问题

5. 维护策略

维护类型	频率	负责人	说明
内容更新	按需	各部门	文档有更新时同步上传
索引重建	月度	IT 部	检查分段质量，优化检索
过期清理	季度	管理部	标记/移除过期文档
效果评估	月度	IT 部	检索准确率、用户满意度
备份	每日	IT 部	数据库、向量库自动备份

---

最后更新: 2026-06-06