Composer不支持多源自动同步，Packagist与GitHub Packages彼此独立，需分别提交、配置和验证，无一次发布同步机制。
Composer 包不能“多源发布”——Packagist 是唯一官方默认仓库，其他平台（如 GitHub Packages、GitLab Packages）是独立服务，需手动配置、各自维护，不存在一次提交自动同步到多个平台的机制。
为什么 Packagist 不支持自动同步到 GitHub Packages
Packagist 和 GitHub Packages 完全无关：前者是 Composer 的中央索引服务，后者是 GitHub 提供的私有/托管包仓库（基于 composer 协议但自建 registry）。Packagist 从不读取、不写入、不感知 GitHub Packages；反之亦然。你提交到 packagist.org，只影响 composer require 在默认源下的行为；推到 github.com/org/repo 并启用 GitHub Packages，只是开了另一个独立 endpoint。
- GitHub Packages 的 Composer registry 地址形如
https://maven.pkg.github.com/yourname/your-repo（实际为https://pkg.github.com/yourname），需用户显式配置composer config repositories.yourname composer https://pkg.github.com/yourname - Packagist 页面上点
Update或触发 webhook，对 GitHub Packages 零影响 - GitHub Packages 不校验
composer.json中的name是否符合vendor/package小写格式，它只认你推送的 Git tag 和仓库权限
如何让同一个包同时在 Packagist 和 GitHub Packages 可用
必须分别操作、分别验证，没有捷径。核心是保持 Git 仓库一致，但发布动作解耦：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确保 GitHub 仓库公开，
composer.json合规（name小写vendor/package-name，含autoload，无version字段），并已提交到main分支 - 在
packagist.org手动 Submit 该仓库 HTTPS URL；配好 GitHub webhook（Payload URL填https://packagist.org/api/github，事件选Just the push event） - 在 GitHub 仓库 Settings → Packages → Manage access，确认启用了
GitHub Packages，且你的 token 有read:packages权限 - 打 tag 后，执行两步推送：
git tag v1.0.0 && git push origin v1.0.0（触发 Packagist 抓取）echo "//token" | composer config --global github-oauth.github.com _YOUR_TOKEN_+composer publish（若用 GitHub Actions 自动 publish，则需在 workflow 中显式调用composer config和composer install --no-dev后打包上传）
常见错误：以为打一个 tag 就全平台生效
现象：composer require yourname/your-package:^1.0 成功，但 composer require yourname/your-package:dev-main 在 GitHub Packages 下失败，或反之。
- 根本原因：Packagist 默认只索引 stable tag（
v1.0.0），而 GitHub Packages 默认允许dev-main（需在composer.json中设"minimum-stability": "dev"并"prefer-stable": false） - GitHub Packages 不自动识别
psr-4映射是否合法，composer install成功但运行时报Class not found，往往是因为"MyName\Package\": "src/"少了末尾反斜杠 - 用
git push --tags推送时混入测试 tag（如v0.0.1-alpha），Packagist 会收录，但 GitHub Packages 若未配置allow-pre-release则忽略，造成版本列表不一致
真正需要关注的兼容性细节
两个平台对同一份 composer.json 解析逻辑不同，容易忽略的点：
-
type字段：Packagist 强制要求"library"才显示为可安装包；GitHub Packages 忽略该字段，但若设为"project"，某些 CI 工具可能跳过构建 -
autoload路径：Packagist 不校验路径是否存在，但 GitHub Packages 在composer install时会检查src/目录是否真实存在，不存在则报错退出 - 认证方式：Packagist 全局匿名可用；GitHub Packages 必须提前配置
github-oauth或用GH_TOKEN环境变量，否则composer update直接 401 - Webhook 冲突：GitHub 同一仓库不能对两个不同 Payload URL 发送相同事件（比如同时配 Packagist 和自建镜像），建议用
Releases事件替代Just the push event避免重复触发
多平台不是“发布一次，到处可用”，而是“同一套代码，两套发布流程”。最易被忽略的是：GitHub Packages 的 composer.json 中 name 可以和 Packagist 不一致（比如加前缀 gh/yourname/your-package），但这样用户就必须知道两个名字——实际维护成本远高于收益。建议只选一个主源，另一平台仅作备份或私有分发用。
