composer create-project 不支持直接从 artifact/package 仓库拉取 zip 模板，因其仅识别 type: "project" 包且只通过 packagist 或 vcs 获取源码/dist；需伪装为 packagist dist 包或改用 install + artifact 方式实现离线模板初始化。
Composer create-project 本身不支持直接从自定义仓库（如 artifact 或 package 类型）拉取 ZIP 包来初始化项目——它只认 type: "project" 的包，且默认只从 Packagist 或 Git VCS 拉取。想用私有 ZIP 做模板？得绕过默认逻辑，手动构造可被识别的 project 包结构。
为什么 create-project 不走 artifact/package 仓库？
create-project 的设计目标是“克隆一个完整可运行项目”，不是“安装依赖”。它内部会先解析包类型，只接受 "type": "project" 的包，并且只通过 Packagist API 或 VCS（Git/Svn）获取源码或 dist 归档。它完全忽略 repositories 中配置的 artifact 或 package 类型——这些只对 require 和 install 生效。
- 执行
composer create-project myorg/my-template时，Composer 会去 Packagist 查myorg/my-template，找不到就报错，哪怕你本地composer.json里已配了artifact仓库 -
create-project --repository=...只支持 VCS URL（如https://github.com/.../.git），不支持http://intranet/artifacts/这类 artifact 目录 URL - 即使 ZIP 文件名符合
myorg-my-template-1.0.0.zip，create-project也不会扫描它——它不调用 artifact 扫描逻辑
让 ZIP 被 create-project 识别的唯一可行路径：伪装成 Packagist 风格 dist 包
核心思路：把你的 ZIP 当作 Packagist 发布的 dist 包来“模拟”，关键在于让 Composer 认为这个 ZIP 是某个 type: "project" 包的官方 dist 归档。这需要两层配合：
- ZIP 必须解压后根目录含合法
composer.json，且其中"name"字段必须是标准 vendor/name 格式（如"myorg/my-template"），"type"必须为"project" - ZIP 文件本身需托管在可通过 HTTPS 直连的地址（如内网 HTTP 服务器、Nginx 目录索引页），且文件名严格匹配
{vendor}-{name}-{version}.zip（例如myorg-my-template-1.0.0.zip） - 运行命令时加
--repository指向一个**伪造的 Packagist 兼容 API 端点**，或者更实际的做法：用--repository指向一个 Git 仓库 URL，但该仓库的 tag 对应 ZIP 的 version，并在 tag 的composer.json中指向你的 ZIP —— 这本质是借 Git 的壳，走 dist 的路
示例（推荐）：
假设你有 ZIP https://intranet/releases/myorg-my-template-1.0.0.zip，内容含 composer.json 且 "type": "project"。你可以建一个极简 Git 仓库，仅含一个 composer.json：
{
"name": "myorg/my-template",
"type": "project",
"dist": {
"url": "https://intranet/releases/myorg-my-template-1.0.0.zip",
"type": "zip"
}
}
打 tag v1.0.0，然后执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer create-project --repository=https://intranet/git/my-template.git myorg/my-template my-new-project --stability=stable
create-project + --prefer-dist 能否强制走你的 ZIP？
不能直接指定，但可以间接触发。前提是你的包已在 Packagist 注册，且其 composer.json 的 dist 字段指向你的 ZIP 地址。此时 create-project myorg/my-template --prefer-dist 会尝试下载该 ZIP。但注意：
- 如果 Packagist 上该包的
dist.url不是你控制的地址，你就无法替换 - 私有包若未提交到 Packagist，
--prefer-dist会 fallback 到 source（即尝试 clone Git），除非你用--repository显式覆盖源 - 国内镜像（如阿里云）可能缓存旧的 dist URL，导致仍拉不到你的 ZIP，需确认镜像是否同步或临时禁用：
composer config --global repo.packagist false
真正离线可用的替代方案：不用 create-project，改用 install + artifact
如果你只是想快速生成一个基于 ZIP 模板的新项目，又不需要 post-create-project-cmd 钩子，最稳的方式是放弃 create-project，改走标准依赖流程：
- 新建空目录，写入
composer.json，声明artifact仓库指向 ZIP 所在目录（如"url": "./templates"） - 确保 ZIP 文件名为
myorg-my-template-1.0.0.zip，且内部composer.json含"type": "project"和完整 autoload/require - 运行
composer require myorg/my-template:1.0.0—— 它会把 ZIP 解压到vendor/myorg/my-template/ - 再用脚本把
vendor/myorg/my-template/*复制到项目根目录，删掉vendor，就完成了“模板实例化”
这个流程绕开了 create-project 的限制，完全由你控制 ZIP 来源和解压位置，也兼容离线环境。唯一多出的一步是手动复制，但可轻松封装成 shell 或 PHP 脚本。
最关键的细节常被忽略：ZIP 内部的 composer.json 必须在根目录，且 "name" 和 "version" 必须与文件名、require 声明三者字面完全一致——差一个下划线或空格，就会静默失败，而不是报错。
