内网离线环境必须用 Satis 构建本地镜像并禁用网络：设 COMPOSER_DISABLE_NETWORK=1、清全局源、用 composer install --no-plugins --no-scripts --no-autoloader 后 dump-autoload；path 仓库仅适用于已有本地源码，不解决第三方包离线安装。
内网离线环境不能靠“断网自动降级”或改 hosts 解决，必须提前构建可被 Composer 识别的本地元数据 + 包文件，并彻底切断对 packagist.org 的任何依赖路径。
为什么直接复制 vendor 目录进内网会失败
即使 vendor/ 完整、composer.lock 也带过去了，composer install 仍大概率报 Could not fetch https://repo.packagist.org/packages.json——这不是缓存没清干净，而是 Composer 在 install 阶段默认校验远程元数据，该行为无法跳过，除非显式禁用网络且清除全局源配置。
-
COMPOSER_DISABLE_NETWORK=1是硬性前提，不设它，所有--no-xxx参数都无效 - 全局配置里残留
repo.packagist会导致 fallback 校验，必须运行composer config --global repo.packagist false - 如果
composer.lock中某包是"source"类型（如 Git URL 或dev-master），离线时无法校验，install 必然失败
用 Satis 构建静态镜像并部署为 HTTP 服务
Satis 是唯一能复现 Packagist 行为的轻量方案：它生成 packages.json + ZIP 文件，让 Composer 认为它在跟一个真实仓库通信。关键不是“有没有网”，而是“有没有合法响应”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在联网机执行：
composer global require composer/satis，然后准备satis.json，明确指定要缓存的包（支持通配符，但慎用"require-all": true） - 运行：
php ~/.composer/vendor/bin/satis build satis.json web/，输出的web/目录即完整镜像 - 把
web/拷到内网机，用python3 -m http.server 8000启服务，确保curl http://localhost:8000/packages.json可访问 - 内网机执行：
composer config -g repos.packages composer http://localhost:8000（注意末尾无斜杠）
离线机执行 install 的最小安全命令集
哪怕 vendor 已存在，也必须走一遍 install 流程，否则 autoload 不生效、脚本不注册、插件不加载——但每一步都得防意外联网。
- 先清缓存：
composer config --global cache-dir /dev/null（避免读取旧远程缓存） - 再执行：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - 最后补一记：
composer dump-autoload -o，否则运行时报Class not found - 若项目含自定义脚本（如
post-install-cmd），需确认它们不依赖外部 API，否则应在composer.json中临时注释掉
path 仓库只适用于已存在的本地代码包
很多人想用 "type": "path" 绕过网络，但它和离线安装第三方库无关——它只用于你手头已有某个包的完整源码目录，且该目录下必须有合法 composer.json（含 name 和 version 或分支标识）。
- 声明方式：
"repositories": [{"type": "path", "url": "./packages/my-utils"}]（Windows 要写绝对路径，如C:/projects/my-pkg） - 安装命令必须匹配版本：
composer require my-vendor/my-utils:dev-main（不能写^1.0，因为 path 不提供版本索引） - 它不会下载 ZIP，也不会生成 dist 缓存，install 后在
vendor/下是符号链接（Linux/macOS）或完整复制（Windows），不适合分发
最易被忽略的是 composer.lock 里的源地址残留——哪怕你在联网机上用了 Satis 镜像，lock 文件里仍可能记着 packagist.org 的 URL，必须在联网机上先跑一次 composer update --lock 再带入内网，否则 Composer 会在离线时尝试回退校验。
