{"id":51280350,"url":"https://github.com/evilstar2016/awesome-dify-analysis","last_synced_at":"2026-06-30T01:03:45.602Z","repository":{"id":331228233,"uuid":"1125196571","full_name":"evilstar2016/awesome-dify-analysis","owner":"evilstar2016","description":"Deep dive into Dify.","archived":false,"fork":false,"pushed_at":"2026-01-04T08:56:45.000Z","size":23294,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-04T17:22:27.007Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evilstar2016.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-30T09:57:34.000Z","updated_at":"2026-01-04T08:56:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/evilstar2016/awesome-dify-analysis","commit_stats":null,"previous_names":["evilstar2016/awesome-dify-analysis"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/evilstar2016/awesome-dify-analysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilstar2016%2Fawesome-dify-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilstar2016%2Fawesome-dify-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilstar2016%2Fawesome-dify-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilstar2016%2Fawesome-dify-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evilstar2016","download_url":"https://codeload.github.com/evilstar2016/awesome-dify-analysis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilstar2016%2Fawesome-dify-analysis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34948230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-30T01:03:44.000Z","updated_at":"2026-06-30T01:03:45.559Z","avatar_url":"https://github.com/evilstar2016.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dify 项目深度架构解析\n\n🌍 [English Version](./README_en.md) | [中文版本](./README.md)\n\n\u003e 🎯 **从系统架构师视角深度拆解 Dify**  \n\u003e 30+ 篇技术文档 | 完整架构图 | 生产实战经验\n\n本仓库提供 Dify 项目的**系统级架构分析**，适合想要深入理解 Dify 设计思想、进行二次开发或技术选型的开发者和架构师。\n\n## 🎓 这个项目适合谁？\n\n- ✅ **架构师**：需要理解 Dify 的架构设计与技术选型\n- ✅ **开发者**：准备基于 Dify 进行二次开发或贡献代码\n- ✅ **技术决策者**：评估 Dify 是否适合你的业务场景\n- ✅ **AI 工程师**：想学习 AI 应用的工程化最佳实践\n\n## 🚀 快速开始\n\n### 推荐学习路径\n\n```mermaid\ngraph LR\n    A[01-overview 项目概述] --\u003e B[02-architecture 系统架构]\n    B --\u003e C[04-core-modules 核心模块]\n    C --\u003e D[05-data-architecture 数据架构]\n    D --\u003e E[06-third-party 第三方集成]\n```\n\n**建议阅读顺序**：\n1. 先看 [项目概述](./01-overview) 了解整体能力和技术栈\n2. 再看 [系统架构](./02-architecture) 理解组件设计\n3. 根据需求深入具体模块（Workflow、Agent、知识库等）\n\n### 📚 完整学习地图\n\n如果你想系统性地学习 Dify，从入门到精通，建议参考我们的 **[Dify 学习地图](./Dify-learning-map.md)**。这份学习地图基于认知难度递进和实战应用场景设计，分为5个阶段：\n\n- 🎯 **阶段1: 快速入门**（1-2天）：了解 Dify 是什么、能做什么、如何快速上手\n- 🏗️ **阶段2: 架构理解**（3-5天）：掌握系统架构、分层设计、组件关系\n- ⚙️ **阶段3: 核心模块**（7-10天）：深入理解8大核心模块的设计与实现\n- 🔌 **阶段4: 集成扩展**（3-5天）：掌握与第三方服务的集成方案\n- 🚀 **阶段5: 生产实战**（持续）：生产部署、性能优化、问题排查\n\n学习地图包含详细的必读文档、实践任务、通关标准，以及按不同角色定制的学习路径，帮助你高效掌握 Dify 的架构设计与开发技能。\n\n## 📁 目录结构\n\n### [01-overview](./01-overview) - 项目概述\n从宏观层面了解 Dify 项目的目标、核心能力与整体架构。\n- 项目目标与能力速览\n- 仓库结构与核心模块介绍\n- 开发、质量与部署指南\n\n### [02-architecture](./02-architecture) - 系统架构\n完整的架构设计与组件关系分析。\n- 组件架构设计（DDD、分层架构）\n- 完整架构图（PlantUML + PNG）\n- 模块间依赖关系\n\n### [03-layers](./03-layers) - 分层设计\n深入 API 层的设计与实现。\n- RESTful API 架构设计\n- 各类 API 的时序图\n- 接口规范与最佳实践\n\n### [04-core-modules](./04-core-modules) - 核心模块 ⭐\n这是最核心的部分，包含 8 大模块的深度解析：\n- **Agent** - 智能体架构与策略模式\n- **Workflow** - 工作流引擎设计\n- **Prompt** - 提示词工程实现\n- **Tools \u0026 Plugins** - 工具调用与插件机制\n- **Model Runtime** - 多模型适配层\n- **KnowledgeBase** - 知识库与 RAG 实现\n- **Observability** - 可观测性系统\n- **Permission** - 权限管理设计\n\n### [05-data-architecture](./05-data-architecture) - 数据架构\n数据库设计与数据流转分析。\n- 完整的数据库 ER 图\n- 表结构设计详解\n- 数据流转与状态管理\n\n### [06-third-party](./06-third-party) - 第三方集成\nDify 如何集成各种第三方服务（10+ 类集成）：\n- 大语言模型集成（OpenAI、Anthropic 等）\n- 向量数据库集成（Weaviate、Qdrant 等）\n- 对象存储集成（S3、阿里云 OSS 等）\n- 其他：消息平台、文档处理、监控等\n\n### [07-others](./07-others) - 其他补充文档\n专题深度分析：\n- 会话级上下文工程（Context Engineering）\n- 知识问答场景的上下文处理\n- 用户级与会话级上下文对比\n\n## 📖 文档说明\n\n### 📂 本仓库包含的内容\n\n本仓库提供 Dify 的**架构级分析**，包括：\n- ✅ 完整的架构图和 PlantUML 源码\n- ✅ 核心模块的架构设计分析\n- ✅ 技术栈选型与设计思想\n- ✅ 第三方服务集成方案\n- ✅ 数据库设计与数据流转\n\n### 🎁 获取更深度的内容\n\n本仓库侧重于**架构层面**的分析。如果你需要：\n- 📖 **源码级逐行解读**（核心代码详细注释）\n- 🛠️ **生产环境避坑指南**（实际部署中的问题和解决方案）\n- ⚡ **性能优化实战**（如何优化 Dify 的性能）\n- 💼 **企业级应用案例**（真实业务场景的最佳实践）\n- 🤝 **一对一技术答疑**（针对你的具体问题提供咨询）\n\n欢迎关注我的公众号 **「柒叔代码阁」**（搜索公众号或扫描下方二维码）\n\n---\n\n📱 **关注公众号「柒叔代码阁」**\n\n定期发布Dify深度内容及生产实践～\n\n![公众号二维码](./qrcode.png)\n\n## 🔍 文档类型说明\n\n- **`.puml`** - PlantUML 图表源文件，可用于生成和编辑架构图\n- **`.md`** - Markdown 技术文档，包含详细说明和分析\n- **`.png`** - 已生成的架构图图片，可直接查看\n\n## ⭐ 为什么要做这个项目？\n\n在使用 Dify 的过程中，我发现官方文档主要侧重于**使用层面**，缺少**系统级的架构解析**。\n\n我希望通过**拆解源码和架构设计**的方式，帮助大家：\n1. **理解设计思想** - 不只知道怎么用，更要知道为什么这么设计\n2. **提升架构能力** - 学习 Dify 中优秀的设计模式和工程实践\n3. **避免生产大坑** - 分享实际部署中遇到的架构级问题和解决方案\n\n## 🤝 参与贡献\n\n欢迎补充和完善分析文档！如果你：\n- 发现文档中的错误或不准确的地方\n- 有新的架构分析角度或见解\n- 想贡献某个模块的深度分析\n\n请提交 Issue 或 Pull Request。贡献时请确保：\n- 文档放置在合适的目录下\n- 使用清晰的命名规范\n- 包含必要的架构图和说明\n- 保持与现有文档风格一致\n\n## 💬 交流与反馈\n\n- **GitHub Issues**：技术问题和建议请提 Issue\n- **GitHub Discussions**：架构设计讨论请到 Discussions\n- **公众号**：深度内容和答疑，搜索「柒叔代码阁」\n\n## 📊 项目统计\n\n- 📝 **30+** 篇技术文档\n- 📐 **20+** 个架构图\n- 🏗️ **8** 大核心模块全覆盖\n- 🔗 **10+** 类第三方集成分析\n\n---\n\n⭐ **如果这个项目对你有帮助，请给个 Star 支持一下！** ⭐\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilstar2016%2Fawesome-dify-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevilstar2016%2Fawesome-dify-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilstar2016%2Fawesome-dify-analysis/lists"}