离线仓库必须用 artifact 或 path：artifact 要求规范命名的压缩包且 name/version 严格匹配；path 要求相对目录可移植并禁用软链；必须全局禁用 Packagist、显式配置 cache-files-dir（末尾为 /files）、避免 create-project，新增依赖仅支持 path 方式且需带 @dev。
离线仓库必须用 artifact 或 path，不能靠改 repo.packagist.org 地址
很多人以为把 composer.json 里的 repositories 改成 https://192.168.1.100/packages.json 就算离线了——其实只要没禁用默认源，Composer 仍会尝试连 repo.packagist.org 做 fallback。真正有效的离线方式只有两种：artifact（适合部署）和 path（适合本地开发联调），其他类型（如 composer 类型的本地镜像）仍需元数据解析，容易漏配。
-
artifact要求所有包是命名规范的.tar.gz或.zip，文件名必须为vendor/name-version.tar.gz，且包内composer.json的name和version必须与文件名完全一致 -
path要求包目录在项目内可移植（如./packages/my-lib），不能写绝对路径；composer.json中必须带"options": {"symlink": false}，否则离线机上软链失效 - 无论哪种，都必须全局关闭 Packagist：
composer config --global repo.packagist false；再检查项目级配置是否残留：composer config repo.packagist输出应为空，不是composer https://packagist.org
cache-files-dir 必须显式配置，cache-dir 配了也白配
离线时 Composer 只认 cache-files-dir 下的 ZIP 包，cache-dir 只是父目录，不控制 ZIP 存放位置。未设 cache-files-dir 时，它会回退到默认的 ~/.composer/cache/files，而离线机上这个路径通常为空或不可写，导致静默重下。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 正确做法：在线机先清旧配置
composer config --global --unset cache-dir，再设composer config --global cache-files-dir /opt/composer-cache/files（注意末尾必须是/files） - 验证是否生效：运行
composer install --prefer-dist后，检查/opt/composer-cache/files/vendor/name/version-hash/name-version-hash.zip是否真实存在 - 离线机上要完整复制整个
/opt/composer-cache/files目录（保留层级），再执行composer config --global cache-files-dir /your/copied/path/files - 常见失败点：目录权限不对（如 PHP 进程用户无法
stat()文件）、路径少写了/files、或cache-read-only设为true但目录实际不可读
别碰 create-project，它离线必挂
create-project 是个黑盒命令，第一步就强制联网请求 packages.json 解析模板元数据，COMPOSER_DISABLE_NETWORK=1 对它无效，--offline 参数根本不存在。哪怕你把 composer.lock 和 composer.phar 全拷过去，它照样报 Could not fetch https://repo.packagist.org/packages.json。
- 可行替代路径：在联网机用
git clone或解压官方 ZIP 拿到骨架，删掉原有composer.lock，再执行composer install --no-dev --prefer-dist --no-scripts --no-plugins --optimize-autoloader - 打包整个项目（含
vendor/、composer.lock、composer.json）传到离线机 - 离线机执行：
composer config --global cache-dir /dev/null→COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader→ 最后补composer dump-autoload -o
新增依赖只能靠 path，require 默认不离线
离线环境下，composer require monolog/monolog 一定会失败，因为它默认要查 Packagist。唯一能离线加新包的方式是提前配置好 path 仓库，并确保包目录已存在、composer.json 有效、且 name/version 完全匹配。
- 项目
composer.json中添加："repositories": [{"type": "path", "url": "./packages/monolog"}] - 包目录结构必须是：
./packages/monolog/composer.json，其中"name": "monolog/monolog"，"version": "2.13.0"（版本号要和你想 require 的一致） - 执行
composer require monolog/monolog:@dev—— 注意必须带@dev，否则 Composer 不启用 path 查找逻辑 - 如果包本身还有依赖，这些依赖也得是
path或已存在于vendor/中，否则会卡住
cache-files-dir、artifact url、path url），相对路径在跨机器迁移或不同工作目录下极易失效；同时，PHP 进程用户对这些路径要有完整读权限，stat() 失败不会报错，只会静默 fallback 到联网。 
