Composer插件必须实现CommandProvider接口才能被识别，且需在PluginInterface实现类中返回该接口实例；命令类须继承Symfony Console Command，但由Composer控制入口，并通过getApplication()->getComposer()获取项目上下文。
Composer插件必须实现 CommandProvider 接口才能被识别
Composer 不会自动扫描任意类作为命令，它只认实现了 ComposerPluginCommandProvider 接口的类。没实现这个接口，哪怕类名带 Command、文件放对位置，也完全不会出现在 composer list 里。
常见错误是直接写个继承 SymfonyComponentConsoleCommandCommand 的类就以为完事了——这只能在 Symfony 应用里跑，在 Composer 插件里纯属“隐身”。
- 必须在插件主类（实现
PluginInterface的那个）里返回一个包含CommandProvider实例的数组 -
CommandProvider::getCommands()方法必须返回Command对象数组，不能返回类名字符串或闭包 - 命令类本身仍需继承
SymfonyComponentConsoleCommandCommand，但入口由 Composer 控制，不是你手动 new 出来调用
命令类里 configure() 和 execute() 的参数来源很特殊
Composer 命令的 $input 和 $output 是标准 Symfony Console 组件对象，但它们携带的上下文比普通 CLI 应用更重：比如当前项目根目录、composer.json 解析结果、已激活插件列表，甚至仓库配置。
容易踩的坑是直接用 getcwd() 或硬编码路径——插件可能在子目录运行，也可能被全局安装，工作目录不等于项目根目录。
- 要用
$this->getApplication()->getComposer()->getConfig()->get('vendor-dir')拿 vendor 路径，别拼./vendor - 获取当前项目信息必须通过
$this->getApplication()->getComposer()->getPackage()，而不是读取本地composer.json文件 - 如果命令需要访问已加载的插件或事件监听器，得从
$this->getApplication()->getComposer()->getPluginManager()拿，不能自己 new
全局插件和本地插件的加载时机与作用域完全不同
全局插件（装在 ~/.composer/vendor/ 下）在每次执行任何 composer 命令时都会被加载；本地插件（项目 composer.json 里声明的）只在该目录及子目录下生效，且仅当项目已安装依赖（即存在 vendor/autoload.php）时才可用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这意味着：你本地开发调试插件时，如果用 composer install 安装后又删了 vendor，命令就立刻消失——不是插件坏了，是 Composer 根本没机会加载它。
- 开发阶段建议先用全局方式安装：
composer global require your/name:dev-main，绕过本地 autoload 依赖 - 发布前务必测试本地模式：把插件加进目标项目的
require-dev，再composer update，确认composer list能看到命令 - 不要在插件里假设
vendor/autoload.php一定存在，全局插件启动时它大概率还没生成
composer.json 中的 extra.command-provider 必须指向可 autoload 的类
这个字段告诉 Composer：“去这个类里找命令”，但它不是自动帮你注册命名空间的开关。如果类所在的 PSR-4 命名空间没在 autoload 或 autoload-dev 里正确定义，Composer 会报 Class not found，而不是静默忽略。
最常漏掉的是：写了 "extra": { "command-provider": "My\Plugin\CommandProvider" }，但没在 autoload 里配 "My\Plugin\": "src/"。
- 类文件路径必须和命名空间严格匹配，大小写敏感，尤其在 Linux/macOS 上
- 如果用
classmap，确保composer dump-autoload已执行，否则新类不生效 - 字段值必须是完整类名字符串，不能是数组、不能带括号、不能是相对命名空间
插件机制本身轻量，但 Composer 的生命周期和 autoloading 触发时机非常具体——错一步，命令就“不存在”。真正卡住人的往往不是逻辑，而是哪一行 autoload 没生效、哪个路径没走对、或者哪个对象是在不同阶段初始化的。
