CI中path依赖因路径不存在而失败，需显式排除；可靠禁用方式为unset仓库或--repository-url覆盖；fallback需按序配置无效path+显式packagist.org。
CI流程中path依赖默认不会被跳过，必须显式排除——否则会因路径不存在直接失败。
为什么CI里path仓库总报错“Could not find package”
path仓库本质是本地文件系统引用，而CI环境（Docker、Runner）通常不挂载你本机的./local-pkg路径，composer install读到repositories里一个根本不存在的绝对路径，就会静默忽略该仓库，接着在require阶段找不到包，最终报Could not find package vendor/name。
这不是缓存问题，也不是权限问题，是路径从一开始就没意义。
- CI镜像里没有
/home/user/pkg，但composer.json里写了"url": "/home/user/pkg"→ Composer查不到，跳过，不警告 -
composer config repositories.mypkg在CI里执行成功，但cat ~/.composer/config.json里压根没写入 → 因为路径非法（含~、相对路径、末尾/），Composer直接丢弃 - 你本地能装，CI不能装，且
composer show看不到该包 → 基本可断定path仓库未生效
CI中彻底禁用path仓库的两种可靠方式
不能靠“不配置”，因为composer.json可能已提交了repositories。必须主动剥离。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer install前，先删掉仓库配置：composer config --unset repositories.mypkg（前提是知道key名） - 更通用的做法：用
--no-plugins+ 临时覆盖配置：composer install --no-plugins -n --repository-url=https://packagist.org，它会忽略composer.json里所有repositories，只走Packagist - 如果项目必须保留path配置但CI不用，建议把path仓库移到
config.platform之外的独立配置文件，再通过COMPOSER环境变量切换：COMPOSER=composer.ci.json composer install
想保留path逻辑但让CI自动 fallback 到 Packagist
Composer本身不支持“fallback仓库”，但可以用repositories顺序 + packagist.org显式声明来模拟：
{
"repositories": [
{
"type": "path",
"url": "/dev/null/this-will-fail-on-ci",
"options": { "symlink": false }
},
{
"type": "composer",
"url": "https://packagist.org"
}
]
}
只要第一个path仓库路径无效，Composer会跳过它（静默），继续尝试下一个仓库。关键点：
- 必须把
packagist.org显式列出来，否则默认的隐式仓库会被禁用 - path仓库的
url要选一个CI里100%不存在的路径（如/dev/null/xxx），避免误命中 - 不要用
type: "package"替代——它需要完整定义name、version、dist，维护成本高且易和lock冲突
最易被忽略的是：path仓库一旦写进composer.json并提交，就等于把本地开发约定强加给了CI。真要兼顾，得接受“CI里它不存在”这个事实，而不是期待Composer自动识别环境并跳过。
