插件钩子卡死主因是镜像配置失败导致fallback至packagist.org引发超时重试，或旧插件（如fxp/composer-asset-plugin）绕过镜像机制；需严格校验composer config -g repo.packagist输出为含type和正确url的json，并移除废弃插件、合理设置http-max-concurrent-downloads≤8。
composer config -g repo.packagist 配错导致插件钩子卡死
插件钩子（如 pre-install-cmd、post-autoload-dump）本身不依赖镜像，但若全局镜像配置失败，composer install 会在解析阶段 fallback 到 packagist.org，触发大量超时重试——这些重试会阻塞整个流程，让钩子迟迟无法执行。常见错误包括：repo.packagist 写成 repos.packagist（多一个 s）、URL 缺末尾 /、漏掉 composer type 值。任一出错，composer config -g repo.packagist 输出为空或 {"type":"composer","url":"https://packagist.org"}，说明已静默回退，钩子实际运行前就卡在元数据加载上。
fxp/composer-asset-plugin 这类旧插件与镜像完全不兼容
该插件早已废弃，它绕过 Composer 原生镜像机制，直接请求 Bower/NPM 官方源（无国内镜像），且自身不支持 HTTP/2 和并发下载。一旦启用，composer install 会先跑完原生包安装，再单独拉前端资源——此时镜像配置对这部分完全无效，常表现为：前半段快，后半段卡死在 Downloading bower-asset/jquery。解决方案不是调镜像，而是移除插件：composer global remove fxp/composer-asset-plugin，并改用 npm-asset-packagist.org 或迁移到 yarn/npm。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
全局插件和项目插件共存时镜像不共享
全局插件（如 phpstan、php-cs-fixer）走的是 ~/.composer/config.json 里的镜像；项目级插件（require-dev 中的）走当前项目 composer.json 的 repositories 配置。两者互不影响，但容易误判为“镜像冲突”。例如：全局装了 phpstan v1.10，项目里 require-dev 指定 v1.12，即使都配了阿里云镜像，也会因版本不一致导致类加载失败——这不是镜像问题，是 autoload 路径隔离导致的。验证方式：composer global show phpstan/phpstan 和 composer show phpstan/phpstan 分别查版本。
http-max-concurrent-downloads 对钩子无影响，但设错会拖慢前置阶段
http-max-concurrent-downloads 只控制 composer install 下载 dist 包时的并发连接数，不影响钩子执行时机或逻辑。但它若设得过高（如 15），可能触发镜像站限流或本地 /tmp 文件竞争，导致 file_put_contents(/tmp/): failed to open stream 错误，进而中断整个安装流程——钩子自然不会被执行。稳妥值是 8；设完后必须验证：composer config -g http-max-concurrent-downloads 输出应为 8，而非空或旧值。
