七牛云 Dify 插件

七牛云官方的 Dify 插件，为 Dify 平台提供全面的 AI 推理服务和云存储管理功能。

功能特性

🤖 AI 推理模型供应商

支持多种先进的 AI 大语言模型：

• OpenAI 开源系列：GPT-OSS-120b、GPT-OSS-20b
• DeepSeek 系列：deepseek-r1、deepseek-v3
• GLM 系列：GLM-4.5、GLM-4.5-Air
• Kimi 系列：Kimi-K2
• Qwen 系列：Qwen-Turbo、Qwen3-32B

📁 对象存储工具

提供完整的七牛云存储管理功能：

• 存储空间管理：列出账户下的所有存储空间
• 文件上传：支持内容上传，可指定存储空间、文件前缀、自定义域名等
• 文件列表：支持按前缀过滤、分页查询存储空间中的文件
• 文件内容获取：通过签名链接获取私有文件内容

安装使用

方式一：通过仓库地址安装（推荐）

1. 在 Dify 中选择 "Github" 安装方式
2. 输入本仓库地址后提交安装

方式二：通过离线安装包安装（推荐）

1. 在 release 手动下载离线安装包
2. 在 Dify 中选择"本地插件"安装方式
3. 上传插件包安装

方式三：插件市场安装

插件市场版本更新没有上述两种版本更新及时

1. 访问 Dify 插件市场
2. 搜索"七牛云"或"Qiniu"
3. 点击安装并按照提示配置

配置说明

AI 模型配置

插件安装后，在模型供应商设置页面对 AI 模型进行配置：

必需配置：

• API Key：在 七牛云 AI 推理控制台 获取

可选配置：

• Custom API endpoint URL：自定义 API 接口地址
  • 默认：https://openai.qiniu.com/v1

对象存储工具配置

在工具配置页面设置七牛云存储凭证：

必需配置：

• Access Key：在 七牛云密钥管理 获取
• Secret Key：在 七牛云密钥管理 获取

开发指南

环境要求

• Python 3.11+

开发步骤

1. 初始化开发环境

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
source venv/bin/activate  # macOS/Linux
# 或 venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

2. 配置调试环境

1. 在 Dify 中获取远程调试地址和 Key

   • 参考：Dify 插件调试文档

2. 复制环境配置文件：

   cp .env.example .env

3. 编辑 .env 文件，填入调试配置：

   INSTALL_METHOD=remote
   REMOTE_INSTALL_PORT=5003
   REMOTE_INSTALL_KEY=your-debug-key-here
   REMOTE_INSTALL_HOST=debug-plugin.dify.dev

3. 启动插件

python -m main

贡献指南

我们欢迎社区贡献！以下是参与贡献的几种方式：

🙏 贡献者

感谢所有为这个项目做出贡献的开发者：

由 contrib.rocks 自动生成

🐛 报告 Bug

如果你发现了 Bug，请通过以下方式报告：

1. 检查已有 Issues：在提交新 Issue 前，请先检查 Issues 页面 是否已有相关问题
2. 提供详细信息：报告 Bug 时请包含：
   • 详细的问题描述
   • 复现步骤
   • 预期行为 vs 实际行为
   • 环境信息（操作系统、Python 版本、Dify 版本等）
   • 相关的错误日志或截图

💡 功能建议

如果你有新功能的想法：

1. 先在 Issues 中搜索是否有类似建议
2. 如果没有，创建新的 Issue 并标记为 enhancement
3. 详细描述你的想法和使用场景

🛠️ 代码贡献

1. Fork 此仓库到你的 GitHub 账户
2. 创建功能分支：git checkout -b feature/your-feature-name
3. 本地开发：
   • 遵循现有的代码风格
   • 确保你的更改不会破坏现有功能
   • 如果可能，添加相应的测试
4. 提交更改：
   • 使用清晰、简洁的提交信息
   • 建议使用英文提交信息，格式：type: description
   • 示例：feat: add new model support for GLM-5
5. 推送分支：git push origin feature/your-feature-name
6. 创建 Pull Request：
   • 在 PR 描述中详细说明你的更改
   • 如果 PR 解决了某个 Issue，请在描述中引用：Fixes #issue-number

📝 文档贡献

文档改进同样重要：

• 修正错别字或不准确的信息
• 补充缺失的文档
• 改进文档结构和可读性
• 翻译文档到其他语言

🏷️ Issue 标签说明

为了更好地管理 Issues，我们使用以下标签：

• bug：确认的 Bug 报告
• enhancement：功能增强或新功能请求
• documentation：文档相关的改进
• good first issue：适合新贡献者的简单问题
• help wanted：需要社区帮助的问题
• question：使用问题或询问

📞 联系方式

如果你有任何问题或建议，可以通过以下方式联系我们：

• 在 GitHub 上创建 Issue
• 通过 GitHub Discussions 参与讨论

许可证

本项目采用 MIT 开源许可证，具体详情请查看 LICENSE 文件。