Webman 不能通过 composer install 安装，必须用 composer create-project 创建项目骨架；因其是框架级结构，非普通库，直接 require 会导致类找不到、入口缺失、配置未加载等问题。
Webman 不能通过 composer install 安装——它不是普通 Composer 包，而是需要通过 composer create-project 创建全新项目骨架。
为什么 composer require webman/webman 会失败
Webman 是一个框架级项目结构，不是可直接引入的库。它的入口、配置、目录约定（如 app/、config/、public/）都依赖完整初始化。直接 require 会导致：
-
Class 'Webman\App' not found—— 缺少自动加载规则和启动文件 -
public/index.php不存在 —— 无法响应 HTTP 请求 -
config/bootstrap.php缺失 —— 核心服务未注册
正确安装方式：用 create-project 拉取官方骨架
运行以下命令（确保已安装 Composer 且 PHP ≥ 7.4）：
composer create-project webman/webman myapp
其中 myapp 是你的项目目录名。该命令会：
- 从
https://github.com/webman-php/webman克隆最新稳定版骨架 - 自动执行
composer install安装依赖（含workerman/workerman、psr/log等） - 生成标准目录结构，包括
start.php启动脚本
完成后进入目录并启动：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
cd myapp<br>php start.php start
常见卡点与绕过方法
国内用户常遇到 GitHub 下载慢或超时：
- 临时换镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意该镜像已停用，推荐改用https://packagist.org+git clone手动拉取） - 跳过 Git 克隆，直接下载 ZIP：
curl -L https://github.com/webman-php/webman/archive/refs/tags/v1.5.0.tar.gz | tar -xzf - --strip-components=1 -C myapp，再进目录运行composer install - 如果提示
ext-swoole或ext-openssl缺失，先确认 PHP 扩展已启用：php -m | grep -E 'swoole|openssl'
安装后第一件事：检查 start.php 和端口绑定
Webman 默认监听 0.0.0.0:8787，但开发时建议改用 127.0.0.1:8787 避免暴露本地服务。编辑 start.php 中的 $worker->listen 行：
$worker->listen('http://127.0.0.1:8787');另外注意：start.php 不是 Web 入口，不要把它放到 public/ 下；它是 CLI 启动脚本，必须在项目根目录下执行。
Webman 的核心逻辑藏在 app/ 和 config/ 里，而不是 vendor/ —— 这意味着你几乎不会去动 vendor/webman/webman，所有定制都在项目目录内完成。
