composer不支持多镜像自动fallback，所谓“主备”必须靠外部脚本实现探测可用镜像、动态切换源配置、清缓存三步控制流；因repo.packagist.org为单值字段，多次config -g会覆盖而非叠加，且repositories数组仅用于元数据合并，下载时只从首个声明该包的源拉取zip，网络错误不触发fallback。
composer 不支持多个镜像源自动 fallback，所谓“主备”“多源”必须靠外部控制流实现——不是改配置就能生效，而是得在命令执行前动态探测、切换、清缓存。
为什么 composer config -g repo.packagist.org 只能设一个 URL
这个配置项是单值字段，底层只接受一个字符串。执行 composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/ 后再执行 composer config -g repo.packagist.org https://packagist.org/，后者会直接覆盖前者，不会叠加，也不报错。
常见错误：用空格拼两个地址，如 composer config -g repo.packagist.org https://a.com https://b.com，命令失败或仅第一个生效。
所有 Composer 2.x 版本行为一致，不存在“某版本突然支持”的情况。
repositories 数组不是 fallback 机制，而是元数据合并顺序
你在 composer.json 里写多个 {"type": "composer", "url": "..."}，Composer 会按数组顺序请求每个源的 packages.json，合并成一张索引表；但下载 ZIP 包时，只从**第一个声明了该包完整版本信息的源**拉取，其余源完全不参与下载阶段。
关键限制：
- 只有明确返回 404（包不存在）才会查下一个源
- 502、超时、DNS 失败等网络错误直接中断，不 fallback
- 如果项目里定义了 repositories，全局配置（~/.composer/config.json）会被完全忽略，不是合并
- 必须显式加 "packagist.org": false 在 composer.json 根级，否则 Composer 仍会偷偷连官方源
- 兜底元数据可用 {"packagist": true} 放数组末尾，但它只查元数据，不影响 ZIP 下载路径
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真·容灾必须靠脚本：探测 + 切换 + 清缓存
CI/CD 或本地开发中防止单点失效，唯一可靠路径是三步外部控制流：
- 用 curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json 检查镜像根路径是否返回 200
- 成功则 composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/
- 失败则 fallback 到备用地址，如 https://mirrors.tencent.com/composer/ 或 https://repo.packagist.org/
- 切换后必须执行 composer clear-cache，否则旧 DNS、连接池或元数据缓存可能导致后续请求继续失败
- 若项目已定义 repositories，脚本应改写 composer.json 中对应字段，而非全局配置
容易被忽略的兼容性细节
多个镜像源配置中最容易出问题的不是逻辑，而是结构和作用域：
- repositories 必须是索引数组，不能写成对象（如 {"aliyun": {...}}），否则只有最后一个生效
- "packagist.org": false 是顶层字段，不是 repositories 里的某一项
- 私有源和镜像混用时，私有源必须放 repositories 最前面，否则同名包可能被公共镜像“抢答”
- 镜像未及时同步新包时，会返回 404 触发 fallback，但若所有镜像都未同步，最终仍失败——这不属于 Composer 的责任范围，而是镜像服务本身的延迟问题
