From 2fd3e1e37edea7a73dd40684119f0bf096c662a2 Mon Sep 17 00:00:00 2001
From: jxxghp <jxxghp@gmail.com>
Date: Thu, 21 May 2026 21:37:18 +0800
Subject: [PATCH] docs: clarify plugin dependency constraints

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 80c54f2..722d2c4 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,8 @@ MoviePilot-Plugins/
 ### 4. 依赖
 - 可在插件目录中放置 `requirements.txt` 文件声明额外依赖，MoviePilot 安装插件时会自动安装。
 - 依赖尽量保持最小化，优先复用主程序已提供的公共能力，例如下载器、媒体服务器、通知渠道、缓存、链式处理等封装。
+- 插件依赖安装在 MoviePilot 的共享 Python 运行环境中，不是每个插件独立虚拟环境。不要在插件 `requirements.txt` 中重新声明或覆盖主程序已经提供的依赖版本。
+- MoviePilot 会在安装前保护主程序依赖图：核心依赖会严格锁定当前版本，其他主程序依赖也不能被插件要求降级或改成不兼容版本；发生冲突时插件安装会被拒绝。
 - 如果插件还依赖 Vue 远程组件，请将前端依赖放在独立的前端工程中构建后再产出到插件目录，不要把前端源码直接混入主插件包。
 
 ### 5. 界面开发