先确认镜像源是否真生效：项目级 repositories 配置会屏蔽全局设置，需检查 composer config --list | grep repositories 并删除或修正 composer.json 中的 repositories 字段；镜像同步延迟时应使用 composer update --refresh 强制刷新元数据缓存（Composer ≥ 2.5），而非 clear-cache；宝塔中需确保使用网站对应 PHP CLI 环境并启用 openssl、curl 扩展。
composer update 不拉新版本？先确认镜像源是否真生效
执行 composer update 却装不到刚发布的包，大概率不是网络或权限问题，而是 Composer 根本没连上你以为的镜像源。项目级 repositories 配置会完全屏蔽全局设置，哪怕你已运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，只要项目 composer.json 里有 "repositories" 字段（哪怕只写了 {"packagist.org": false}），它就直接失效。
检查方式很简单：
- 运行
composer config --list | grep repositories，看repositories.packagist.url输出是否为你配置的镜像地址 - 打开项目根目录的
composer.json，搜索repositories—— 如果存在，且 URL 是过期的（如https://packagist.phpcomposer.com）或空对象，就得删掉或重写 - 临时验证：运行
composer config --unset repositories（不加-g），再试composer update
镜像源同步延迟时，composer update --refresh 才是正解
你以为镜像已更新，但 composer update 还是“Nothing to install or update”，是因为 Composer 默认复用本地缓存的 packages.json（15 分钟内不过期），根本不去镜像站重新拉元数据。这不是网络慢，是逻辑跳过。
composer update --refresh（Composer ≥ 2.5）专治这个：它强制丢弃所有已缓存的 packages.json，只从当前生效的镜像源重新下载最新元数据，不碰 ZIP 包缓存，轻量且精准。
- 确保你用的是 Composer 2.5+：
composer --version - 确认镜像已正确配置：
composer config -g repo.packagist.url必须输出类似https://mirrors.aliyun.com/composer/ - 执行后立刻再跑
composer update vendor/package-name，新版本就能被识别出来 - 老版本（≤ 2.4）不支持该参数，只能手动删缓存目录下的对应 repo 子路径：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
composer clear-cache 清不掉镜像源延迟，别被名字骗了
composer clear-cache 只清本地 ~/.composer/cache/ 下的 ZIP 和 provider 缓存，但它**不强制刷新远程元数据**——下次 update 还是会立刻重建 packages.json 并复用旧内容，除非你干预。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
真正影响“能否看到新版本”的，只有 packages.json 这个文件。它的刷新逻辑独立于其他缓存：
- 删整个
cache/repo/目录比clear-cache更彻底，但操作麻烦、易误删 - 加
--no-cache参数（如composer update --no-cache）会让本次完全跳过所有缓存查找，包括元数据，但代价是每次都要重拉，不适合日常 - 最稳妥的调试组合：先
composer config --unset repositories（排除项目覆盖），再composer update --refresh，最后composer update
宝塔面板里 Composer 更新失败？重点查 PHP CLI 和扩展
在宝塔面板中执行 composer update 报错或卡住，90% 不是镜像问题，而是 PHP CLI 环境和网站实际使用的 PHP 不一致：缺少 openssl、curl，或 SSL 证书路径不对。
必须用网站绑定的 PHP CLI 执行命令：
- 进网站根目录：
cd /www/wwwroot/example.com - 用面板里显示的 PHP 版本路径调用：
/www/server/php/81/bin/php /usr/local/bin/composer update - 确认
openssl和curl已启用：查看该 PHP 版本的php.ini，检查extension=openssl和extension=curl是否未被注释 - 如果报 SSL 错误，手动指定证书路径：
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt（Linux）或修改php.ini中的curl.cainfo和openssl.cafile
镜像源配置只是加速手段，底层 PHP 环境不稳，换再快的源也白搭。尤其注意宝塔里“PHP管理”页面显示的 CLI 路径和 php.ini 位置，别凭感觉用 php 命令。
