170 lines
5.7 KiB
Markdown
170 lines
5.7 KiB
Markdown
# 企业知识库 - Dify 应用开发任务清单
|
||
|
||
> **项目**: 云美电子科技 企业知识库
|
||
> **技术栈**: Dify (自部署 Docker) + DeepSeek
|
||
> **仓库**: http://git.xayunmei.com/yunmei/dify-app
|
||
> **PM/QA**: Agent-PMQA
|
||
> **Dev**: Agent-Dev
|
||
|
||
---
|
||
|
||
## M1: 环境搭建（Day 1）
|
||
|
||
### M1.1 Dify Docker 部署
|
||
- [ ] 1.1.1 确认部署服务器（IP/配置）及 Docker 环境
|
||
- [ ] 1.1.2 编写 `docker-compose.yml`（Dify 社区版）
|
||
- [ ] 1.1.3 配置 `.env` 环境变量（端口、密钥、存储路径）
|
||
- [ ] 1.1.4 启动 Dify 全套服务并验证可访问
|
||
- [ ] 1.1.5 初始化管理员账号
|
||
|
||
### M1.2 DeepSeek 模型接入
|
||
- [ ] 1.2.1 在 Dify 后台配置 DeepSeek API Key
|
||
- [ ] 1.2.2 验证模型调用正常（测试对话）
|
||
- [ ] 1.2.3 配置模型参数（temperature、max_tokens 等）
|
||
|
||
### M1.3 Git 项目初始化
|
||
- [ ] 1.3.1 创建项目目录结构
|
||
- [ ] 1.3.2 编写 `.gitignore`
|
||
- [ ] 1.3.3 编写 `README.md`（项目说明）
|
||
- [ ] 1.3.4 首次 push 到远程仓库
|
||
|
||
---
|
||
|
||
## M2: 知识库搭建（Day 2）
|
||
|
||
### M2.1 知识库规划
|
||
- [ ] 2.1.1 定义知识库分类体系（技术文档/管理制度/项目资料）
|
||
- [ ] 2.1.2 编写知识库分类说明文档 `docs/knowledge-base-structure.md`
|
||
- [ ] 2.1.3 定义文档命名规范和元数据标准
|
||
|
||
### M2.2 Dify 知识库配置
|
||
- [ ] 2.2.1 在 Dify 中创建知识库（按分类）
|
||
- [ ] 2.2.2 配置分段策略（自动/自定义分段规则）
|
||
- [ ] 2.2.3 配置索引模式（高质量模式 - Embedding）
|
||
- [ ] 2.2.4 配置检索方式（混合检索：向量+全文）
|
||
- [ ] 2.2.5 选择 Embedding 模型并验证
|
||
|
||
### M2.3 示例文档导入
|
||
- [ ] 2.3.1 准备测试文档集（每个分类 3-5 份）
|
||
- [ ] 2.3.2 上传文档到 Dify 知识库
|
||
- [ ] 2.3.3 验证分段结果和检索质量
|
||
|
||
---
|
||
|
||
## M3: 应用开发（Day 3-4）
|
||
|
||
### M3.1 Chatbot 应用创建
|
||
- [ ] 3.1.1 在 Dify 中创建 Chatflow 类型应用
|
||
- [ ] 3.1.2 配置系统提示词（角色定义、回答规范、语气风格）
|
||
- [ ] 3.1.3 绑定知识库并配置检索策略
|
||
- [ ] 3.1.4 配置引用溯源（显示文档来源）
|
||
|
||
### M3.2 Prompt 工程
|
||
- [ ] 3.2.1 编写系统 Prompt `prompts/system-prompt.md`
|
||
- [ ] 3.2.2 定义回答格式（结构化输出模板）
|
||
- [ ] 3.2.3 定义边界场景处理（不知道/超出范围/敏感信息）
|
||
- [ ] 3.2.4 定义多轮对话策略（上下文窗口管理）
|
||
|
||
### M3.3 高级功能
|
||
- [ ] 3.3.1 配置敏感词过滤（如适用）
|
||
- [ ] 3.3.2 配置对话开场白和推荐问题
|
||
- [ ] 3.3.3 配置引用归属显示
|
||
- [ ] 3.3.4 设置 citations（引用来源卡片）
|
||
|
||
---
|
||
|
||
## M4: 测试优化（Day 5）
|
||
|
||
### M4.1 功能测试
|
||
- [ ] 4.1.1 编写测试用例 `tests/test-cases.md`
|
||
- [ ] 4.1.2 基础问答测试（10+ 问题覆盖各知识库）
|
||
- [ ] 4.1.3 多轮对话测试（上下文连贯性）
|
||
- [ ] 4.1.4 边界测试（无关问题/错误提问/长文本）
|
||
- [ ] 4.1.5 检索准确率评估（Top-5 召回率）
|
||
|
||
### M4.2 调优
|
||
- [ ] 4.2.1 根据测试结果优化 Prompt
|
||
- [ ] 4.2.2 调整分段策略（如召回不准）
|
||
- [ ] 4.2.3 调整检索参数（TopK、Score 阈值、Rerank）
|
||
- [ ] 4.2.4 调整模型参数（temperature 等）
|
||
|
||
### M4.3 性能测试
|
||
- [ ] 4.3.1 响应时间测试（首 token / 完整回答）
|
||
- [ ] 4.3.2 并发测试（多用户同时访问）
|
||
- [ ] 4.3.3 记录性能基线 `docs/performance-baseline.md`
|
||
|
||
---
|
||
|
||
## M5: 用户接入（Day 6）
|
||
|
||
### M5.1 嵌入式 WebApp
|
||
- [ ] 5.1.1 配置 Dify 内置 WebApp（主题/Logo/品牌色）
|
||
- [ ] 5.1.2 嵌入到公司内部网站（iframe 方案）
|
||
- [ ] 5.1.3 测试嵌入页面的可用性
|
||
|
||
### M5.2 API 集成（可选）
|
||
- [ ] 5.2.1 生成 API Key
|
||
- [ ] 5.2.2 编写 API 调用示例 `docs/api-integration.md`
|
||
- [ ] 5.2.3 如需对接企业微信/飞书，编写对接方案
|
||
|
||
### M5.3 权限与安全
|
||
- [ ] 5.3.1 配置 Dify 应用访问权限
|
||
- [ ] 5.3.2 检查 API Key 安全存储
|
||
- [ ] 5.3.3 数据隐私合规检查
|
||
|
||
---
|
||
|
||
## M6: 文档交付（Day 7）
|
||
|
||
### M6.1 项目文档
|
||
- [ ] 6.1.1 更新 `README.md`（部署说明、使用指南）
|
||
- [ ] 6.1.2 编写运维手册 `docs/ops-guide.md`（备份、升级、排障）
|
||
- [ ] 6.1.3 编写用户使用手册 `docs/user-guide.md`
|
||
- [ ] 6.1.4 编写知识库维护指南 `docs/kb-maintenance.md`
|
||
|
||
### M6.2 Dify 配置导出
|
||
- [ ] 6.2.1 导出应用 DSL 配置（YAML）
|
||
- [ ] 6.2.2 导出知识库配置
|
||
- [ ] 6.2.3 版本打 Tag，push 最终版本
|
||
|
||
---
|
||
|
||
## 项目目录结构
|
||
|
||
```
|
||
dify-app/
|
||
├── README.md # 项目说明
|
||
├── .gitignore
|
||
├── docker/
|
||
│ ├── docker-compose.yml # Dify 部署配置
|
||
│ └── .env.example # 环境变量模板
|
||
├── prompts/
|
||
│ └── system-prompt.md # 系统 Prompt
|
||
├── knowledge/
|
||
│ └── sample-docs/ # 示例文档
|
||
│ ├── technical/ # 技术文档
|
||
│ ├── management/ # 管理制度
|
||
│ └── project/ # 项目资料
|
||
├── dsl/
|
||
│ └── app-config.yaml # Dify 应用 DSL 导出
|
||
├── tests/
|
||
│ └── test-cases.md # 测试用例
|
||
└── docs/
|
||
├── knowledge-base-structure.md # 知识库结构说明
|
||
├── api-integration.md # API 对接文档
|
||
├── performance-baseline.md # 性能基线
|
||
├── ops-guide.md # 运维手册
|
||
├── user-guide.md # 用户手册
|
||
└── kb-maintenance.md # 知识库维护指南
|
||
```
|
||
|
||
---
|
||
|
||
## 审核标准（QA Checklist）
|
||
|
||
每个 PR 需检查：
|
||
- [ ] 安全：无 API Key 泄露、无硬编码密码
|
||
- [ ] 逻辑：Prompt 合理、分段策略正确
|
||
- [ ] 性能：检索配置最优、无冗余依赖
|
||
- [ ] 规范：文件命名统一、文档完整
|