必须加--add，否则Composer尝试赋值不存在的键会静默失败；--add确保将仓库配置以数组形式追加到repositories，避免覆盖误删，且URL须为合法JSON、末尾带/，type必须正确匹配服务类型。
composer config --add repositories.xxx 为什么必须加 --add
不加 --add 直接执行 composer config repositories.myrepo type composer，Composer 会尝试给 repositories.myrepo 这个键赋值，但该键默认不存在，结果是静默失败或报错（取决于版本），根本不会新增仓库条目。
正确做法是显式用 --add 告诉 Composer：“我要往 repositories 数组里塞一条新记录”。它会自动把仓库配置转成数组格式，即使原来没这个字段。
-
composer config --add repositories.myrepo '{"type":"composer","url":"https://my.repo/api/"}'—— 注意：单引号包裹整个 JSON 字符串，内部双引号保留 - 如果
myrepo已存在，--add会追加为数组新元素；不加则尝试覆盖，容易误删已有配置 - URL 必须是合法 JSON 字符串，写成
'{"type":"composer","url":"https://my.repo/api"}'（缺末尾斜杠）会导致请求路径拼错，静默失效
全局 vs 项目级 config 修改 repositories 的优先级差异
项目根目录下只要存在 composer.json 并含 "repositories" 字段（哪怕空数组），全局配置里的 repositories 就完全不生效。这是硬性规则，不是“叠加”或“fallback”。
也就是说：composer config -g repositories.myrepo ... 在有项目级 repositories 时等于白配。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 全局配置写入
~/.composer/config.json，影响所有项目（除非被项目级覆盖） - 项目级配置通过
composer config repositories.xxx ...直接写进当前composer.json的repositories字段 - 项目级永远优先；想验证是否生效，直接
cat composer.json | grep repositories看内容
repo.packagist 配置键名和 type 缺失导致镜像不生效
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后发现没换源？大概率是这三个坑之一：
- 键名写成
repos.packagist或repository.packagist—— 正确只能是repo.packagist（单数，无 s） - 漏掉
composer这个 type 参数，命令变成composer config -g repo.packagist https://...，结果存进无效字段 - URL 少了末尾
/，比如写成https://mirrors.aliyun.com/composer→ 请求路径变成https://mirrors.aliyun.com/composerpackages.json，404
验证方式不是看 composer config -g repo.packagist 输出，而是跑 composer diagnose，检查 Repo packagist.org: 行是否显示你设的地址。
私有仓库 type 配错导致 Could not find package
把一个 Satis 或 Private Packagist 地址配成 type: vcs，Composer 就会去按 Git 协议 clone，而不是发 HTTP 请求查 packages.json。结果要么 404，要么卡住，最后报 Could not find package —— 这错误信息毫无指向性。
-
type: composer→ 对应提供packages.json的 HTTP 服务，URL 必须以/结尾 -
type: vcs→ 对应 Git/SVN/Hg 地址，要求仓库根目录下有合法composer.json，且打过 tag 或有 version 字段 - 私有 GitLab 包仓库若启用了 Composer 支持（如 GitLab Package Registry），仍要用
type: composer，不是vcs
最容易被忽略的是：就算只写了自定义源，只要没关 "packagist.org": false，Composer 仍会先去官方源查一遍同名包，可能装错版本，还查不出原因。
