iointerface是composer封装cli交互行为的抽象接口，提供write/writeerror/isverbose等语义方法，由consoleio实现并对接symfony的input/output；必须通过activate()参数或$event->getio()复用运行时注入实例，不可手动new consoleio。
Composer 的 IOInterface 到底是什么
它不是“输入输出流”那种底层句柄，而是一个抽象接口（Composer\IO\IOInterface），封装了 CLI 场景下所有与用户交互的行为：写提示、读输入、判断是否静默、是否支持颜色、是否启用进度条。它的实现类 Composer\IO\ConsoleIO 才真正对接 symfony/console 的 InputInterface 和 OutputInterface。
关键点在于：这个接口不负责渲染逻辑，只提供语义方法——比如 $io->writeError() 不等于 echo "error"，它会检查当前是否在 CI 环境、是否加了 --no-ansi、是否被重定向到文件，再决定要不要加 ANSI 颜色码或换行符。
常见误用：$io->write('Installing...') 在非交互式环境里可能被吞掉，而 $io->writeError('Installing...') 会强制走 stderr，更可靠。
为什么插件里不能随便 new ConsoleIO
手动实例化 ConsoleIO（如 new ConsoleIO($input, $output, ...)）会导致行为失准，因为：
-
$io->isVerbose()可能永远返回false：它只读取构造时传入的$input，但 CI 中的--no-interaction或--quiet参数可能已被上层过滤 - 颜色控制失效：终端类型（
$_SERVER['TERM']）、ANSI 支持状态（COMPOSER_NO_ANSI）不会自动继承 - 进度条错位：手动创建的
IO实例不知道当前命令是否启用了--progress，调用$io->getProgressBar()可能返回空或异常对象
正确姿势是复用 Composer 运行时注入的那个实例——在 activate() 方法参数里接收，或在事件回调中通过 $event->getIO() 获取。
中文输出不是靠 IOInterface，而是靠字符串替换
IOInterface 本身对语言完全无感。Composer 所有英文文案（如 "Loading composer repositories"、"Could not find package"）都是硬编码在源码里的字符串，$io->write() 只是把它们原样吐出去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
所谓“中文支持”，实际是第三方插件（如 csineneo/lang-simplified-chinese）在 $io->write() 调用前，拦截输出内容做正则替换：
- 匹配
"Installing (.+)"→ 替换为"正在安装 $1" - 匹配
"Generating autoload files"→ 替换为"正在生成自动加载文件"
这导致两个硬伤：一是文案微调（如 Composer 升级后把 "Resolving dependencies" 改成 "Resolving packages"）就会让翻译失效；二是无法处理动态拼接内容（如 "Package foo/bar is abandoned, you should avoid using it. Use bar/baz instead."），替换规则极易漏匹配或错位。
CLI 输出控制的关键开关都在命令参数里
真正影响输出行为的，不是插件或 IO 接口，而是命令行参数组合：
-
--no-ansi：禁用所有 ANSI 颜色和光标控制字符，防止 CI 日志污染 -
--no-progress：关闭下载/解压环节的旋转图标和进度条（但保留普通日志） -
--quiet：只输出错误，连成功提示都吞掉（比--no-progress更激进） -
--verbose：展开详细日志，包括依赖解析树、HTTP 请求头等
这些参数在运行时由 ConsoleIO 解析并缓存，后续所有 $io->isQuiet()、$io->isDecorated() 调用都基于此。试图在插件里“绕过”这些设置强行着色或打印，大概率被终端忽略或引发乱码——因为底层已明确告知“此处不支持 ANSI”。
最常被忽略的一点：插件拿到的 IOInterface 实例，其行为完全由用户启动 composer 时的参数决定，而不是插件自己能改写的。想让输出“看起来更中文”或“更美观”，本质是在和 Composer 的设计哲学对抗——它压根没打算做成可主题化的 CLI 工具，所有美化都得在终端层、脚本层或 CI 配置层兜底。
