镜像源仅控制包下载地址，不影响vendor/bin路径生成；路径由composer.json中config.bin-dir和bin-compat决定，与镜像配置完全正交。
镜像源本身不参与 vendor/bin 的路径生成
镜像源只控制包的下载地址（packages.json 和 .zip 文件），它不决定二进制文件放哪、是否链接、用软链还是包装脚本。哪怕你配了阿里云、腾讯云或华为云镜像，vendor/bin 或你自定义的 bin-dir 目录，依然由本地 composer.json 中的 config.bin-dir 和 bin-compat 决定。
常见误解是“换镜像就能把 phpunit 放到 tools/ 下”——其实镜像一换，只是下载更快了，vendor/bin/phpunit 还是照旧生成；真要改位置，必须动配置，不是换源。
- 镜像失效时，Composer 会回退到 packagist.org，但只要最终下载成功，
bin处理逻辑完全不变 -
composer config -g repo.packagist显示为空？大概率是键名写成repo.packagist.org或 URL 缺末尾/，和bin-dir配置无关 - 执行
composer install -vvv时，看到Downloading https://mirrors.aliyun.com/composer/...才算真正走镜像；否则别假设它在分流
vendor-bin 不是镜像能“识别”的特殊目录
你设 "bin-dir": "vendor-bin" 后，Composer 确实会把符号链接或包装脚本放到 vendor-bin/，但这和镜像源毫无关系——它只是把原本该往 vendor/bin/ 放的东西，换了个地方放而已。镜像源不知道、也不关心这个路径。
关键点在于：vendor-bin 不是 Composer 内置概念，它只是个普通字符串。你写 "bin-dir": "scripts" 或 "bin-dir": "bin-local" 效果一样，镜像源对它们一视同仁。
- 必须手动创建目标目录：
mkdir -p vendor-bin，否则composer install会静默跳过链接（Linux/macOS 下不报错，Windows 下可能复制失败） - 仅改
bin-dir不够：还得加"bin-compat": "full"，否则默认仍生成软链，而某些 CI 环境（如 Windows + WSL 混合）不支持跨文件系统软链 - 删掉整个
vendor/后重装才生效；composer update不会迁移已有的vendor/bin内容
镜像源错误会导致 bin 文件根本不会生成
这不是路径问题，而是前置失败：如果镜像配置错到让 Composer 连 packages.json 都拉不下来，那依赖包压根不会解压，更别说读取其 composer.json 里的 bin 字段了。此时你检查 vendor-bin/ 是空的，不是配置没生效，是连第一步都没走到。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
典型现象：composer install 卡在 Downloading，或报 Could not find package xxx —— 这时候别急着调 bin-dir，先验证镜像是否真在工作。
- 运行
composer diagnose，重点看Repo packagist.org:后面是不是你设的镜像地址（不是Repo packagist:） - 临时用
curl -I https://mirrors.aliyun.com/composer/packages.json测试镜像可用性；404 或超时说明镜像地址本身有问题 - Windows 用户改完全局镜像后必须关终端重开，否则仍读旧缓存，导致你以为镜像生效了，其实没走
CI 脚本里混用镜像和 bin-dir 容易出环境差异
本地开发用镜像快、bin-dir 设为 tools/，CI 却忘了同步配置，结果跑的是默认 vendor/bin/，脚本路径硬编码又没更新——这类问题很难复现，因为本地和 CI 的 composer.json 看似一样，实则全局镜像覆盖了项目级配置，或 COMPOSER_HOME 路径权限不对。
最稳妥的做法是：所有路径相关逻辑都绕过 shell PATH，统一用 composer exec。
-
composer exec phpunit -- --testdox自动定位到当前bin-dir下的可执行文件，不依赖PATH，也不受镜像影响 - CI 脚本中避免写
./tools/phpunit或./vendor/bin/phpunit，全部替换为composer exec调用 - 若必须用绝对路径（如某些容器入口脚本），应通过
composer config bin-dir动态获取，而不是写死
真正容易被忽略的是：镜像源和 bin-dir 属于两个正交维度，但它们的失效表现高度相似——都是“命令找不到”。排查时得先分清是下载失败（镜像问题），还是路径错位（配置+权限+环境变量问题），不能一上来就改 bin-dir。
