离线环境无法配置国内镜像源，因镜像本质是需联网访问的HTTP服务；真正可行的是预下载ZIP包并配置cache-files-dir路径，或用Satis搭建本地静态镜像站点后通过localhost提供服务。
离线环境不能“配置国内镜像”，因为镜像源本质是 HTTP 服务，离线机根本连不上。所谓“离线配镜像”是个常见误解——真正能落地的，只有提前把 ZIP 包和元数据带进来，并让 Composer 认为它“正在访问一个合法仓库”。
为什么repo.packagist配置在离线机上完全无效
你执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/后，Composer 会尝试向该 URL 请求packages.json；但离线机 DNS 解析失败、TCP 连接超时，最终静默 fallback 到 packagist.org（仍失败）或直接报错Could not fetch packages.json。关键点在于：repo.packagist必须指向一个真实可访问的 HTTP 服务，不是本地路径，也不是“假装有网”。
- 镜像 URL 必须能被
curl -I https://mirrors.aliyun.com/composer/packages.json成功返回 200 -
composer.lock里记录的dist.url字段，也必须指向可下载 ZIP 的地址（比如https://mirrors.aliyun.com/composer/dists/monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip），离线机无法解析域名就卡死 - 即使强行改
composer.json里的repositories为file:///opt/mirror，Composer 默认不支持file://协议作为 Composer 类型仓库（会报Invalid repository type "composer"）
离线可用的唯一可靠方案：用cache-files-dir + --prefer-dist预打包 ZIP
真正能在断网状态下复用的，只有~/.composer/cache/files/下那些带完整路径和 shasum 校验的 ZIP 文件。它们不依赖任何网络，只要composer.lock中对应条目的dist.shasum和文件内容一致，composer install --no-network --prefer-dist就能直接解压安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 联网机器上先清空旧缓存：
composer clear-cache，再删掉项目vendor/和composer.lock - 运行
composer install --no-autoloader --no-scripts --prefer-dist，确保所有包都走 dist 下载（生成 ZIP） - 设置专用缓存路径：
composer config --global cache-files-dir /path/to/offline-zips（注意不是cache-dir） - 检查
/path/to/offline-zips/monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip是否存在且非空 - 把整个
/path/to/offline-zips目录复制到离线机相同路径，再在离线机执行composer config --global cache-files-dir /path/to/offline-zips
想用 Satis 搭本地 HTTP 镜像？那得先部署 Web 服务
如果你坚持要“镜像”的形式（比如已有 Nginx/Apache），Satis 是唯一正解，但它不是“配置”，而是搭建一个静态文件服务器：
- 联网机器用
composer global require composer/satis安装，写satis.json指定要镜像的包（别设"require-all": true，太重） - 运行
satis build satis.json /var/www/html/mirror，输出含packages.json和dist/子目录的静态站点 - 把
/var/www/html/mirror整个拷到离线机，用 Python 快速起服务：cd /mirror && python3 -m http.server 8000 - 离线机项目
composer.json里加："repositories": [{"type": "composer", "url": "http://localhost:8000"}] - 必须删掉
composer.lock再composer install，否则仍读旧的远程dist.url
最易被忽略的一点：离线机 PHP 进程用户（如www-data或daemon）必须对cache-files-dir路径有读权限，否则--prefer-dist会退化成--prefer-source并失败；而 Satis 方案里，packages.json里的dist.urls必须全部指向http://localhost:8000/dist/...，不能残留github.com——这需要手动校验或用satis build --skip-errors反复生成。
