插件下载报错90%是composer-plugin-api版本不兼容，需用composer diagnose确认、查composer.json声明、fork修改版本并测试hook行为。
插件下载报错，90% 不是插件本身坏了，而是 Composer 加载时发现 API 版本对不上——比如插件只声明支持 composer-plugin-api ^1.0，但你用的是 Composer 2.x 或 3.x。
怎么确认是插件兼容性问题
运行 composer diagnose，重点看末尾有没有类似 Plugin hirak/prestissimo is not compatible with Composer 2 的提示。有这句，基本就锁定了；没有，问题大概率出在镜像、缓存或网络上。
再查插件源码里的 composer.json：打开 Packagist 页面或 GitHub 仓库，搜 "composer-plugin-api" 字段。如果值是 "^1.0" 或压根没写，就是它了。
- 别信 README —— 有些作者发了
^2.0兼容版但没更新文档 - 运行
composer update vendor/plugin-name看是否已有新版本 - 如果插件 GitHub 最后提交是 2021 年前、标了
archived，基本可判定已放弃维护
插件已归档但又不能删，怎么救
硬删（composer remove hirak/prestissimo）能过编译，但可能损失构建速度或功能。更可持续的做法是 fork 修改：
- 把 fork 后的
composer.json中"composer-plugin-api": "^1.0"改成"^2.0"（或"^3.0"，取决于你当前 Composer 版本） - 在项目根目录
composer.json的repositories字段加一条："repositories": [{"type":"vcs","url":"https://github.com/yourname/prestissimo"}] - 再运行
composer update hirak/prestissimo，Composer 就会从你 fork 的仓库拉取
注意：改完 composer-plugin-api 版本后，必须实际测试插件逻辑是否还能跑通——API 版本兼容不等于行为完全一致。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么 composer update --dry-run 看不出插件问题
因为 --dry-run 不加载插件、不校验平台约束、也不触发插件注册钩子。它只做依赖解析，而插件兼容性检查发生在“加载”阶段，这个阶段被跳过了。
真正要模拟真实流程，得用：
composer update --no-plugins --dry-run -v
-
--no-plugins强制跳过所有插件，避免干扰 -
-v开详细日志，能看到第一个cannot be installed出现在哪条依赖路径上 - 如果这步也报错，说明问题在包本身；如果通过，那基本坐实是插件惹的祸
回退 Composer 1.x 是不是最省事
短期救火可以：composer self-update --1 能降到最新 1.x（目前是 1.10.22），但必须立刻跟一句 composer install。
不过要注意：composer-plugin-api ^1.0 插件在 Composer 1.x 下虽能跑，但 1.x 已停止安全更新，存在明确风险；且部分新包（如 Laravel 11+）已要求 Composer ≥ 2.5，回退后反而无法安装。
最常被忽略的一点是：改完插件的 composer-plugin-api 声明后，不测试其 hook 行为（比如 post-install-cmd 是否还触发、PluginInterface::activate() 是否返回异常），就直接上线，容易在 CI 或部署阶段突然失败。
