composer镜像配置生效的前提是构建节点已安装php和composer且jenkins用户有权限；需先验证composer命令可用，再通过composer config -g repo.packagist设置全局镜像。
Composer 镜像配置生效的前提是 PHP 环境已就绪
Jenkins 本身不运行 Composer，它只是调用系统中已安装的 composer 命令。所以第一步必须确认构建节点（agent）上已安装 PHP 和 Composer，并且 Jenkins 执行用户（如 jenkins）对该环境有权限。常见错误是脚本里写了镜像配置，但实际执行时提示 command not found: composer 或报错 Could not open input file: composer.phar——这说明根本没走到镜像配置环节。
验证方式：在 Jenkins 的 Pipeline 中加一行 sh 'which composer && composer --version'，确保输出正常。
全局镜像设置：用 config 命令修改 ~/.composer/config.json
最稳妥、最常用的做法是在构建前执行一条 composer config 命令，直接写入全局配置。注意不是改项目里的 composer.json，而是改当前用户主目录下的 Composer 配置文件。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 推荐命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
-g表示全局（global），作用于~/.composer/config.json -
repo.packagist是 Composer 8+ 的标准配置项；旧版本（repositories.packagist.org.url - 阿里云镜像地址稳定可用；清华源地址为
https://packagist.phpcomposer.com（已停用）或新地址https://mirrors.tuna.tsinghua.edu.cn/composer/
临时镜像覆盖：用 --repository-url 参数绕过配置
如果不想改动全局配置（比如多项目混跑、镜像需求不一致），可在 composer install 或 update 时直接传参：
composer install --repository-url=https://mirrors.aliyun.com/composer/- 该参数会覆盖
composer.json和全局配置中的 packagist 源 - 注意：不能和
--no-plugins同时使用（某些插件依赖仓库元数据） - 性能上无差异，但每次都要写，容易遗漏
CI 环境下容易忽略的权限与缓存问题
Jenkins agent 以独立用户身份运行，~/.composer 目录归属可能不对，或者缓存残留导致镜像未生效。
- 首次运行前建议清理：
rm -rf ~/.composer/cache - 检查
~/.composer/config.json文件权限，确保 Jenkins 用户可读写（常见坑：sudo -u jenkins composer config -g ...必须用对用户） - 若用 Docker agent，镜像配置需写入容器内的
/var/jenkins_home/.composer/config.json，而非宿主机 - Composer 2.5+ 默认启用插件，某些镜像站不支持插件元数据接口，可加
--no-plugins规避
真正起效的那行指令就是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但前提是它跑在正确的用户上下文、正确的 PHP 环境里，且没被残留缓存骗过去。
