Composer插件必须由主进程在install/update时加载，需满足type为"composer-plugin"、实现PluginInterface、extra.class正确指向且可自动加载；仅全局安装或项目根目录require才生效，require后须运行install/update。

Composer 插件不会因为 composer require 就自动生效——它必须被 Composer 主进程在 install 或 update 阶段加载并实例化，而这个过程依赖严格的配置、类型声明和生命周期时机。

插件不生效？先确认是不是真插件

很多包被误认为是插件，其实只是普通库或命令行工具。真正能干预 Composer 行为的插件，必须同时满足以下条件：

• composer.json 中明确声明 "type": "composer-plugin"
• 实现 Composer\Plugin\PluginInterface（注意命名空间和接口全名，拼错一个字母就静默失败）
• extra.class 字段存在且指向可自动加载的完整类名，如 "Acme\MyPlugin\Installer"，不能是短名或相对路径
• 该类在 autoload（通常是 psr-4）中正确映射，否则 Composer 根本找不到它

验证方式：运行 composer show vendor/package，检查输出里是否包含 types : composer-plugin。没有？那它不是插件，只是个普通依赖。

全局安装 vs 项目内 require，哪个才对？

绝大多数 Composer 插件（比如 hirak/prestissimo、dealerdirect/phpcodesniffer-composer-installer）必须全局安装，否则根本不会被扫描到。

• 全局安装：用 composer global require vendor/plugin，确保 ~/.composer 可写，且该目录在 Composer 的 autoloader 路径中
• 项目内安装：仅适用于通过 path repository 显式引入的本地插件，且必须在根项目的 composer.json 中声明为 require 或 require-dev，不能只放在被安装的包里
• composer require vendor/plugin 后不执行 composer install 或 composer update vendor/plugin，插件类永远不会注册

常见假象：执行 composer global require 后马上跑 composer install，却没看到任何日志——这不是插件没运行，而是它压根没被 Composer 扫描到。用 file_put_contents('/tmp/plugin-activated', 'yes') 在 activate() 里打点，再执行 composer -V 验证，才是唯一靠谱的检测方式。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

插件装了但命令不出现？检查 getCommands() 和继承关系

插件生效 ≠ 命令注册成功。自定义命令需要额外契约：

• 插件类必须实现 getCommands() 方法，并返回 Composer\Command\Command 实例数组
• 每个命令类必须继承 Composer\Command\BaseCommand（或兼容基类），不能只是普通类
• 运行 composer list 查看命令是否列出；没出现，说明插件虽加载成功，但未暴露命令
• 某些插件需在根项目 composer.json 的 extra 字段中手动启用，比如 "my-plugin": {"enabled": true}，否则 getCommands() 可能直接返回空数组

别在事件回调里 throw 异常来“中断流程”——这会让整个 composer install 报红退出，用户只看到堆栈，看不到你的提示信息。

本地开发调试时，改了代码却没反应？缓存和重载是关键

Composer 不会自动检测插件文件变更，改完代码不重建 autoload，旧版本仍驻留在内存中：

• 删掉 vendor/composer/autoload_psr4.php 和 vendor/composer/autoload_classmap.php，强制重建 autoloader
• 执行 composer dump-autoload -o 确保新类路径生效
• 必须重新运行 composer install（不是 require），否则 Composer 仍使用缓存的旧实例
• 如果插件修改了安装路径（如 type: theme），还需 composer clear-cache 并删掉 vendor/ 和 composer.lock 后重装，否则 Composer 会复用已缓存的路径信息

最易被忽略的一点：插件类构造函数如果有依赖（比如 IOInterface 以外的参数），而这些依赖在 Composer 初始化阶段尚未解析，就会静默失败——无报错、无日志、不触发 activate()。调试时优先检查构造函数是否干净。