应直接配置 GitHub Personal Access Token，因其可将 API 限额从每小时 60 次提升至 5000 次，彻底解决 composer 因限流导致的卡顿、403 错误及假性下载慢问题。
直接配 GitHub Personal Access Token，其他方案都是临时绕路，治标不治本。
为什么API rate limit exceeded不是网络问题
这个错误和网速、DNS、代理都没关系，是 GitHub 对未认证请求的硬性限制：每小时最多 60 次 API 调用。Composer 在解析 composer.json、拉取 tag 列表、查 commit 哈希时都会触发 GitHub API，尤其在 --prefer-source 或私有仓库场景下更频繁。CI 构建、共享 IP 开发、高频 composer update 都会秒超限。
- 错误日志里通常含
https://api.github.com/请求失败，但不会明确说“限流”，只报 403 或静默卡住 -
curl -H "Authorization: token xxx" https://api.github.com/rate_limit返回的rate.limit是判断依据：60 表示没生效，5000 才算成功 - 镜像源（如阿里云）不转发 GitHub API 请求，所以换源完全无效
配置github-oauth必须用--global且权限精准
Token 必须通过 Composer 全局配置写入 ~/.composer/auth.json，不能塞进项目级 auth.json 或环境变量伪造。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 生成 Token 时只勾选
repo（含public_repo和私有库读取），read:packages可选（仅影响 GitHub Packages）；delete_repo、admin:org等权限完全不需要，反而增加泄露风险 - 执行命令：
composer config -g github-oauth.github.com <your_token_here>，注意域名是github.com，不是api.github.com - 验证是否写入：
composer config -g github-oauth.github.com应输出掩码后的 Token（如ghp_***abc123） - CI 环境要确保该配置被加载——GitHub Actions 中需在
composer install步骤前显式运行该config命令，不能依赖缓存
composer install卡在Downloading zipball时的快速确认法
这不是下载慢，而是 GitHub API 调用失败后 Composer 自动降级重试导致的假性卡顿。加 -v 参数能立刻暴露真实瓶颈。
- 运行
composer install -v，观察最后几行日志：如果停在类似Downloading https://api.github.com/repos/vlucas/phpdotenv/zipball/v5.6.0，基本就是限流 - 此时立即中断，别等满 300 秒超时——直接配 Token 后重试，通常 10 秒内恢复
- 避免用
--prefer-source：它强制走 Git 克隆，对 SSH 或 HTTPS 连接稳定性要求更高，更容易因认证失败卡死 - 若项目含大量私有包，确认所有仓库域名都匹配 Token 绑定域（如
github.com不兼容github.enterprise.com）
Token 配置本身很简单，但容易栽在权限范围、作用域（--global vs --local）、CI 环境隔离这三点上。一旦生效，5000 次/小时的额度足够覆盖日常开发和 CI 构建，比调 http-timeout 或清缓存更能一劳永逸解决“卡住”假象。
