replace字段仅声明逻辑覆盖，不触发下载或替换；生效需同时满足：① fork包已安装，② require中明确指向被replace包名，且须配合repositories、require别名（as）及conflict配置。

replace 字段本身不下载、不替换，只是“声明我顶替他”

很多人以为在 composer.json 里加个 "replace": {"monolog/monolog": "*"} 就能自动换掉原包——不会。Composer 完全忽略这个声明，除非你同时满足两个前提：① 你的 fork 包已被安装；② 其他依赖或项目顶层 require 中明确指向了被 replace 的包名。replace 是依赖解析阶段的“逻辑覆盖”，不是运行时的文件替换，也不触发任何下载行为。

• 单独写 "replace" 而不改 require 或没配置 repositories，等于没写
• 如果你的项目里已经 require 了 monolog/monolog，那必须把它删掉，再 require 你的 fork 包（用别名），否则 Composer 会坚持装原版
• replace 生效后，composer show monolog/monolog 不会显示它；composer depends monolog/monolog 会返回 “no packages require”

真正起作用的是 repositories + require + 别名（as）组合

要让 Composer 拉你的 fork 而非官方包，核心是三件套：repositories 告诉它去哪找，require 明确要谁，as 让它“假装”是原版本。缺一不可。

Workflow Decomposer

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

下载

• 在 repositories 中添加类型为 vcs 的条目，URL 指向你的 GitHub/GitLab 分支（如 "https://github.com/yourname/monolog"）
• 在 require 中写原包名 + 分支别名，例如："monolog/monolog": "dev-main as 2.10.0" —— 这表示“用我的 main 分支，冒充官方 2.10.0”
• 别名版本（as 2.10.0）必须满足其他依赖的约束，比如另一个包写了 "monolog/monolog": "^2.8"，那你不能 alias 成 1.9.0
• 改完必须执行 composer update monolog/monolog，否则缓存仍用旧版本

fork 包自己的 composer.json 里该不该写 replace？

应该写，但目的不是让你的项目“自动替换”，而是帮下游项目避免冲突。这是预防性设计，不是启动开关。

• 在你 fork 的包（如 yourname/monolog）的 composer.json 中加："replace": {"monolog/monolog": "*"}
• 这样当别人 require yourname/monolog 时，Composer 就知道它已覆盖原包，不会再试图装 monolog/monolog，也不会因版本重叠报错
• 必须配合 "conflict": {"monolog/monolog": "*"}，否则两个包可能共存，导致 Cannot declare class 类加载冲突
• 注意：Composer 1.10+ 才完整支持 replace 和 conflict 联动校验，老版本慎用

为什么换了 fork 还报 Class not found 或重复定义？

常见错误不是配置漏了，而是 autoload 或命名空间没对齐。replace 后 Composer 不再加载原包的 autoload，所有类必须由你的 fork 自己提供，且路径、前缀、PSR 规则完全一致。

• 检查你的 fork 是否包含和原包相同的 autoload 配置（"psr-4": {"Monolog\": "src/"}）
• 临时在关键类构造函数里加 debug_print_backtrace()，确认加载的类确实来自你的 vendor/yourname/monolog，而不是残留的 vendor/monolog/monolog
• 如果 fork 是从原包 clone 后改的，确保没删掉 src/ 下的子目录结构或改错命名空间
• 运行 composer dump-autoload -o 强制刷新自动加载映射，尤其在改过 autoload 后

替换不是改一行配置就能生效的事。它涉及依赖图重算、自动加载切换、版本伪装、冲突拦截四个层面，任一环节断开都会回退到原包或直接报错。最常被跳过的动作是：没删旧 require、没清缓存、没验证 autoload 路径、没加 conflict 锁死共存可能。