离线批量解压ZIP包必须严格匹配composer.lock中的dist.shasum，仅适用于artifact仓库场景；需禁用网络、验证dist.type为zip、解压至指定结构目录，并配合正确repositories配置，不可跳过Composer原生install流程。
离线环境批量解压 ZIP 包必须先确认 dist 格式和缓存路径
Composer 离线安装依赖时，composer install --prefer-dist 本质是下载并解压 ZIP 包（不是 Git clone），所以“批量解压”不是通用操作，而是对 ~/.composer/cache/files/ 下已缓存的 ZIP 文件做预处理。关键前提是：这些 ZIP 必须与 composer.lock 中每个包的 dist.shasum 完全匹配，否则解压后 composer install 会校验失败并报 Hash mismatch。
常见错误现象：unzip: cannot find or open vendor/acme/pkg.zip 或 Failed to extract acme/pkg: (RuntimeException) Could not decompress ...——不是 ZIP 损坏，而是路径不对或文件名被 Composer 重命名过（如 acme/pkg/abc123.zip）。
- Linux/macOS 默认缓存路径是
~/.composer/cache/files/；Windows 是%APPDATA%\Composer\Cache\files\ - ZIP 文件名格式为
vendor/name/sha384-hash.zip，其中 hash 来自composer.lock的dist.shasum字段 - 不能直接解压到
vendor/目录下——Composer 有自己的一套提取逻辑（含 symlink 处理、autoload 注册等），手动解压会跳过这些步骤，导致Class not found
用 shell 脚本批量解压前必须先禁用网络并验证 lock 文件
脚本执行前不设 COMPOSER_DISABLE_NETWORK=1，哪怕 ZIP 全在本地，composer install 仍会尝试请求 https://repo.packagist.org/packages.json 并卡死。而 composer.lock 若含 "source": {"type": "git", "url": "..."} 这类条目，脚本再怎么解压也无效——Git 源无法离线还原。
- 先运行
composer config --global repo.packagist false彻底禁用默认源 - 检查
composer.lock中所有包的dist.type是否均为zip（不是tar或git） - 确认
dist.url字段是相对路径或可映射到本地 ZIP（如https://packages.example.com/acme/pkg/abc123.zip需提前重定向到本地文件系统）
真正可用的批量解压脚本只适用于 artifact 仓库场景
如果你用的是 "type": "artifact" 仓库（即把所有 ZIP 打包进一个目录供 Composer 扫描），那才需要批量解压准备阶段。但注意：artifact 类型只解决顶层包，子依赖仍需从 packagist 或其他源拉取——除非你已用 composer install --no-dev --prefer-dist 在联网机完整跑过一遍，并把整个 ~/.composer/cache/files/ 拷过去。
示例脚本（Linux/macOS，假设 ZIP 全在 /opt/composer-artifacts/）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
#!/bin/bash
cd /opt/composer-artifacts
for zip in *.zip; do
if [[ -f "$zip" ]]; then
name=$(basename "$zip" .zip)
mkdir -p "extracted/$name"
unzip -q "$zip" -d "extracted/$name"
fi
done
但这只是准备动作，后续仍要配置 composer.json：
"repositories": [
{
"type": "artifact",
"url": "/opt/composer-artifacts/extracted/"
}
]
注意：url 必须指向解压后的目录（不是 ZIP 所在目录），且该目录下必须是按 vendor/name/ 结构组织的子目录。
别写“自动解压 + composer install”一体化脚本
试图用脚本把 ZIP 解压、改权限、补 autoload、清 cache 一气呵成，反而容易出错。Composer 的 install 流程本身已包含解压、校验、symlink、autoload 生成等原子步骤，强行拆开会绕过关键校验点。
-
composer install --no-plugins --no-scripts --no-autoloader已足够快，它只做元数据比对和 ZIP 提取，不触发任何钩子 - 真正要补的是
composer dump-autoload -o，不是手动复制vendor/autoload.php - 如果目标机器磁盘空间紧张，宁可删掉
~/.composer/cache/files/后只保留vendor/和composer.lock，靠composer install --no-network读 lock 文件跳过下载
最易被忽略的一点：composer install 在离线时仍会访问 vendor/composer/installed.json 和 vendor/composer/ClassLoader.php，这两个文件若被脚本误删或权限设错（如非 PHP 进程用户写入），会导致后续所有 autoload 失败，且错误信息不提示具体原因。
