根本原因是插件未监听生命周期事件，上传逻辑须绑定到post-install-cmd或post-update-cmd等事件回调中执行，而非写在activate()或构造函数里；且需确保ci未启用--no-scripts、插件正确声明type和extra、类实现plugininterface。
为什么 composer install 不触发你的自研插件上传逻辑
根本原因是 Composer 默认只在 install 和 update 阶段执行插件的 activate()，但不会自动调用你写的上传方法——除非你显式绑定到某个事件。常见错误是把上传逻辑写在构造函数或 activate() 里，结果发现包装完了，文件却没传出去。
正确做法是监听 post-install-cmd 或 post-update-cmd 事件（取决于你要在何时上传），并在对应回调中调用打包与上传流程。注意：这两个事件仅在命令行直接执行 composer install 时触发，CI 环境下若用了 --no-scripts 会跳过，务必检查 CI 脚本。
- 确认插件的
composer.json中已声明"extra": {"class": "Your\Plugin"}，且类实现了ComposerPluginPluginInterface - 在
activate()中注册事件监听：$event->getComposer()->getEventDispatcher()->addListener('post-install-cmd', [$this, 'onPostInstall']); - 上传前先判断是否处于目标环境（如通过
$_SERVER['COMPOSER_HOME']或自定义 env 变量），避免本地开发时误传
如何安全地打包静态资源并生成唯一版本标识
上传前不加校验和版本控制，会导致 CDN 缓存击穿或覆盖线上资源。不要依赖文件修改时间或随机字符串，应基于内容生成稳定哈希值。
推荐用 sha256_file() 对打包后的 tar.gz 或 zip 文件计算摘要，并将摘要前 8 位作为版本后缀（例如 assets-2a7f9c1d.zip）。这样既能保证内容一致时版本不变，又便于回滚和灰度。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打包路径必须使用
realpath()规范化，避免符号链接导致哈希不一致 - 排除
node_modules/、.git/、vendor/等非静态目录，用PharData::buildFromDirectory()更可控 - 若项目含多套静态资源（如 admin + frontend），建议按子目录分别打包，而非整个
public/一把梭
上传失败时如何避免 Composer 命令假成功
默认情况下，插件里抛出异常会被 Composer 捕获并吞掉，终端只显示 Script ... handling the post-install-cmd event returned with error code 0，实际上传早已失败。
关键是在事件回调末尾显式调用 exit(1) 或抛出 RuntimeException，并确保异常消息包含具体错误（如 HTTP 状态码、CDN 接口返回体）。否则运维查问题只能翻日志，而日志可能被 composer -q 抑制。
- 上传请求必须设超时（建议
timeout: 30），防止卡在慢网络上阻塞整个安装流程 - 对 CDN 接口返回做状态码校验：
if ($response->getStatusCode() >= 400)就该中断 - 临时文件（如打包生成的 zip）要在上传成功后才清理；失败则保留，并打印完整路径供人工介入
为什么不能在 PluginInterface::deactivate() 里做清理或反向操作
Composer 不保证 deactivate() 一定会被调用，尤其在异常退出、信号中断或内存耗尽时。把上传成功后的清理逻辑（比如删除本地临时包、更新部署清单）放在这里，大概率会漏执行，造成磁盘泄漏或状态不一致。
所有副作用操作——包括记录上传结果、更新元数据、清理临时文件——必须放在事件回调内部，且放在上传成功之后、exit() 或 return 之前。
- 上传成功后写一个
.uploaded-2a7f9c1d标记文件，下次运行前先检查是否存在，避免重复上传相同内容 - CDN 的上传接口若支持幂等（如带
X-Idempotency-Key），优先启用，比本地去重更可靠 - 如果上传涉及鉴权 token，别硬编码在插件里，应从
COMPOSER_AUTH或~/.composer/auth.json读取，适配团队协作场景
