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

docs/knowledge-base-structure.md

@@ -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_

tasks.md

@@ -19,9 +19,9 @@
 
 ## M2: 知识库结构设计与文档编写
 
-- [ ] M2.1.1 调研云美电子科技典型知识库分类（产品手册、技术规范、管理制度、培训资料等）
-- [ ] M2.1.2 编写 `docs/knowledge-base-structure.md`（知识库分类结构设计）
-- [ ] M2.1.3 设计知识库分段策略（文档分块大小、重叠策略）
+- [x] M2.1.1 调研云美电子科技典型知识库分类（产品手册、技术规范、管理制度、培训资料等）
+- [x] M2.1.2 编写 `docs/knowledge-base-structure.md`（知识库分类结构设计）
+- [x] M2.1.3 设计知识库分段策略（文档分块大小、重叠策略）
 
 ---