Composer本身无运行时热插拔能力，所谓热插拔实为install/update阶段通过post-autoload-dump事件钩子干预autoload配置、动态生成映射；必须绑定该事件而非post-install-cmd，且需显式触发dumpAutoloads或composer dump-autoload命令。
热插拔不是运行时加载，而是 install/update 阶段的事件钩子干预
Composer 本身没有“运行时热插拔”能力，所谓热插拔本质是在 post-install-cmd 或 post-autoload-dump 事件中，由插件动态修改 autoload 配置、注入路径或触发重生成。一旦 vendor/autoload.php 固化，后续代码就只能靠已注册的加载器，无法再“追加”新类映射（除非手动调用 ClassLoader::addPsr4()）。
常见错误现象：改了插件包的 composer.json 并执行 composer install，但类仍加载失败——往往是因为插件没监听 post-autoload-dump，或没调用 $composer->getPackage()->setAutoload() 并触发 dump-autoload。
- 必须在
activate()中绑定ScriptEvents::POST_AUTOLOAD_DUMP，而不是POST_INSTALL_CMD；后者触发时 autoload 文件尚未生成，改了也无效 - 修改 autoload 后，必须显式调用
Composer\Composer::dumpAutoloads()或让插件触发composer dump-autoload命令 - 若主项目启用了
--classmap-authoritative，所有动态addPsr4()调用都会被忽略，此时热插拔必须走 classmap 生成路径，不可绕过
沙箱机制依赖租户级 vendor 目录隔离，而非单一 autoload 注册
真正的沙箱不是靠命名空间前缀区分，而是物理路径隔离：每个租户拥有独立的 tenants/{id}/vendor/ 和专属 autoload.php。主项目不加载租户代码，租户代码也不污染主项目加载器。
常见翻车点：试图用 ClassLoader::addPsr4('TenantA\', '/path/to/tenant-a/src/') 统一注册多个租户路径——这会导致命名空间冲突、类覆盖、OPcache 缓存混淆，尤其在 PHP 8.9 strict_namespace 模式下直接报 E_COMPILE_ERROR。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 租户目录必须通过
--no-scripts -d "tenants/{$id}"安装，避免全局钩子干扰 - 租户
composer.json中禁止动态字段：autoload-dev、scripts、config都需静态固化，否则 CI 构建时行为不可控 - 运行时加载租户代码，必须
include_once 'tenants/{$id}/vendor/autoload.php'，且确保主项目加载器先注册（顺序决定优先级）
插件 type 匹配失败是沙箱失效的第一道防线
自定义包类型（如 "type": "tenant-module"）不会自动生效，它只是个标签；真正起作用的是配套的 installer 插件，且该插件必须提前存在于根项目中，并在 supports() 方法里严格返回 true 仅当 $package->getType() === 'tenant-module'。
常见错误现象：租户模块包成功安装进 vendor/，但资源文件（如配置、视图、迁移）没复制到 tenants/{$id}/ 下——根本原因是 installer 插件未激活，或 supports() 判定逻辑写成 str_starts_with($package->getType(), 'tenant-')，而 Composer 要求完全相等。
- installer 插件的
composer.json必须声明"type": "composer-plugin"，且require包含"composer-plugin-api": "^2.0" -
getInstallPath()返回值必须是相对于项目根目录的路径，不能含..或绝对路径，否则 Composer 直接跳过安装 - 自定义 type 值不能提交到 Packagist，只应在私有仓库使用；Packagist 会过滤掉非标准 type，导致包被当作普通
library处理
OPcache 和 strict_namespace 是热插拔落地的隐藏关卡
即使 autoload 配置正确、路径隔离完备，PHP 运行时仍可能因 OPcache 预编译或命名空间解析策略导致热插拔失效。PHP 8.9 的 strict_namespace = true 尤其关键：它禁用跨空间回溯，使未限定调用（如 Helper::format()）在非全局空间下直接报错，而非降级匹配。
调试时最容易忽略的点：本地开发一切正常，CI 或生产环境却失败——大概率是 OPcache 没清，或 php.ini 中 opcache.enable 和 opcache.validate_timestamps 配置不一致。
- 租户代码变更后，必须清空 OPcache：
php -r 'opcache_reset();'，否则旧字节码仍被复用 - 启用
strict_namespace后，所有跨空间调用必须显式使用 FQN（如\App\Helper::format()），否则类加载器找不到目标 - 沙箱内租户模块若引用主项目类，必须确保主项目 autoload 前缀已注册，且租户加载器不覆盖主项目前缀（注册顺序即优先级）
