必须用 composer config -g github-oauth.github.com 写入全局配置，其他方式基本无效；因 github api 元数据请求发生在安装前全局解析阶段，仅 -g 配置能覆盖该链路，字段名、域名须严格匹配，token 需含 repo 权限。
必须用 composer config -g github-oauth.github.com <token></token> 写入全局配置，其他方式基本无效。 GitHub API 的元数据请求（如解析依赖、查 tag、读 composer.json）发生在安装前的全局解析阶段，此时项目级配置、auth.json 手动编辑、http-basic 等都还没加载或不匹配路径，根本不会被用上。
为什么 composer config -g 是唯一可靠入口
Composer 在执行 install 或 update 时，第一步是向 https://api.github.com/ 发起大量未认证请求。这些请求由 Packagist 协调，但认证凭证必须在「全局初始化阶段」就准备好——只有 -g（即 --global）写入的配置能覆盖这个链路。
-
composer config github-oauth.github.com <token></token>（漏掉-g）会把 token 写进当前项目的composer.json的config字段，对 GitHub API 请求完全无感 - 手动编辑
~/.composer/auth.json容易出错：JSON 格式非法、文件权限不是600、属主不是当前用户，都会导致静默跳过 -
http-basic或bitbucket-oauth等命令字段名不匹配，Composer 直接忽略，不报错也不提示
github-oauth.github.com 字段名和域名必须精确匹配
Composer 对键名大小写和嵌套层级极其敏感，任何偏差都会让 token 彻底失效，且错误表现模糊（比如 Could not fetch 或伪装成 404 的 401）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 字段名必须是
github-oauth，不是github_oauth、githubAuth或github-oauth-token - 域名必须是
github.com，不是www.github.com、api.github.com或github.enterprise.internal（后者需单独配github-oauth.github.enterprise.internal） - GitHub Enterprise Server（GHES）或自建实例必须用完整域名，Composer 不做归一化，
git.example.com:8080和git.example.com视为两个不同 host
Token 类型、权限与 CI 场景下的安全注入
Classic Personal Access Token（PAT）仍是 Composer 主流版本唯一稳定支持的类型；fine-grained token 在多数 Composer 版本中无法触发认证流程。
- 权限至少勾选
repo（它隐含public_repo和private_repo），仅public_repo会导致私有 fork 元数据读取失败 - 若用 GitHub Packages，额外加
read:packages；delete:packages仅在需要删包时启用 - CI 环境（如 GitHub Actions）不能依赖本地
-g配置，应优先用COMPOSER_AUTH环境变量注入：export COMPOSER_AUTH="{\"github-oauth\":{\"github.com\":\"$GITHUB_TOKEN\"}}" -
COMPOSER_AUTH优先级高于auth.json，但如果项目根目录存在auth.json，Composer 会直接跳过该变量——CI 中务必确保工作目录干净或先删掉它
真正容易被忽略的是：Composer 不会主动告诉你 token 没生效，也不会明确报“认证失败”。它只是安静地退回未认证请求，然后卡在 Reading composer.json of vendor/package 或返回看似网络问题的 403。验证是否走通的最简方式，是运行 composer config -g --list | grep github-oauth 看输出是否为 ***，再配合 composer diagnose 查 GitHub API: OK —— 其他都是间接线索。
