答案：需用Satis构建静态镜像并严格配置三项——require-all为true、archive块完整、repositories中每个私有包单独声明type；全局镜像必须设为repo.packagist且含type和https结尾斜杠，项目级repositories也须注册同名内网源。
不能直接“同步 Packagist 官方镜像”——你真正需要的是一个可被 Composer 正确识别的、支持语义化版本查询的 HTTP 服务，而不是 rsync 或 git clone 一堆文件。
为什么 repositories + path 协议在局域网里完全无效
很多人在 composer.json 里写 {"type": "path", "url": "./packages/*"}，以为把 ZIP 放进共享目录就能用。实际它只在当前机器本地文件系统生效：
- 该配置不启动任何 HTTP 服务，其他机器无法通过
http://访问 -
file://协议在 Docker、CI 构建机、不同用户权限下基本不可用 - 不生成
packages.json元数据，composer require monolog/monolog会直接报Could not find package - 删掉本地目录，整个依赖树就崩，毫无容错和复用能力
必须用 Satis 构建静态镜像，且三个字段缺一不可
Satis 是唯一轻量、稳定、真正可用的局域网方案。它生成纯静态文件（packages.json + dist/*.zip），扔到 Nginx 就能被所有机器访问。但以下三处配置漏掉任意一个，composer install 就会拉不到 zip 包或找不到版本：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"require-all": true—— 否则只同步composer.json里显式require的包，私有仓库里的其他 tag、dev 分支、历史版本全丢 -
"archive"块必须完整：{"directory": "dist", "format": "zip", "skip-dev": true}—— 缺这个，CI 构建时只能走git clone，而内网往往禁用 git 协议 -
"repositories"必须是对象数组，每个私有包要单独声明类型：{"type": "vcs", "url": "https://gitlab.internal/internal-sdk"}—— 写成字符串 URL 或漏掉type，Satis 构建时直接跳过该仓库
全局配置镜像源后，必须验证是否真正生效
运行 composer config -g repo.packagist，输出必须是类似：
{"type": "composer", "url": "https://packagist.internal/"}
注意几个关键点：
- 键名必须是
repo.packagist（不是repos.packagist或packagist.org） -
type字段不能丢，否则 Composer 静默 fallback 回官方源 -
url必须带https://和末尾斜杠；http://在新版 Composer 默认被拒绝，除非加--allow-http - 如果输出为空或报错，说明全局配置根本没写入；常见原因是 PHP 禁用了
proc_open或putenv，需检查php.ini并重启 PHP 服务
最常被忽略的一点：即使 Satis 已生成了所有包，客户端仍可能报 Could not find package xxx，原因不是镜像没同步，而是项目 composer.json 的 repositories 字段没注册内网源，或者 key 没叫 packagist —— Composer 只认这个 key 作为主源，其他名字一概无视。
