“the process timed out”错误本质是子进程（如git clone、unzip）被强制终止，主因是process-timeout默认仅300秒过短；应全局设composer config -g process-timeout 1800，配合阿里云镜像与clear-cache生效。

“The process timed out” 错误本质是 Composer 启动的子进程（比如 git clone、unzip、php 脚本）被强制终止，不是网络慢或包大本身的问题，而是超时配置太短 + 没配对生效。

看到 “The process timed out” 就该调 process-timeout

这个错误一定伴随类似 [RuntimeException] The process "git clone ..." exceeded the timeout 的输出，说明是外部命令执行太久。它和 HTTP 下载无关，只受 process-timeout 控制——默认仅 300 秒，对含 Git 包、私有仓库或复杂 post-install-cmd 的项目完全不够。

• 全局永久生效：composer config -g process-timeout 1800（建议设为 1800，即 30 分钟）
• 项目级写入：composer config process-timeout 1200（会写进当前 composer.json 的 config 段）
• 临时覆盖（CI/调试用）：COMPOSER_PROCESS_TIMEOUT=2000 composer install 或 composer install --process-timeout=2000
• 不推荐设为 0：万一远程 Git 仓库彻底不可达，进程会无限挂起，阻塞 CI 流水线

卡在 Downloading https:// 是另一个 timeout 在作怪

如果 -vvv 输出最后一行停在 Downloading https://...，那根本不是 process-timeout 的事，而是单次 HTTP 请求卡死。这时要调的是 http-basic-timeout（Composer 2.2+）或旧版的 http.timeout，它管 DNS 解析、TLS 握手、首字节等待和整个 body 传输。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 默认值太激进：Composer 2.2+ 默认仅 60 秒，国内常见首字节延迟高，必超时
• 必须同步调高 PHP 的 default_socket_timeout：运行 php -i | grep default_socket_timeout，若低于你设的 http-basic-timeout，PHP 层会先掐断连接
• 推荐值：全局设 composer config -g http-basic-timeout 600，再确认 default_socket_timeout ≥ 600

换镜像源比加 timeout 更治本，但必须清缓存才生效

80% 的 “超时” 实质是源不稳定：packagist.org 响应抖动、DNS 污染、TLS 握手失败。阿里云镜像（https://mirrors.aliyun.com/composer/）能绕过这些链路问题，但换完不清理缓存等于白换。

• 设镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证是否生效：composer config -g repo.packagist 应输出对应 URL；composer install --dry-run 中下载链接应变成 mirrors.aliyun.com
• 必须清缓存：composer clear-cache，否则仍可能复用损坏的 ZIP 或过期 metadata
• 注意例外："type": "git" 的包会绕过镜像直连 GitHub，此时仍需靠 process-timeout 和 Git 自身配置兜底

中断后 vendor/ 和缓存里的“半成品”最麻烦

Composer 没有断点续传。一次失败后，vendor/ 里可能残留破损的 autoload、截断的 installed.json，~/.composer/cache/files/ 里可能存着校验失败的 ZIP——它们不会自动消失，也不会被重试跳过，下次运行仍会触发 Content-Length mismatch 或提取失败。

• 不要直接删整个 vendor/：会导致 autoload.php 缺失，后续命令报错
• 精准清理：rm -f vendor/autoload.php && rm -rf vendor/composer/，再跑 composer dump-autoload → composer install
• 缓存已坏时，composer clear-cache 是唯一可靠解法，别指望 --retry 能救