必须用shell wrapper捕获exit code与stderr，因Composer install失败时不执行scripts钩子，也不抛PHP异常；需重定向stdout/stderr、采集环境信息并轻量上报。
Composer install 时如何捕获并上报错误日志
Composer 本身不提供客户端钩子机制，scripts 中的钩子（如 post-install-cmd）只在命令成功执行后触发，失败时根本不会运行。想在构建失败时收集环境信息并上报，必须绕过默认流程，在调用 composer install 前后加壳处理。
- 最可靠的方式是用 shell 脚本包装：捕获
composer install的退出码、标准输出和标准错误，再统一上报 - 避免依赖
composer.json的scripts钩子——它们对失败无响应 - 注意区分
stderr和stdout：Composer 的报错主要走stderr，但部分警告或调试信息可能混在stdout，建议两者都重定向捕获
如何获取真实构建环境上下文
仅捕获错误日志远远不够，关键是要知道“在哪台机器、用什么配置、以什么权限、在哪个目录”下失败。这些信息不能靠 Composer 自身提供，得在 wrapper 脚本里主动采集。
- 执行
php -v、composer --version、uname -a（Linux/macOS）或ver（Windows）记录基础环境 - 用
pwd或%cd%记录当前工作路径，确认是否在预期项目根目录 - 检查
COMPOSER_HOME、COMPOSER_CACHE_DIR等环境变量，缓存路径异常常导致安装失败 - 注意 PHP 的
disable_functions（如proc_open）会静默破坏 Composer 行为，需单独检测
上报失败日志时要注意哪些兼容性问题
上报逻辑必须足够轻量且容错，否则二次失败会让问题更难排查。不要在上报环节引入新依赖（比如 require cURL 扩展），也不要阻塞主流程。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 优先使用
curl或wget发送 POST 请求；若不可用，降级为写本地文件（如logs/composer-error-$(date +%s).log） - 上报 payload 限制总大小（建议 ≤1MB），避免因日志过大导致 HTTP 超时或服务端拒绝
- 敏感字段如
$_SERVER['HOME']、pwd输出需脱敏，尤其 CI 环境中可能含 token 或密钥路径 - 不要在
post-root-package-install这类钩子里尝试上报——它只在 root 包安装成功后触发，根本收不到失败现场
为什么不能用 Composer Plugin 实现这个需求
有人尝试写 Composer Plugin 注册事件监听，但实际行不通：Plugin 的生命周期由 Composer 控制，而安装失败时整个进程可能已提前终止，EventDispatcher 根本没机会派发 PreInstallEvent 以外的事件。
- Plugin 只能监听明确支持的事件（见
Composer\Script\Event），没有OnErrorEvent或FailedInstallEvent - 即使 hook 到
pre-install-cmd，也只在命令开始前执行，无法拿到失败后的堆栈或 exit code - Plugin 加载本身依赖 autoloader，而安装失败往往就卡在 autoloader 初始化阶段，Plugin 根本加载不了
真正能稳定捕获失败的，只有外层 shell 或 CI 脚本的 $? 和重定向流。这点容易被忽略，但决定了方案能否落地。
