唯一可靠方式是在插件 activate() 方法参数中直接接收 IOInterface 实例，Composer 会自动注入；不可用 Factory::createIO() 或在命令构造函数中依赖，因其脱离当前执行上下文。
Composer插件里怎么拿到 IOInterface 实例
直接在插件的 activate() 或 deactivate() 方法参数里接收——这是唯一可靠、官方支持的方式。Composer 会自动把 IOInterface 和 Composer 实例注入进来，不需要手动查找、反射或 hack Factory。
常见错误是试图在命令类（Command）构造函数里直接依赖 IOInterface，但 Composer 不会自动解析它；或者去调用 Factory::createIO()，这会创建一个脱离当前运行上下文的新 IO 实例，比如颜色、交互状态、静默模式都对不上。
-
activate()的第一个参数就是IOInterface，第二个是Composer - 如果你写的是自定义命令，得在
configure()+execute()中通过$input/$output构造自己的IOInterface实现（如SymfonyStyle），不能复用插件激活时的那个 - 别在
PluginInterface以外的地方（比如事件监听器闭包里）想“临时获取”IOInterface——它没被绑定到容器，也没全局单例
为什么不能用 Factory::createIO() 替代
因为 Factory::createIO() 是静态工厂方法，它只看 CLI 参数和环境变量（如 COMPOSER_NO_INTERACTION），完全不感知当前命令执行上下文。你在 POST_INSTALL_CMD 事件里调它，输出可能被重定向了，但新创建的 IOInterface 还会尝试读取 stdin 或输出彩色字符，导致报错或乱码。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 真实场景：CI 环境中
$_SERVER['TERM']为空，createIO()默认启用颜色，结果输出 ANSI 转义符到日志文件 - 另一个坑：它不会继承当前
InputInterface的选项值（如--verbose），所以$io->isVerbose()永远返回false - 正确做法：把激活时传入的
IOInterface存为属性，在事件回调里复用它
在事件监听器里还能用吗
能，但必须提前保存。Composer 事件（如 ScriptEvents::POST_AUTOLOAD_DUMP）的监听器函数签名不带 IOInterface，你得靠闭包捕获或依赖注入方式把插件激活时拿到的实例传进去。
示例：
$this->io = $io; // 在 activate() 中保存
$event->getComposer()->getEventDispatcher()->addListener(
ScriptEvents::POST_AUTOLOAD_DUMP,
function (Event $event) {
$this->io->write('Regenerating cache...'); // 复用原始 IO
}
);
- 不要在监听器里 new 一个
ConsoleIO，它需要InputInterface和OutputInterface，而事件对象不提供标准 Symfony 组件实例 - 如果监听器逻辑复杂，建议封装成独立命令，再通过
CommandExecutor调用，这样 IO 行为更可控 - 注意：某些事件（如
PRE_FILE_DOWNLOAD）触发频繁，避免在其中做耗 IO 的操作（如反复writeLine），会影响安装速度
调试时看不到输出？检查这几个点
不是 IOInterface 失效，而是输出被 Composer 自身的静默策略吞掉了。最常踩的坑是没区分 write() 和 writeError()，或忽略了 Verbosity 级别。
-
$io->write('msg')输出到OutputInterface，但--quiet下会被抑制；$io->writeError('msg')走 stderr，不受 quiet 影响 -
$io->isVeryVerbose()对应-vv，isVerbose()对应-v，普通write()在-v下才显示 - 插件被加载但没激活？确认
composer.json的extra.plugin.autoload或require-dev配置正确，且插件类实现了PluginInterface
真正麻烦的永远不是怎么拿到 IOInterface，而是它背后绑定的输入源、输出目标、verbosity 状态、颜色支持这些上下文细节——漏掉任意一个，都会让“有输出”变成“看不见输出”。
