# 企业知识库结构设计

> 西安云美电子科技有限公司 - 企业知识库
> 文档版本：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_