diff --git a/docs/knowledge-base-structure.md b/docs/knowledge-base-structure.md new file mode 100644 index 0000000..76e8e08 --- /dev/null +++ b/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_ diff --git a/tasks.md b/tasks.md index 55df61a..343dc63 100644 --- a/tasks.md +++ b/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 设计知识库分段策略(文档分块大小、重叠策略) ---