必须设 COMPOSER_DISABLE_NETWORK=1 才能离线安装，否则所有参数无效；需提前下载 dist 包至 cache/files/ 并保留 cache/repo/packages.json；离线机须同步缓存路径且 lock 文件中所有包 dist.type 必须为 zip/tar。
根本不能直接执行 composer install——它默认必联网拉取 packages.json 和 dist 包，断网时会卡在 Loading composer repositories 或报 Could not fetch https://repo.packagist.org/packages.json。离线安装不是“换参数就能跑”，而是必须提前切断网络通路、固化资源、对齐环境。
必须设 COMPOSER_DISABLE_NETWORK=1，否则所有参数都无效
这是离线操作的硬性前提，不是可选项。不设这个环境变量，--no-plugins、--no-scripts、甚至 --offline（该参数根本不存在）全无作用。Composer 会在元数据校验、插件初始化、post-install-cmd 阶段偷偷发 DNS 请求。
- Linux/macOS：命令前加前缀，例如
COMPOSER_DISABLE_NETWORK=1 composer install --no-dev --prefer-dist --no-scripts --no-plugins - Windows CMD：先运行
set COMPOSER_DISABLE_NETWORK=1，再执行composer install - PowerShell：运行
$env:COMPOSER_DISABLE_NETWORK="1"，再执行命令 - 验证是否生效：在离线机上执行
composer config --list | grep disable，应看到disable-network显示为true
vendor 目录不能直接拷贝，必须用 --no-install + cache 提取
直接打包当前 vendor/ 同步到另一台机器，大概率失败。原因包括：post-install-cmd 脚本在离线环境下无法执行、软链接跨系统失效、扩展依赖（如 ext-redis）未编译。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确做法是在有网机器上运行：
composer install --no-install --prefer-dist --no-scripts，这会让 Composer 下载所有 dist ZIP 到vendor/composer/cache/files/，但不解压 - 同时确认
vendor/composer/cache/repo/https---packagist.org/packages.json存在且非空——它记录了包名与 ZIP 文件路径的映射，缺了它，离线时根本找不到本地包 - 打包时必须包含整个
cache/目录（含files/和repo/），不能只拷files/ - 离线机上需同步设置缓存路径：
composer config --global cache-dir /path/to/restored/cache
离线命令必须带 --prefer-dist，且 lock 文件里不能含 source 类型
--prefer-dist 是硬性要求。只有 dist 包（ZIP/TAR）才走缓存路径；如果 composer.lock 里某包的 dist.type 是 source（比如 "type": "git"），即使缓存齐全，COMPOSER_DISABLE_NETWORK=1 下也会直接退出，不报错也不提示。
- 生成 lock 文件时，确保用的是
--prefer-dist（开发机执行composer update --prefer-dist或composer install --prefer-dist） - 检查
composer.lock中每个包的dist字段："url"应为 HTTPS ZIP 地址，"type"应为zip或tar，不能是git或hg - 若项目含私有包或 VCS 依赖，必须改用
type: package+ 本地路径方式配置仓库，例如："repositories": [{"type": "package", "package": {"name": "my/private", "version": "1.0.0", "dist": {"url": "/path/to/my-private-1.0.0.zip", "type": "zip"}}}]
最容易被忽略的是缓存目录结构完整性——repo/ 和 files/ 必须共存，且 packages.json 里的 SHA256 值要和 ZIP 文件实际哈希一致。哪怕只少一个文件，composer install 就会静默失败，而不是报错。
