composer插件必须实现plugininterface并提供activate()方法，且composer.json需声明type为composer-plugin、正确配置autoload和require；事件监听须用eventdispatcher绑定对应event子类，避免异常中断命令。
Composer插件的入口类必须实现 PluginInterface
Composer 插件不是随便放个类就能被识别的——它必须声明自己是插件，并在 Composer 加载时注册行为。核心约束就一条：你的主类得实现 ComposerPluginPluginInterface，且必须提供 activate() 和 deactivate() 方法（后者可空实现）。
常见错误是只写了类、没写 implements PluginInterface，或者漏了 activate()；结果 Composer 安装时完全不报错，但插件逻辑压根不执行。
-
activate()是唯一真正能挂载逻辑的地方，比如监听事件、注册命令、修改安装器行为 - 类名和命名空间要和
composer.json中的autoload配置严格一致，否则自动加载失败，PluginInterface根本不会被实例化 - 别在
__construct()里做重操作——Composer 可能在非交互场景下加载插件（如 CI），此时 IO 或网络调用容易超时或失败
通过 EventDispatcher 监听生命周期事件
Composer 的扩展能力主要靠事件驱动，比如 post-install-cmd、pre-autoload-dump、post-package-install。这些事件不是靠“钩子函数”注册的，而是通过 $eventDispatcher->addListener() 显式绑定。
最容易踩的坑是监听了事件却没传对回调签名：监听器函数必须接受一个具体类型的 Event 子类（如 CommandEvent、PackageEvent），否则运行时报 ArgumentCountError 或静默失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 常用事件类型：
CommandEvent（命令执行）、PackageEvent（包安装/更新）、ScriptEvent（脚本执行） - 监听时机很重要：比如想改 autoload 文件，得监听
post-autoload-dump，而不是post-install-cmd（后者触发太早，autoload 还没生成） - 事件监听器不能抛出未捕获异常，否则整个 Composer 命令会中断；建议用
try/catch包裹业务逻辑
composer.json 必须声明 type: composer-plugin 并正确配置 extra
Composer 不靠文件名或目录结构识别插件，全靠 composer.json 的元信息。缺一不可：
-
"type": "composer-plugin"—— 没这行，Composer 就当你是普通库，不会尝试激活 -
"require": { "composer-plugin-api": "^2.0" }—— 版本号必须匹配你开发时基于的 Composer 主版本（1.x 或 2.x），写错会导致安装失败或运行时方法不存在 -
"autoload": { "psr-4": { "MyVendor\MyPlugin\": "src/" } }—— 路径必须能准确加载到实现PluginInterface的类 - 如果插件要提供自定义命令，还得加
"extra": { "class": "MyVendor\MyPlugin\MyPlugin" }，指向你的插件主类
典型错误：把 class 写成 MyPlugin（没命名空间），或路径映射错位导致类找不到，Composer 会安静地跳过插件加载，连 warning 都不给。
调试插件时优先看 composer diagnose 和 -v 日志
插件不生效？别急着重写代码。Composer 自带诊断工具比手动 var_dump 更可靠：
- 运行
composer diagnose，它会检查插件是否被识别、类能否加载、API 版本是否兼容 - 加
-v（verbose）参数执行任意命令，比如composer install -v，能看到插件被加载的日志行：Loading plugin MyVendorMyPluginMyPlugin - 如果没看到这行，说明
autoload或type配置有问题；如果看到了但逻辑没执行，大概率是事件监听没绑对或事件根本没触发 - 注意 Composer 的插件加载顺序：依赖树中越靠上的插件越先加载，冲突时后加载的可能覆盖前者的监听器
最隐蔽的问题是插件被加载了、事件也监听了，但事件本身没发生——比如你监听 post-update-cmd，却用 composer install 测试，自然不会触发。
