composer不支持自定义仓库type（如"my-protocol"），仅识别vcs、composer、package、path四种内置类型；扩展新协议必须实现vcsdriverinterface并用插件通过repositorymanager::addrepositoryclass注册，且type仍须设为" vcs"。
自定义仓库类型必须实现 VcsDriverInterface
Composer 不允许你在 repositories 里随便写个 type: "my-protocol" 就生效。它只认内置的 vcs、composer、package、path 这几种。想加新协议（比如 gitlab-ssh:// 或内网自研的 nas://），唯一正路是写一个 PHP 类，实现 Composer\Repository\Vcs\VcsDriverInterface。
这个接口强制你提供 getBranches()、getTags()、getDist() 等方法——不是可选，少一个 Composer 启动时就报错。别试图 patch RootPackageLoader，它不参与协议分发，改了也没用。
协议识别靠 URL 前缀匹配，不是靠 type 字段：你在 composer.json 里写 "type": "vcs", "url": "gitlab-ssh://..."，然后 Composer 会遍历所有已注册的 VCS 驱动，看谁的 supports() 方法返回 true（比如检测 URL 是否以 gitlab-ssh:// 开头）。所以 type 必须还是 vcs，不能改成别的字符串。
如何注册自定义 VCS 驱动
驱动类写好后，得让 Composer 在启动时加载它。最可靠的方式是通过 Composer 插件机制，在插件的 activate() 方法里调用 RepositoryManager::addRepositoryClass()：
public function activate(Composer $composer, IOInterface $io)
{
$rm = $composer->getRepositoryManager();
$rm->addRepositoryClass('gitlab-ssh', MyGitlabSshDriver::class);
}
注意三点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
addRepositoryClass()第一个参数是协议前缀（小写、无冒号），对应 URL 开头；第二个参数是完整类名 - 类必须能被自动加载，建议放在插件的
src/下并配置 autoload - 插件本身需通过
composer require安装到项目中，或全局启用（composer global require）
为什么直接改 composer.json 的 type 没用
你在 repositories 数组里写 {"type": "gitlab-ssh", "url": "..."}，Composer 会直接忽略这一项，不会报错，也不会警告——静默跳过。因为它的仓库解析器根本不认识这个 type 字符串。
常见错误操作包括：
- 把私有 GitLab 地址配成
type: "composer"，结果 Composer 去请求/packages.json，404 - 把 Satis 服务地址配成
type: "vcs"，结果 Composer 尝试 git clone 一个 HTTP 地址，报Cloning into '...': fatal: repository not found - 漏掉
supports()方法里的协议判断逻辑，导致驱动永远不被触发
调试自定义驱动的关键点
驱动不生效时，不要只盯着 composer install 输出。真正有用的信息藏在 Composer 的调试日志里：
运行 composer install -vvv，搜索关键词 Adding repository 和 Checking driver，你会看到它依次尝试哪些驱动、是否命中、为什么跳过。
容易被忽略的细节：
- URL 必须带协议前缀，且和
supports()中判断的完全一致（比如gitlab-ssh://≠gitlab+ssh://） - 驱动类的
getOrigReference()返回值必须是 Git 能识别的 ref（如refs/heads/main），否则后续 fetch 失败 - 如果用 SSH，确保运行 Composer 的用户能免密执行
ssh -T git@gitlab.example.com，否则克隆阶段卡住
