> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-add-new-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 插件

> 通过模块化组件扩展 Dify，包括自定义模型、工具和集成

插件是 Dify 连接一切的方式——模型提供商、外部 API、自定义工具。它们是扩展工作空间能力的模块化组件，只需安装一次即可在所有地方使用。

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/1Mn9PbDOxsURxQHH/images/plugins-tab.png?fit=max&auto=format&n=1Mn9PbDOxsURxQHH&q=85&s=a29b56612c165329498f75d49f779b51" alt="" width="1051" height="478" data-path="images/plugins-tab.png" />

通过工作空间中的插件选项卡访问插件管理。

## 插件工作原理

<img src="https://mintcdn.com/dify-6c0370d8-add-new-agent/1Mn9PbDOxsURxQHH/images/plugin-management.png?fit=max&auto=format&n=1Mn9PbDOxsURxQHH&q=85&s=fa011b5c1f19e323b164e5e560e9a5c5" alt="" width="3024" height="1902" data-path="images/plugin-management.png" />

插件的作用域是工作空间级别的。当你安装一个插件时，工作空间中的每个应用都可以使用它。团队成员根据其角色访问插件：

<Tabs>
  <Tab title="所有者和管理员">
    为整个工作空间安装、配置和移除插件
  </Tab>

  <Tab title="编辑者和成员">
    在他们创建或编辑的应用中使用已安装的插件
  </Tab>
</Tabs>

## 安装插件

<CardGroup cols={3}>
  <Card title="应用市场" icon="store">
    官方和合作伙伴插件，经过测试和维护
  </Card>

  <Card title="GitHub" icon="github">
    使用 URL + 版本从任何公共仓库安装
  </Card>

  <Card title="本地上传" icon="upload">
    用于私有或内部插件的自定义 .zip 包
  </Card>
</CardGroup>

## 插件的真正含义

将插件视为 Dify 与外部世界之间的桥梁：

<CardGroup cols={2}>
  <Card title="模型提供商" icon="microchip">
    Dify 中的每个 LLM（OpenAI、Anthropic 等）实际上都是一个插件
  </Card>

  <Card title="工具和函数" icon="wrench">
    API 调用、数据处理、计算——全部基于插件
  </Card>

  <Card title="自定义端点" icon="plug">
    将你的 Dify 应用公开为外部系统可以调用的 API
  </Card>

  <Card title="反向调用" icon="arrows-rotate">
    插件可以回调 Dify 来使用模型、工具或工作流
  </Card>
</CardGroup>

## 工作空间插件设置

在工作空间设置中控制插件权限：

<AccordionGroup>
  <Accordion title="安装权限">
    **所有人** - 任何成员都可以安装插件
    **仅管理员** - 只有工作空间管理员可以安装（推荐）
  </Accordion>

  <Accordion title="调试访问">
    **所有人** - 所有成员都可以调试插件问题
    **仅管理员** - 将调试限制为管理员
  </Accordion>

  <Accordion title="自动更新">
    选择更新策略（仅安全更新与所有更新）并指定要包含或排除的插件
  </Accordion>
</AccordionGroup>

安装后，大多数插件需要配置——API 密钥、端点或服务设置。这些设置适用于整个工作空间。

## 插件安装限制

<Callout icon="lock" color="#0033FF">仅限企业版</Callout>

在企业工作空间中，浏览插件市场时你可能会看到安装限制：

**你会遇到的情况：**

* 插件 → 探索市场中的"安装插件"下拉菜单可能显示有限选项
* 安装确认对话框将指示插件是否被策略阻止
* 导入带有插件的应用（DSL 文件）时，你会看到关于受限插件的通知

**市场中的插件徽章：**

![](https://assets-docs.dify.ai/2025/06/c2bfdfbb2132848e589073600e55ffab.png)

查找这些徽章以识别插件类型——你的工作空间可能只允许基于管理员设置的某些类型。

<Info>
  如果你无法安装所需的插件，请联系你的工作空间管理员。他们控制允许哪些插件来源（市场、GitHub、本地文件）和类型（官方、合作伙伴、第三方）。
</Info>

## 构建自定义插件

当你需要自定义功能时，使用 Dify 的 SDK 开发插件：

1. 从设置 → 插件 → 调试获取调试密钥
2. 在本地构建和测试你的插件
3. 打包为包含清单和依赖项的 .zip 文件
4. 私下分发或发布到市场