Skip to main content
本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版
manifest 是一个定义插件基本信息的 YAML 文件,包括名称、作者、包含的工具和模型等。如果文件格式不正确,插件的解析和打包会失败。 关于插件的整体架构,详见 插件开发基本概念开发者速查表

代码示例

下面是一个简单的 manifest 文件,每个字段都会在后续的「结构」一节中说明。实际示例可参考 Google 工具插件 manifest

结构

version
required
插件版本。
string
required
插件类型。目前仅支持 plugin,未来将支持 bundle
string
required
作者,定义为市场中的组织名称。
object
required
多语言名称。
RFC3339
required
创建时间。市场要求该时间不能晚于当前时间。
string
required
图标路径。
object
插件申请的资源。
int64
最大内存使用量,单位为字节。主要与 Dify Cloud 上的 AWS Lambda 资源分配相关。
object
插件申请的权限。
object
反向调用工具的权限。
boolean
是否启用工具权限。
object
反向调用模型的权限。
boolean
是否启用模型权限。
boolean
是否启用大语言模型权限。
boolean
是否启用文本嵌入模型权限。
boolean
是否启用重排序模型权限。
boolean
是否启用文本转语音模型权限。
boolean
是否启用语音转文本模型权限。
boolean
是否启用内容审核模型权限。
object
反向调用节点的权限。
boolean
是否启用节点权限。
object
注册 endpoint 的权限。
boolean
是否启用 endpoint 权限。
object
反向调用 app 的权限。
boolean
是否启用 app 权限。
object
申请持久化存储的权限。
boolean
是否启用存储权限。
int64
允许的最大持久化存储大小,单位为字节。
object
required
列出插件所扩展能力对应的 YAML 文件,使用插件包内的绝对路径。例如,要扩展一个模型,需定义一个类似 openai.yaml 的文件并在此列出其路径。该路径下必须存在对应文件,否则打包会失败。
以下组合不被允许:
  • 同时扩展工具和模型。
  • 同时扩展模型和 Endpoints。
  • 没有任何扩展。
目前,每种扩展类型仅支持一个 provider。
array[string]
工具 provider 的插件扩展。
array[string]
模型 provider 的插件扩展。
array[string]
Endpoints provider 的插件扩展。
array[string]
Agent 策略 provider 的插件扩展。
object
required
插件的元数据。
version
required
manifest 格式版本。初始版本为 0.0.1
array[string]
required
支持的架构。目前仅支持 amd64arm64
object
required
运行时配置。
string
required
编程语言。目前仅支持 Python。
string
required
语言版本。目前仅支持 3.12
string
required
程序入口点。Python 下应为 main
string
插件隐私政策的相对路径或 URL,例如 "./privacy.md""https://your-web/privacy"在 Dify 市场上架时必填,插件须明确说明如何使用用户数据。详见 插件隐私数据保护指南
Last modified on June 24, 2026