离线环境下不能用 asset-packagist.org，因其依赖网络拉取元数据和压缩包；唯一可靠方式是使用 artifact 仓库预下载前端包（如 bootstrap-5.3.3.tgz），在 composer.json 中配置 "type": "artifact" 指向本地 packages/ 目录，并 require 带精确版本的包名。
离线环境下不能用 asset-packagist.org
asset-packagist.org 是在线 CDN 服务，离线时 composer require npm-asset/jquery 会直接失败，报错类似 Could not fetch https://asset-packagist.org/packages.json。它依赖网络拉取元数据和压缩包，不适用于内网、断网或强管控环境。
改用 artifact 仓库 + 预下载包
这是离线唯一可靠的方式：把前端包提前下载为 zip/tar.gz，本地存为文件，再通过 Composer 的 artifact 类型仓库声明。Composer install 时直接解压，不联网。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 准备包文件：从 npm registry 或 GitHub Actions 下载构建好的前端包（如
bootstrap-5.3.3.tgz），确保包里含dist/或build/目录 - 在项目根目录建
packages/文件夹，把所有 zip/tgz 放进去 - 在
composer.json中添加仓库配置："repositories": [ { "type": "artifact", "url": "./packages" } ] - require 时用完整包名+版本，例如：
composer require npm-asset/bootstrap:5.3.3（注意不是npm-asset/bootstrap简写，离线必须带精确版本）
extra.asset-installer-paths 在离线时仍有效，但路径必须存在
这个配置本身不联网，只控制解压后文件拷贝目标。但它有个硬性前提：目标目录（如 public/css/bootstrap）必须在执行 composer install 前已存在，否则插件会静默跳过或报 warning 而不终止流程。
- 确保
public/css、public/js等父目录已手动创建，或加进 git（空目录需放.gitkeep） - 路径中不能含变量或运行时计算逻辑，只支持字面量字符串
- 如果包结构不标准（比如没
dist/css/而只有scss/），asset-installer-paths不会自动编译，只会原样复制 —— 离线环境无法补救
post-install-cmd 调用 npm 构建在离线时彻底失效
除非你已在离线机上预装 Node.js、npm 和全部依赖包（包括 node_modules/ 压缩包），否则 npm install 或 npm run build 必然失败。错误信息通常是 sh: npm: not found 或 Cannot find module 'webpack'。
- 不要在离线部署脚本里保留
post-install-cmd中的 npm 命令，它们会拖慢安装且掩盖真实问题 - 若必须构建，应改为提前在有网环境构建好
public/build/，然后把整个目录打包进 artifact 包，由asset-installer-paths解压到目标位置 - 验证构建产物完整性：检查
public/build/manifest.json是否存在、public/build/app.js是否可读，避免“看似成功实则空目录”
composer.json 必须声明 type 为 npm-asset 或 bower-asset，否则 fxp/composer-asset-plugin 不识别，也不会触发 asset-installer-paths 拷贝逻辑。
