必须用path仓库且三者精确匹配：路径（如"../shared-logging"）、版本（"@dev"或"dev-main"）、符号链接开关（"options":{"symlink":true}）；否则默认复制、不生效，改代码无反应。

本地开发时怎么让多个微服务实时引用未发布的包

必须用 path 类型仓库，且配置要精确到路径、版本和符号链接开关。Composer 不会自动扫描子目录，也不会把同名包当成本地代码——它只认你明确定义的 repositories。

• url 必须是相对于根项目 composer.json 的路径，比如子包在 ../shared-logging，就写 "../shared-logging"，不能写绝对路径或错位的相对路径
• 版本约束必须是 "*@dev" 或明确分支如 "dev-main"；写 "^1.0" 会让 Composer 跳过本地路径，转而查 Packagist
• 必须显式启用符号链接："options": {"symlink": true}，否则默认是复制文件，改了源码不会生效
• Windows 下需以管理员身份运行终端，或开启“开发者模式”，否则 mklink 失败，vendor/ 里出现的是副本而非链接

为什么改了共享包代码，服务里还是 Class not found

大概率是自动加载没刷新，或者符号链接根本没建成功。Composer 的 autoload 只读 vendor/ 下的已安装包，它不关心你本地目录有没有改——链接存在但映射没更新，类照样找不到。

Workflow Decomposer

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

下载

• 先确认 vendor/acme/logging 是个符号链接（Linux/macOS 用 ls -l，Windows 用 dir），不是普通文件夹；不是链接，说明 composer install 或 update 没走 path 流程
• 链接存在但类仍找不到？立刻跑 composer dump-autoload —— 它只刷新 vendor/composer/autoload_*.php，不重建链接，但这是解决 Class not found 最常漏掉的一步
• 如果共享包改了命名空间或新增了 PSR-4 映射，仅 dump-autoload 不够，得删掉 vendor/acme/logging 再跑一次 composer install

生产环境为什么不能保留 path 配置

因为 CI 构建机上没有你的本地路径，../shared-logging 直接 404，composer install 立刻失败。path 仓库只适合开发阶段临时联调，上线前必须切换成可复现、可审计的源。

• 必须用私有 Packagist（如 Satis）替代：把共享包打 tag 推送到 Git，Satis 扫描后生成静态 packages.json，所有服务统一指向该内网地址
• CI 流水线中禁用 packagist.org："packagist.org": false 必须写在 composer.json 顶层，否则构建时可能混入旧版公共包
• 上线前检查 composer.lock：确保所有内部包的 source 类型是 dist 或 vcs，而不是 path；含 type: "path" 的条目等于埋雷
• 微服务各自 require 共享包时，版本号必须用具体 tag（如 "1.2.0"），禁用 dev-main——否则不同服务可能拉到不同 commit，破坏一致性

多个共享包互相依赖时，为什么总有一环走远程

只要有一个包没被 repositories 覆盖，Composer 就会 fallback 到 packagist.org 或其他可用源补全，导致混合加载。这不是容错，是设计行为——它不会报错，但会悄悄装错版本。

• 假设 user-service → acme/http-client → acme/core-utils，那么 repositories 数组里必须同时包含 http-client 和 core-utils 的 path 或 vcs 条目，缺一不可
• 数组顺序很重要：若两个源都提供 acme/core-utils，只有排在前面的那个生效；后面那个完全被忽略，哪怕它版本更新
• 别依赖全局 ~/.composer/config.json 里的 repositories——项目级 composer.json 中的配置才决定实际行为，CI 环境通常不读全局配置
• 验证方式简单：删掉 vendor/，执行 composer install -vvv，看日志里每个包是从哪个 URL clone 或 download 的

真正难的不是配对，而是每次切环境时记得清理 path、更新 lock、核对 source.type。这些步骤一旦漏掉，问题往往在线上才暴露，而且很难回溯。