必须通过type:composer-plugin插件实现，核心是实现CommandProviderInterface::getCommands()返回BaseCommand实例，并在composer.json中声明类型、API版本、autoload及extra.command-provider全限定类名。
如何让 Composer 支持自定义命令
Composer 本身不支持直接注册任意 CLI 命令，必须通过 composer-plugin 实现。核心是实现 Composer\Plugin\PluginInterface，并在 activate() 中注册一个 CommandProvider 类——这个类必须实现 Composer\Plugin\CommandProvider 接口并返回自定义命令实例。
常见错误是把命令类直接扔进 autoload 就以为能用，结果运行 composer your-command 报错 Command "your-command" is not defined.。根本原因是没触发插件激活，或未在 composer.json 的 extra.plugin-class 或 type: composer-plugin 下正确声明。
- 插件包的
composer.json必须含"type": "composer-plugin"和"require": { "composer-plugin-api": "^2.0" } -
PluginInterface::activate()里传入的$composer对象要保存为成员变量，后续命令执行时需访问仓库配置、IO 等上下文 - 命令类必须继承
Symfony\Component\Console\Command\Command，且不能依赖全局 autoloader 自动加载——插件加载阶段 autoloader 尚未完全就绪
发布命令怎么读取私有包元信息
企业私有包通常需要从 composer.json 提取 name、version、dist 配置，并结合内部 Git 仓库地址和 Tag 规则生成发布动作。不要硬编码仓库地址或版本号，应优先读取当前项目根目录下的 composer.json，再 fallback 到命令行参数或环境变量。
容易踩的坑是直接调用 exec('git tag') 获取最新 tag，但没检查当前分支是否为 main 或 master，导致误发开发分支。更稳妥的方式是用 $composer->getPackage() 拿到 PackageInterface 实例，再通过 getVersion() 和 getName() 获取声明值；若需真实 Git 状态，应调用 Composer\Util\ProcessExecutor 并捕获 stderr。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
getVersion()返回的是composer.json中的version字段，不是 Git tag —— 发布前建议校验二者是否一致 - 私有包若使用
pathrepository，getPackage()可能返回CompletePackage，但getDistUrl()为空，需提前判断并提示用户配置dist.type和dist.url - 建议加
--dry-run参数，默认只输出将要执行的操作，避免误触发发布流程
如何安全地对接内部 Packagist 或私有仓库
一键发布的终点不是打 Git tag，而是推送包到内部仓库（如 Satis、Private Packagist、JFrog Artifactory）。关键不是“怎么推”，而是“怎么鉴权”和“怎么校验响应”。直接拼接 cURL 命令极易泄露 token，也难处理 401/409 等状态码。
推荐复用 Composer 自身的 HTTP 客户端：通过 $composer->getConfig()->get('github-oauth') 或自定义配置项（如 extra.private-repo-token）读取凭证，再用 Composer\Util\HttpDownloader 发起请求。这样既能走 Composer 的重试、超时、proxy 设置，又能统一管理凭据。
- 不要把 token 写死在插件代码里，必须从
composer.json的extra或环境变量（如COMPOSER_PRIVATE_REPO_TOKEN）读取 - 上传 ZIP 包时，Content-Type 必须设为
application/zip，且请求体不能经过 gzip 压缩——某些私有仓库会拒绝压缩后的二进制流 - 收到 409 Conflict 表示同名版本已存在，此时应默认退出而非覆盖，除非显式传
--force
为什么你的命令在 CI 环境里总失败
本地测试通过，放到 GitHub Actions 或 Jenkins 就报 Could not open input file: composer 或 Permission denied (publickey)，问题往往不在命令逻辑，而在执行上下文缺失。CI 环境默认不加载用户级 ~/.composer/auth.json，也不保证当前工作目录是包根目录。
最常被忽略的一点：CI 中运行 composer your-command 时，Composer 加载的是全局 vendor 目录下的插件，而不是你正在开发的那个插件——除非你在 CI 脚本里明确 composer global require your/plugin:dev-main。更可靠的做法是在项目根目录下用 composer install --no-dev 后，确保插件已作为 require-dev 或 require 被安装，再执行命令。
- CI 中务必设置
COMPOSER_HOME指向可写路径，否则插件无法缓存或写日志 - Git SSH key 权限问题：CI 使用 deploy key 时，
git@URL 无法自动 fallback 到 HTTPS，需提前配置git config url."https://".insteadOf "git@" - 命令中调用
ProcessExecutor执行 shell 命令时，务必设inheritEnv => false，否则 CI 的敏感环境变量可能意外泄露到子进程
