composer update没拉到私有包最新版，因默认不主动刷新私有源元数据缓存，需手动删~/.composer/cache/repo/https---pkg.example.com/、用--no-cache强制重拉或临时改url触发重建索引。
composer update 为什么没拉到私有包的最新版
不是网络卡，也不是权限问题，而是 Composer 默认不会主动刷新私有源（repositories）的元数据缓存。它只在首次访问或缓存过期（默认 24 小时）时才重新请求 packages.json。如果你刚在私有仓库里发布了一个新 tag 或更新了分支，composer update 很可能还在用旧索引——于是报 Could not find package xxx at version yyy。
- 私有源不走 Packagist 的实时同步机制，完全依赖你配置的 URL 是否可访问 + 缓存是否过期
- 本地
vendor/composer/installed.json和composer.lock不包含源索引时间戳，无法直观判断“是不是最新” - 执行
composer clear-cache对私有源无效——它只清下载包缓存（~/.composer/cache），不碰元数据缓存（~/.composer/cache/repo）
强制刷新私有源索引的三个有效方法
核心思路：让 Composer 主动重新抓取私有源的 packages.json，而不是等缓存过期。以下三种方式按推荐顺序排列：
- 加
--prefer-source+--no-cache组合：执行composer update --prefer-source --no-cache。前者强制从 Git 克隆而非 zip 包，后者跳过所有缓存（包括 repo 元数据缓存）。适合调试，但会显著变慢 - 手动删私有源缓存目录：找到对应源的缓存路径，例如私有源 URL 是
https://pkg.example.com，则删掉~/.composer/cache/repo/https---pkg.example.com/（Linux/macOS）或%COMPOSER_HOME%\cache\repo\https---pkg.example.com\（Windows）。再跑composer update就会重建索引 - 临时改
composer.json中的私有源 URL：比如末尾加个查询参数"url": "https://pkg.example.com/?t=123"，保存后执行composer update，Composer 会把它当全新源处理，重新拉packages.json
私有源配置中容易被忽略的两个关键点
很多团队把私有源写进 composer.json 后就以为万事大吉，结果发现更新总滞后。问题往往出在配置本身：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
type必须是vcs、package或composer，不能留空或写错。例如 Git 私仓必须用"type": "vcs"，否则 Composer 会跳过该源的索引更新逻辑 - 如果私有源是
composer类型（即提供自己的packages.json），URL 必须能直接返回 JSON，且响应头含Content-Type: application/json。Nginx/Apache 若未配 MIME 类型，会返回text/plain，导致 Composer 静默跳过该源
CI/CD 环境下如何确保每次构建都用最新私有包
在 GitHub Actions、GitLab CI 等无状态环境中，缓存不可靠，必须显式控制索引行为：
- 不要依赖全局
composer config -g—— 容器每次启动都是干净环境，配置无效 - 在 CI 脚本开头加一步：先运行
composer config repositories.myprivatesource --unset（若之前设过），再用composer config repositories.myprivatesource composer https://pkg.example.com/重置源，强制触发首次索引 - 更稳妥的做法：CI 中统一用
composer update --no-cache --with-dependencies，避免任何缓存干扰，代价是构建稍慢，但结果确定
私有包更新不及时，90% 的情况不是仓库没发布成功，而是 Composer 根本没去“看”它。重点盯住缓存路径、type 值和响应头这三处，比反复重试 update 有用得多。
