# 企业知识库 - 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 合理、分段策略正确
- [ ] 性能：检索配置最优、无冗余依赖
- [ ] 规范：文件命名统一、文档完整