眠子子子1. 项目背景与核心问题
最近在部署Dify平台的junjiem-mcp_sse插件时，遇到了一个典型的Python环境兼容性问题。这个0.2.3版本的插件包在Python 3.12环境下运行时，出现了gevent模块的兼容性报错。这个问题在官方issue中也有记录（#25356），但官方文档对离线环境的处理说明不够详细。
提示：gevent是一个基于协程的Python网络库，它依赖于C扩展。在不同Python版本间迁移时，经常会出现ABI不兼容的问题。
问题的核心在于：插件包中的gevent wheel文件是针对特定Python版本编译的（比如cp311），而我们的生产环境是Python 3.12（cp312）。直接安装会导致如下报错：
code复制ERROR: Could not find a version that satisfies the requirement gevent==21.12.0
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 解决方案设计思路
经过分析，我们确定了两种可行的解决方案：
-
宿主机直接打包方案：
- 在联网机器上配置与离线环境完全一致的Python 3.12环境
- 使用dify-plugin-repackaging工具重新生成cp312版本的gevent wheel
- 优点：打包过程透明，便于调试
- 缺点：需要严格匹配glibc版本和CPU架构
-
Docker容器打包方案：
- 使用预配置好的Docker镜像（内含Python 3.12）
- 在容器内完成wheel的重打包
- 优点：环境隔离，不受宿主机环境影响
- 缺点：需要安装Docker，镜像体积较大
考虑到生产环境是银河麒麟V10系统，我们推荐优先使用Docker方案，因为：
- 麒麟系统的包管理器可能缺少某些依赖
- Docker能更好地保证环境一致性
- 避免污染宿主机环境
3. 详细实施步骤
3.1 准备工作
3.1.1 硬件资源准备
- 确保数据盘有至少5GB可用空间（系统盘可能空间不足）
- 建议工作目录：
/data/tools/dify-plugin-repackaging/ - 插件文件路径：`/data/packages/junjiem-mcp_s