成为贡献者
Last updated
Last updated
所以你想为 Dify 做贡献 - 这太棒了,我们迫不及待地想看到你的贡献。作为一家人员和资金有限的初创公司,我们有着雄心勃勃的目标,希望设计出最直观的工作流程来构建和管理 LLM 应用程序。社区的任何帮助都是宝贵的。
考虑到我们的现状,我们需要灵活快速地交付,但我们也希望确保像你这样的贡献者在贡献过程中获得尽可能顺畅的体验。我们为此编写了这份贡献指南,旨在让你熟悉代码库和我们与贡献者的合作方式,以便你能快速进入有趣的部分。
这份指南,就像 Dify 本身一样,是一个不断改进的工作。如果有时它落后于实际项目,我们非常感谢你的理解,并欢迎任何反馈以供我们改进。
在许可方面,请花一分钟阅读我们简短的 。社区还遵守 。
现有问题,或 一个新问题。我们将问题分为两类:
如果你要提出新的功能请求,请解释所提议的功能的目标,并尽可能提供详细的上下文。 制作了一个很好的 ,可以帮助你起草需求。随时尝试一下。
如果你想从现有问题中选择一个,请在其下方留下评论表示你的意愿。
相关方向的团队成员将参与其中。如果一切顺利,他们将批准你开始编码。在此之前,请不要开始工作,以免我们提出更改导致你的工作付诸东流。
根据所提议的功能所属的领域不同,你可能需要与不同的团队成员交流。以下是我们团队成员目前正在从事的各个领域的概述:
Architecting Agents
RAG pipeline design
Building workflow orchestrations
Making our frontend a breeze to use
Developer experience, points of contact for anything
Overall product direction and architecture
优先级的评判标准:
High-Priority Features as being labeled by a team member
High Priority
Medium Priority
Non-core features and minor enhancements
Low Priority
Valuable but not immediate
Future-Feature
立即开始编码。
优先级的评判标准:
Bugs in core functions (cannot login, applications not working, security loopholes)
Critical
Non-critical bugs, performance boosts
Medium Priority
Minor fixes (typos, confusing but working UI)
Low Priority
以下是设置 Dify 进行开发的步骤:
从终端克隆 fork 的仓库:
Dify 依赖以下工具和库:
为了帮助你快速了解你的贡献在哪个部分,以下是 Dify 后端和前端的简要注释大纲:
&
&
Popular feature requests from our
version 8.x.x or
version 3.11.x
Dify 由后端和前端组成。通过 cd api/
导航到后端目录,然后按照 进行安装。在另一个终端中,通过 cd web/
导航到前端目录,然后按照 进行安装。
查看 以获取常见问题列表和故障排除步骤。
为了验证你的设置,打开浏览器并访问 (默认或你自定义的 URL 和端口)。现在你应该看到 Dify 正在运行。
如果你要添加模型提供程序,请参考 。
如果你要向 Agent 或 Workflow 添加工具提供程序,请参考 。
注意:如果你想要贡献新的工具,请确保已在工具的 YAML
文件内留下了你的联系方式,并且在 帮助文档代码仓库中提交了对应的文档 PR。
Dify 的后端使用 Python 编写,使用 框架。它使用 作为 ORM,使用 作为任务队列。授权逻辑通过 Flask-login 进行处理。
该网站使用基于 Typescript 的 模板进行引导,并使用 进行样式设计。 用于国际化。
最后,是时候向我们的仓库提交一个拉取请求(PR)了。对于重要的功能,我们首先将它们合并到 deploy/dev
分支进行测试,然后再合并到 main
分支。如果你遇到合并冲突或者不知道如何提交拉取请求的问题,请查看 。
就是这样!一旦你的 PR 被合并,你将成为我们 中的贡献者。
如果你在贡献过程中遇到困难或者有任何问题,可以通过相关的 GitHub 问题提出你的疑问,或者加入我们的 进行快速交流。