docs(M2): 知识库结构设计 - 7大分类、分段策略、元数据标注、维护规范

2026-06-06 06:26:08 +08:00
parent 7de45e61bd
commit 79178eaba2
2 changed files with 213 additions and 3 deletions
@@ -0,0 +1,210 @@
 # 企业知识库结构设计
 > 西安云美电子科技有限公司 - 企业知识库
 > 文档版本：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_
@@ -19,9 +19,9 @@
 ## M2: 知识库结构设计与文档编写
- [ ] M2.1.1 调研云美电子科技典型知识库分类（产品手册、技术规范、管理制度、培训资料等）
+- [x] M2.1.1 调研云美电子科技典型知识库分类（产品手册、技术规范、管理制度、培训资料等）
- [ ] M2.1.2 编写 `docs/knowledge-base-structure.md`（知识库分类结构设计）
+- [x] M2.1.2 编写 `docs/knowledge-base-structure.md`（知识库分类结构设计）
- [ ] M2.1.3 设计知识库分段策略（文档分块大小、重叠策略）
+- [x] M2.1.3 设计知识库分段策略（文档分块大小、重叠策略）
 ---