本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。市场是 Dify 官方的插件目录,收录由社区和合作伙伴构建的插件。将插件提交到这里,每位 Dify 用户都能一键安装它。 发布插件的方式是向
langgenius/dify-plugins 提交一个 Pull Request。审核者(以及一组自动化检查)会逐项检查该 PR,通过后插件会自动上线到 marketplace.dify.ai。
如果你还没有构建过插件,先从 Tool 插件实战教程 开始。
提交之前
Dify 审核者会对每个 PR 运行 12 项自动化预检。大多数被拒原因都是机械性问题,提前修复可以省下一轮审核。审核检查清单
以下是审核者依次运行的全部检查。把它当作提交 PR 前的预检清单。
任何一项检查失败都会中止审核,并发布一张包含
❌ Fail 行和所需修复项的状态表;你修复这些问题后再次推送即可。
提交 PR
1
阅读插件开发指南
浏览 插件开发指南。审核者依据它来判断非机械性的方面:独特性、品牌契合度、内容质量、知识产权,以及维护承诺。
2
编写隐私政策
在插件根目录创建
PRIVACY.md(或将其托管在别处,并把 URL 写入 manifest)。遵循 隐私保护指南:声明插件本身及其调用的任何第三方服务会收集哪些数据。3
打包插件
在插件项目所在目录的上一级运行:这会生成
your_plugin_project.difypkg。4
Fork 并添加文件
Fork
langgenius/dify-plugins。创建一个 <your-author-name>/<your-plugin-name>/ 文件夹,并把 .difypkg 放进去。5
提交 PR
推送到你的 fork,然后用仓库的 PR 模板向
main 提交一个 PR。标题和正文使用英文。6
回应审核
自动化检查会先发布结果,随后人工审核者跟进。通过推送新提交来处理反馈;每次推送都会重新运行检查。
合并到
main 后,插件会自动出现在 marketplace.dify.ai 上,无需单独的发布步骤。通过审核后
从合并那一刻起,这个插件就归你负责:- 修复缺陷与功能请求。 处理来自用户的 issue。
- 兼容性更新。 当 Dify 发布破坏性的 API 变更时,团队会提供迁移说明;你来更新插件。必要时 Dify 工程师可以协助。
- 版本管理。 在
manifest.yaml中提升version,重新打包,再带上新的.difypkg提交一个新 PR。自动发布 PR 工作流 可通过 GitHub Action 自动完成这一过程。
PR 生命周期
常见问题
如何判断我的插件与现有插件是否过于相似?
如何判断我的插件与现有插件是否过于相似?
市场按功能去重,而非按集成对象去重。一个仅新增了多语言版本的 Google 搜索插件属于重复。而一个增加了批量查询、更完善的错误处理或某项有意义新能力的 Google 搜索插件则可以接受;在 PR 描述中说明这一点。
我的 PR 被标记为过期或已关闭,接下来怎么办?
我的 PR 被标记为过期或已关闭,接下来怎么办?
过期 的 PR(闲置 14 天)可以重新打开;在 PR 上回复或推送一个修复即可重启计时。已关闭 的 PR(闲置 30 天)无法重新打开;修复反馈后,用同一个包提交一个全新 PR。
公测期间可以更新插件吗?
公测期间可以更新插件吗?
可以。避免破坏性变更:新增字段而非重命名,移除前先弃用。
可以发布付费插件吗?
可以发布付费插件吗?
暂时不行。市场目前只接受免费插件;变现政策将另行公布。
PR 正文需要同时包含英文和中文供我们团队使用,这样可以吗?
PR 正文需要同时包含英文和中文供我们团队使用,这样可以吗?
不行。PR 标题/正文中只允许那一行白名单双语提示。把内部的多语言备注放在别处(提交信息、内部文档)。
相关资源
发布方式总览
对比市场、GitHub 和本地文件三种分发方式。
插件开发指南
审核者所遵循的完整内容与质量标准。
隐私保护指南
如何编写一份能通过审核的
PRIVACY.md。自动发布 PR 工作流
在每次推送时自动打包并提交 PR 的 GitHub Action。
多语言 README
为非英文用户添加
readme/README_<lang>.md 文件。通用规范
manifest 字段参考。