不能直接“创建自己的Packagist”，因为Packagist.org是中心化服务，官方不提供私有部署版本，也不托管私有包；实际需用Satis等兼容composer类型源的服务替代，其核心是提供标准packages.json接口，并严格满足type为"composer"、url以/结尾、显式禁用packagist.org三项配置要求。
为什么不能直接“创建自己的Packagist”
Packagist.org 是一个中心化服务，官方不提供私有部署版本，也明确拒绝托管私有包。你真正需要的不是“另一个 Packagist”，而是一个能被 composer 正确识别、响应标准元数据格式（packages.json）的 HTTP 服务。Satis、Private Packagist、Artifactory、GitHub Packages 都属于这一类——它们不叫 Packagist，但能替代它。
repositories 配置必须满足的三个硬性条件
Composer 只按规则加载源，不讲情面。以下三点任一出错，composer install 就会静默跳过你的私有源，或报 Could not parse version constraint / 404 packages.json：
-
"type"必须是"composer"，不是"vcs"或"package"—— 后两者无法支持批量索引和语义化版本解析 -
"url"必须以/结尾，否则 Composer 拼路径时会丢掉斜杠，例如"https://pkgs.myorg.com"→ 请求https://pkgs.myorg.compackages.json（404） - 必须显式关闭默认源：
"packagist.org": false，否则同名包可能从官方源“抢先命中”，导致私有版本被绕过
Satis 构建失败的三大高频原因
Satis 不是黑盒，它在构建时卡住，90% 发生在 Git 层或配置层，而非 JSON 生成本身：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
satis build报Cloning into bare repository failed：Satis 默认不用 SSH agent，私有 Git 仓库需改用 HTTPS + token 认证，或在satis.json的repositories里显式加"options": {"http": {"header": ["Authorization: Bearer xxx"]}} -
Skipping package myorg/utils, no suitable releases found：该包的 Git 仓库没打符合语义化规范的 tag（如v1.0.0），或satis.json里漏设"require-all": true - 生成的
packages.json被 Nginx 返回 HTML 页面：说明 Web 服务器把packages.json当成了目录索引首页，应确保其路径可直访（比如 URL 是https://pkgs.myorg.com/packages.json），且 Nginx 配置含try_files $uri =404;
认证凭据放哪儿才生效
Composer 查找 auth.json 有严格顺序，CI/CD 环境最容易踩坑：
- 优先读项目根目录下的
auth.json（不是composer.json同级，就是字面意思的当前工作目录） - 其次查
$COMPOSER_HOME/auth.json（Docker 或 CI 中常为空，因为没设COMPOSER_HOME环境变量） - 最后 fallback 到旧路径
$HOME/.composer/auth.json（已弃用，新版 Composer 不再自动读） - 内容格式必须是：
{"http-basic": {"pkgs.myorg.com": {"username": "", "password": "your-token"}}}，用户名留空、密码填 token 是 GitHub/GitLab Packages 的通用写法
最关键的细节往往藏在路径拼接和凭据加载顺序里——/ 少一个、auth.json 放错一层、packagist.org 没关掉，都会让整个私有源“看起来在运行”，实则完全不生效。
