## Dify 瀹㈡埛绔皝瑁呭畬鎴?鉁? ### 瀹屾垚鐨勫伐浣? 1. 绫诲瀷瀹氫箟 (backend/src/clients/types.ts) - Dataset, Document, Retrieval 鐩稿叧绫诲瀷 - 瀹屾暣鐨?TypeScript 绫诲瀷瀹氫箟 - 鑷畾涔?DifyError 閿欒绫? 2. DifyClient 鏍稿績绫?(backend/src/clients/DifyClient.ts) - 鐭ヨ瘑搴撶鐞? createDataset, getDatasets, getDataset, deleteDataset - 鏂囨。绠$悊: uploadDocumentDirectly, getDocuments, getDocument, deleteDocument - 鐭ヨ瘑搴撴绱? retrieveKnowledge (鏀寔璇箟鎼滅储銆乼op_k銆佺浉浼煎害闃堝€? - 杈呭姪鏂规硶: waitForDocumentProcessing, uploadAndProcessDocument 3. 娴嬭瘯鑴氭湰 (backend/src/scripts/test-dify-client.ts) - 8椤瑰畬鏁存祴璇曞叏閮ㄩ€氳繃 - 娴嬭瘯鑰楁椂绾?5绉? - 楠岃瘉鎵€鏈堿PI鍔熻兘姝e父 ### 娴嬭瘯缁撴灉 鉁?娴嬭瘯1: 鍒涘缓鐭ヨ瘑搴?鉁?娴嬭瘯2: 鑾峰彇鐭ヨ瘑搴撳垪琛?(鎵惧埌3涓? 鉁?娴嬭瘯3: 鑾峰彇鐭ヨ瘑搴撹鎯?鉁?娴嬭瘯4: 涓婁紶鏂囨。 (247 tokens) 鉁?娴嬭瘯5: 鑾峰彇鏂囨。鍒楄〃 鉁?娴嬭瘯6: 鐭ヨ瘑搴撴绱?(鐩镐技搴?.4420) 鉁?娴嬭瘯7: 鍒犻櫎鏂囨。 鉁?娴嬭瘯8: 鍒犻櫎鐭ヨ瘑搴? ### 鎶€鏈寒鐐? - 瀹屽杽鐨勯敊璇鐞嗘満鍒?(axios 鎷︽埅鍣? - 鏅鸿兘杞绛夊緟鏂囨。澶勭悊瀹屾垚 - FormData 鏂囦欢涓婁紶鏀寔 - 鍗曚緥妯″紡瀵煎嚭 - 鏀寔鑷畾涔夐厤缃? ### 渚濊禆鏇存柊 - form-data: ^4.0.0 - @types/form-data: ^2.5.0 ### 閰嶇疆鏇存柊 - DIFY_API_KEY 鏇存柊涓烘湇鍔PI瀵嗛挜 - DIFY_API_URL=http://localhost/v1 ### 鏂囨。鏇存柊 - 鏂板: docs/05-姣忔棩杩涘害/Day19-Dify瀹㈡埛绔皝瑁呭畬鎴?md - 鏇存柊: docs/04-寮€鍙戣鍒?寮€鍙戦噷绋嬬.md (Day 19 鏍囪涓哄畬鎴? ### 涓嬩竴姝? Day 20-22: 鐭ヨ瘑搴撶鐞嗗姛鑳?- 鏁版嵁搴撹〃璁捐 (KnowledgeBase, Document) - 鍚庣 CRUD API - 鍓嶇鐭ヨ瘑搴撶鐞嗛〉闈?- 鏂囨。涓婁紶缁勪欢 --- Progress: 閲岀▼纰?1 (MVP) 90% -> 鐭ヨ瘑搴撶鐞嗗紑鍙戜腑
AI科研助手 - 文档中心
🏠 导航
📚 文档导航
00-项目概述
01-设计文档 ⭐ 核心
02-开发规范 ⭐ 核心
03-业务规则 ⭐ 核心
04-开发计划 ⭐ 核心
05-配置文档
06-测试文档
07-部署文档
08-参考资料
🎯 文档使用指南
新人入门顺序
- 阅读
00-项目概述/产品需求文档(PRD).md- 了解产品全貌 - 查看
01-设计文档/用户端原型图.html- 体验产品交互 - 阅读
00-项目概述/技术架构总览.md⭐ - 快速了解技术方案 - 阅读
01-设计文档/数据库设计文档.md- 理解数据结构 - 阅读
01-设计文档/API设计规范.md- 掌握接口定义 - 阅读
02-开发规范/代码规范.md- 遵守开发规范 - 阅读
03-业务规则/核心业务规则总览.md- 理解业务逻辑 - 阅读
04-开发计划/开发里程碑.md- 了解开发计划 - 开始开发
开发前必读
- ⭐ 产品需求文档(PRD) - 了解产品需求
- ⭐ 技术架构总览 - 了解技术方案
- ⭐ 数据库设计文档 - 理解数据结构
- ⭐ API设计规范 - 掌握接口定义
- ⭐ 代码规范 - 遵守开发规范
- ⭐ 业务规则总览 - 理解业务逻辑
文档维护原则
- 所有设计变更必须先更新文档
- 每个功能模块开发前先完善对应业务规则文档
- API变更需要同步更新接口文档
- 保持文档与代码同步
文档版本: v1.0
创建日期: 2025-10-10
维护者: 开发团队