每个边缘节点必须独立执行composer install，前提是lock文件、platform配置、镜像源和缓存路径严格一致；否则因PHP版本、扩展差异或镜像失效，将导致哈希不一致、class not found或fatal error。
composer install 必须在所有节点执行，但不能各自独立运行
分布式边缘节点不是“装一次、复制多份”就能完事的。每个节点必须独立运行 composer install，但前提是：lock 文件一致、平台配置一致、镜像源和缓存路径可控。否则看似同步执行，实则装出不同哈希、不同扩展依赖、甚至部分节点因 ext-intl 缺失直接 fatal error。
- 同一份
composer.lock提交到 Git 后，所有节点拉取的是相同内容——这是同步的前提 - 但若某节点用 PowerShell 写了
~/.composer/config.json，另一节点在 WSL 里跑，COMPOSER_HOME指向不同路径，全局镜像源就失效，退回到 packagist.org - PHP 版本或已启用扩展（如
ext-redis）不一致时，config.platform.php若没设，composer install可能跳过某些包的安装逻辑，导致运行时报 class not found
跨节点平台约束必须显式声明在 composer.json 中
边缘节点硬件、OS、PHP 小版本、扩展可用性差异极大，仅靠 composer.lock 不足以保底。必须在 composer.json 的 config.platform 字段中锁定目标环境能力，否则 Composer 会按本地环境解析依赖，生成不兼容的 lock。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 例如：所有边缘节点只跑 PHP 8.1，但你本地是 8.3 —— 必须加：
"config": {"platform": {"php": "8.1.28"}} - 若节点无
ext-gd，但某个包在 8.1 下默认 require 它，就得补上："ext-gd": false，否则 install 会失败 -
config.platform不影响composer install运行时检查，只影响composer update生成 lock 时的决策；所以它必须在本地update前就写好，并随 lock 一起提交
Docker 构建中执行 composer install ≠ 边缘节点部署时执行
在 Docker 多阶段构建里跑 composer install 是为了产出 vendor 目录，而边缘节点部署时跑 composer install 是为了适配本地真实环境。两者目的不同，参数也不能照搬。
- Docker 第一阶段可加
--no-autoloader --optimize-autoloader，因为后续会dump-autoload；但边缘节点直接运行composer install时，若漏掉--optimize-autoloader，首次请求会慢 3 倍以上 - 边缘节点通常资源受限（内存 ≤512MB），必须加
--no-dev --no-scripts --no-progress --no-interaction，否则可能因 OOM 或等待输入卡死 - Docker 构建可用
--prefer-dist加速下载，但某些边缘网络禁止外部 HTTPS，得切回--prefer-source并提前把 git repo 镜像到内网
同步失败最常卡在缓存与镜像源不可控
不是命令没跑，而是 composer install 在某个节点静默 fallback 到原始源，下载超时或校验失败，日志里只显示 “Failed to download”，根本看不出源头问题。
- 验证是否真走阿里镜像：
composer install -vvv 2>&1 | grep "mirrors.aliyun.com"，没输出就说明配置失效 - 清缓存不能只靠
composer clear-cache，要连带删掉$COMPOSER_HOME/cache目录，尤其 Windows 上 Git Bash 和 CMD 对~解析不同，缓存可能散落在两处 - CI/CD 流水线里用
export COMPOSER_HOME="/tmp/composer"是安全做法，但边缘节点若复用该逻辑，/tmp被定时清理会导致下次 install 重新下载全部包
composer install，而是让它们在敲下之后，面对的是一致的 PHP 环境、一致的平台能力声明、一致的镜像源路径，以及一致的缓存生命周期管理。任何一环脱钩，同步就只是表象。 
