post-install-cmd仅在首次安装（无composer.lock时）触发，post-update-cmd覆盖所有更新场景；两者需同时监听以确保逻辑总执行，且插件中事件名必须用字符串"post-install-cmd"而非常量。
post-install-cmd 和 post-update-cmd 的触发时机差异
很多人以为 post-install-cmd 会在每次 composer install 后执行，其实它只在首次安装（即没有 composer.lock 文件时）才触发；而 post-update-cmd 才覆盖所有更新场景——包括 composer update、composer install --with-dependencies，甚至 composer require 后的依赖重算。
想确保逻辑总被执行？必须同时监听两个事件，不能只靠一个。
-
post-install-cmd拿不到已安装包的完整列表（$composer->getRepositoryManager()->getLocalRepository()->getPackages()才是正确路径） -
post-update-cmd触发时composer.lock已写入，适合做版本比对或变更审计 - 若脚本返回非零退出码，后续命令会中断，CI 中尤其要加
|| true或显式处理错误
插件中监听事件必须用字符串，不是 ScriptEvents 常量
在自定义 Composer 插件里注册监听器时，事件名必须是纯字符串 "post-install-cmd"，而不是 ScriptEvents::POST_INSTALL_CMD。后者只在 composer.json 的 scripts 字段里有效，插件中用它会导致静默失效——Composer 不报错，也不提示，只是完全忽略。
常见拼写错误包括：post-install（缺 -cmd）、post-install-command（多写了 command）、postautoloaddump（漏连字符）。官方只认固定大小写+连字符组合，错一个就白写。
- 监听器注册必须在
activate()方法内完成，且仅限注册，不能放业务逻辑 -
activate()签名必须严格为activate(Composer $composer, IOInterface $io)，参数类型错一个也会静默失败 - 回调函数参数类型必须是
Event或其子类（如CommandEvent），不能写ScriptEvent
post-autoload-dump 是唯一能安全反射类的时机
如果你的插件需要自动注册服务提供者、写入 config/app.php、或调用 class_exists() 判断类是否存在，千万别在 post-install-cmd 或 post-update-cmd 里做。这些事件触发时，vendor/autoload.php 还没生成，类加载器未就绪，class_exists() 必然返回 false。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
唯一可靠的时机是 post-autoload-dump：此时自动加载文件已写完，所有已安装包的类都能被安全反射和实例化。
- 修改配置文件前务必先检查是否已存在对应条目，避免重复写入
- 推荐用
file_get_contents()+ 正则匹配，或用 AST 解析，别直接file_put_contents()覆盖整个文件 - 强烈建议从
$composer->getPackage()->getExtra()['my-plugin'] ?? []读开关配置，方便用户控制行为启停
获取已安装包列表的正确方式
在事件回调里想遍历当前项目已安装的所有包，不要用 $composer->getPackage()->getRequires()——那只是 composer.json 里声明的 require 列表，不含 transitive dependencies（传递依赖），也不含 dev-only 包。
真正反映本地实际安装状态的是本地仓库：
$localRepo = $composer->getRepositoryManager()->getLocalRepository(); $packages = $localRepo->getPackages();
这个 $packages 是完整、实时、已解析后的包实例数组，包含所有版本号、安装路径、autoload 配置等元数据。
- 遍历时注意：同一个包可能有多个版本（比如通过
path仓库安装的本地开发版 + packagist 版） - 判断包是否“启用”应结合
$package->getExtra()或$package->getType()，而非仅看名称 - 性能上，
getPackages()是 O(n) 操作，但 n 通常不大；若频繁调用，可缓存到静态属性（需注意多命令上下文隔离）
post-autoload-dump，越容易踩到自动加载未就绪的坑；越早监听（比如 pre-dependencies-solving），越难拿到最终安装结果。中间态的边界很薄，得靠真实命令流验证，不能只看文档推测。
