composer的repository接口非插件式扩展点，不支持用户自定义实现；私有云分发依赖repositories、auth.json和config三层配置协同，且须严格遵循权限、路径与版本一致性要求。
Repository接口不是“插件式扩展点”，它不开放自定义实现
Composer 的 Repository 接口（如 Composer\Repository\RepositoryInterface）是内部契约，**不提供用户注册自定义仓库类的机制**。你不能写个 PHP 类 implements RepositoryInterface 然后让 composer 加载它——Composer 的仓库类型（vcs、composer、package）全部硬编码在 Composer\Repository\RepositoryManager 里，加载逻辑写死，没有反射或工厂扩展入口。
所谓“实现私有云分发”，实际是组合已有仓库类型 + 配置策略，不是重写接口。试图魔改源码或 patch RepositoryManager 会直接破坏 Composer 自身升级路径，且无法通过 composer install 的校验流程。
- 所有合法仓库必须声明
"type"字段，值只能是 Composer 官方认可的字符串：vcs、composer、package、path -
type: "composer"对应的是服务端返回packages.json的静态结构，不是任意 HTTP 接口都能冒充 -
type: "vcs"仅支持 Git/Hg/Subversion，且只用于索引版本，不参与最终安装包的传输（dist 或 source 下载仍走独立逻辑）
私有云分发真正依赖的三个配置层
能落地的私有云分发，靠的是三层配置协同生效：项目级 composer.json 的 repositories、全局或项目级 auth.json 的凭据、以及 config 中对默认源的开关控制。漏掉任一层，composer install 就会 fallback 到 packagist.org 或静默失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repositories数组必须把私有源放在顶部，且显式设{"packagist": false}来禁用默认源；只写 URL 不关 packagist，Composer 仍会先查公网 -
auth.json必须放在项目根目录（优先级高于~/.composer/auth.json），权限必须是600，否则 Composer 直接跳过读取，也不报错 - HTTP Basic 认证必须用
composer config http-basic.your-domain.com user pass注入，不能手写进composer.json—— 否则 commit 时凭据泄露
离线环境复现失败，90% 是因为缺 vendor + lock 组合
composer archive 命令完全不适用私有分发场景。它只打包当前 vendor/ 目录快照，不含 composer.lock、不校验 autoload、不处理 dist 预下载——离线机上解压后执行 composer install 会立刻报错 Could not find package 或加载空白。
- 正确做法是：先在联网环境运行
composer install --no-dev --prefer-dist --optimize-autoloader，确保vendor/干净且含 dist 包 - 必须把
composer.json和composer.lock一并打进 zip，缺lock文件等于放弃版本锁定 - 若含私有 VCS 包，需提前在联网机执行
composer config repositories.xxx vcs https://git.internal/pkg，否则lock文件里不会记录该源的 commit hash
群晖 NAS 或内网服务器上最容易忽略的 CLI 环境错配
WebStation 显示 PHP 8.2 正常，不代表 composer install 能跑通——终端里 php 命令很可能指向系统旧版（如 PHP 5.6），而 Composer 生成的 autoloader 会因扩展缺失（mbstring、phar）直接失效，报错却只显示 “Class not found” 这种误导信息。
- 必须用 WebStation 绑定的完整 PHP 路径执行所有命令，例如：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer install - CLI 模式和 Web 模式的
php.ini是两套配置，缺扩展要手动编辑 CLI 的 ini 文件（路径类似/volume1/@appstore/PHP82/usr/local/etc/php/php.ini） - 别信
php -m输出，要用/volume1/@appstore/PHP82/usr/bin/php -m确认真实可用扩展
真正卡住私有分发的，从来不是接口设计多复杂，而是 auth.json 权限不对、composer.lock 没带、CLI 和 Web PHP 版本不一致这三处——它们不报明确错误，但会让整个流程在某个环节彻底静默中断。
