虚拟包是type为virtual、仅含replace字段的占位符，无代码无autoload，只解决依赖冲突；真正定义接口的是psr/log等PSR包，它们通过PSR-4自动加载提供可被识别和使用的契约接口。
Composer 虚拟包本身不定义接口——它只是个“占位符”，真正定义接口的是 PSR 包或你自己的抽象包。 用 composer require psr/log 这类操作，装的不是实现，而是契约；虚拟包（如 php-fig/log）连代码都没有，只靠 replace 声明告诉 Composer：“我提供这个接口，别再装别的了”。搞反顺序，就会在 autoloading 或类型提示时出错。
什么是虚拟包？为什么它不能放接口代码
虚拟包是 composer.json 中 type 为 virtual、且仅含 replace 字段的包，例如：
{
"name": "myorg/logging-contract",
"type": "virtual",
"replace": {
"psr/log": "^3.0"
}
}
它没有 src/，没有 autoload，也没有任何 PHP 文件。Composer 只把它当“声明”用：一旦项目 require 了 psr/log，而你又提前 require 了这个虚拟包，Composer 就会跳过安装真实 psr/log，并认为契约已满足。
- 虚拟包无法被
autoload—— 没有文件可映射命名空间 - IDE 和 PHPStan 不会识别其中的接口 —— 因为根本不存在
LoggerInterface的定义 - 它只解决依赖图冲突，不参与运行时类型校验
接口该放在哪？PSR 包才是标准载体
真正承载接口定义的，是官方 PSR 包，比如 psr/log、psr/container。它们是纯接口库，不含实现，体积小、无依赖、可被任意框架复用。
-
psr/log提供LoggerInterface，所有日志服务必须实现它 -
psr/http-message定义RequestInterface/ResponseInterface，是 Guzzle、Slim、Hyperf 共同遵循的边界 - 这些包的
composer.json明确声明"autoload": {"psr-4": {"Psr\Log\": "src/"}}，所以能被自动加载和类型提示识别
你自己的接口包也应照此结构：独立命名空间、PSR-4 自动加载、零实现、只含 .php 接口文件。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
如何用 Composer 实现“接口解耦”？关键在 require + type + autoload 配合
想让业务代码只依赖接口、不绑定实现，得靠三者协同：
- 业务代码
require接口包（如"psr/container": "^2.0"），而非具体容器（如hyperf/di） - 实现包在
composer.json中用"provide"声明自己实现了哪些接口："provide": {"psr/container-implementation": "1.0"} - 接口包自身必须带正确的
autoload，否则new ContainerInterface()会报Class not found
常见错误是：自己写了个 MyContainerInterface，但没配 autoload，也没发布到 Packagist；结果别人 require 后，PHP 找不到类，却以为是 Composer 没装上。
本地开发接口包时，autoload 和路径映射最容易漏掉
用 path 仓库方式本地开发接口包，composer.json 必须显式写全 autoload：
{
"name": "myorg/core-contracts",
"autoload": {
"psr-4": {
"MyOrg\Contracts\": "src/"
}
}
}
否则即使 composer install 成功，MyOrgContractsContainerInterface 仍不会被加载。
- 别依赖 IDE 自动补全来判断接口是否存在——先跑
composer dump-autoload -o看是否报错 - 用
composer show myorg/core-contracts确认 autoload 配置已生效 - 测试时直接 new 一个接口会 fatal error，正确姿势是写个实现类，再
implements MyOrgContractsContainerInterface
接口解耦的成败，不在 replace 或 provide 的花哨配置，而在那一行 "MyOrg\Contracts\": "src/" 是否准确、是否被 Composer 读到、是否和实际文件结构对得上。
