插件不生效需同时满足三条件：composer.json设"type":"composer-plugin"、主类实现plugininterface并含activate()/deactivate()方法、autoload路径正确映射；定制安装须接管installer而非监听事件；替换源管理器需在activate()中调用setrepositorymanager()；事件监听器必须签名正确且在activate()中注册。
插件不生效？先核对这三处硬性条件
Composer 插件静默失效，90% 的原因是没同时满足三个硬性条件：composer.json 中 "type": "composer-plugin"、主类实现 PluginInterface 并含 activate() 和 deactivate() 方法、autoload 路径能准确加载该类。
常见错误包括：
-
composer.json漏掉"type": "composer-plugin"—— Composer 直接跳过识别，连 warning 都不输出 - 主类写了
implements PluginInterface，但activate()方法为空或根本没写（哪怕空实现也必须存在） -
autoload映射错位，比如声明"psr-4": {"MyVendor\Plugin": "src/"}，实际类文件却在src/MyPlugin.php且命名空间是MyVendorPlugin，导致自动加载失败 -
require中写错"composer-plugin-api": "^1.0"（而你用的是 Composer 2.x），运行时报Class not found或方法不存在
想改安装行为？必须接管 Installer，不是监听事件
只监听 post-package-install 事件无法干预包解压路径、autoload 生成或跳过安装——此时文件已落盘，配置已写入。真要定制企业级逻辑（如私有模块类型 enterprise-module 的特殊解压规则），必须提供自定义 Installer 实例并注册到 InstallationManager。
关键操作：
- 在插件
activate()中调用$composer->getInstallationManager()->addInstaller(new EnterpriseModuleInstaller($io, $composer)) -
EnterpriseModuleInstaller::install()内部可调用$package->setInstallationSource('dist')强制走压缩包而非 Git clone - 拦截安装只需抛出
RuntimeException（例如签名校验失败时），不要手动删vendor/下的文件——应统一使用$filesystem实例操作 - 确保包的
composer.json中"type"字段值与你的Installer匹配（如"type": "enterprise-module"）
替换源管理器？用 setRepositoryManager() 覆盖默认实例
Composer 启动后会创建 RepositoryManager 实例并注入到 $composer 对象中，插件无法“中途替换”，但可在 activate() 中通过 $composer->setRepositoryManager() 覆盖它。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意事项：
- 自定义
RepositoryManager必须继承原类（ComposerRepositoryRepositoryManager），否则类型不兼容 - 构造函数里需重置
$this->repositories属性，清空默认源（如 Packagist），再注入企业内网 VCS 源 + Artifact 镜像 fallback - 别在
activate()里做网络请求（如预检内网源可用性）——CI 环境下易超时，建议放到具体命令触发时再校验 - 若同时启用多个插件修改源管理器，后激活的插件会覆盖前者的设置，无自动合并逻辑
监听事件总不触发？检查签名和注册时机
事件监听器不执行，往往不是逻辑问题，而是签名错或注册位置不对。Composer 事件系统对类型和时机极其敏感。
典型问题：
- 监听
post-install-cmd时，处理器方法签名必须是public function onPostInstall(CommandEvent $event)，写成public function onPostInstall($event)或public function onPostInstall(Event $event)会导致静默失败或ArgumentCountError -
post-autoload-dump不是每次composer install都触发——仅当 autoload 文件实际变更时才执行；调试时加--no-cache -v强制刷新 - 监听器必须在
activate()中注册：$composer->getEventDispatcher()->addListener('post-install-cmd', [$this, 'onPostInstall'])，不能放在构造函数或静态方法里 -
pre-file-download这类底层事件属于PluginEvents，不是ScriptEvents，混淆类别会导致监听无效
最易被忽略的一点：插件读取项目 composer.json 的 extra 字段，必须通过 $composer->getPackage()->getExtra() ?? [] 获取，直接 file_get_contents('composer.json') 在非根目录执行时路径会错，且绕过了 Composer 的 schema 校验。
