composer.lock 损坏需提前检测：用 php -l composer.lock 检查 JSON 语法，composer validate --no-check-all 校验结构，手动确认 "packages" 和 "packages-dev" 字段存在；损坏后不可直接删 lock 运行 install，应根据 vendor 状态选择 composer update --lock 或 composer install --no-cache --force-checksums 修复。

composer.lock 文件损坏时，composer install 会直接报 JSON 解析错误或静默失败，不能靠重试解决——必须先验证结构、再重建或修复。

如何快速判断 composer.lock 是否真损坏

别等 composer install 报错才行动。运行以下命令可提前暴露问题：

• php -l composer.lock：PHP 自带语法检查，能捕获最基础的 JSON 格式错误（如末尾逗号、引号不闭合）
• composer validate --no-check-all：只校验 lock 文件结构合法性，不查依赖解析（比全量 validate 快得多）
• 手动用编辑器打开 composer.lock，搜索 "packages" 和 "packages-dev" 字段是否存在——缺失任一即为严重损坏

损坏后不能直接删 lock 再跑 install

composer install 的语义是“按 lock 精确还原”，lock 文件不存在时，它不会自动重建，而是：
• Composer v2.5+ 直接报错 Command "install" is not defined
• 旧版可能退化为 composer update 行为，导致依赖漂移

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 想从头生成 lock？必须用 composer update 或 composer update --lock
• composer update --lock 适合 lock 被手动改坏但 vendor 完整的场景：它不碰已安装包，只重写 lock 文件使其与当前 vendor 对齐
• 若 vendor 也损坏（比如报 The PHP file ... is corrupted），则必须同步删掉 vendor/ 和 composer.lock，再用 composer install --no-cache --force-checksums 强制重装

修复时最容易被忽略的三个点

结构损坏常伴随深层配置错位，光修 JSON 不够：

• composer.lock 中的 content-hash 字段必须与 composer.json 当前内容完全一致，否则后续 update 会误判“有变更”而触发不必要的升级
• 如果项目用了 "config": {"lock.exclude-dev": true}，但 composer.lock 里仍出现了 packages-dev，说明 lock 生成逻辑已被破坏，应清缓存后重跑 composer update --lock
• Git 合并冲突残留（如 <<<< HEAD）会导致 JSON 解析失败，这类损坏无法靠 composer update --lock 自动清理，必须人工删掉冲突标记再验证

真正麻烦的不是 JSON 格式错，而是 lock 文件里记录的哈希、版本、源地址三者之间逻辑断裂——这种损坏不会报错，但会让 install 还原出错包，直到运行时报 Class not found 才暴露。