filament 的 artisan 命令需服务提供者注册后才可用，常见原因包括未执行 composer dump-autoload（laravel 10-）、未清缓存（laravel 11+ 用 php artisan optimize:clear）、或未运行 php artisan package:discover；v3 必须用 --panels 参数安装，--admin 已废弃。
Composer install filament 后为什么 php artisan filament:install 报错“command not found”
Filament 的 Artisan 命令不是安装完包就自动可用的，它依赖服务提供者注册和配置文件发布。常见原因是没运行 composer dump-autoload 或 Laravel 没加载 Filament 的服务提供者。
- 确认
composer require filament/filament:"^3.0"执行成功，且vendor/filament/filament目录存在 - 检查
config/app.php中是否手动删掉了Filament\FilamentServiceProvider::class（Laravel 11+ 默认已移除该文件，靠自动发现） - Laravel 10 及以下需确保
composer dump-autoload已执行；Laravel 11+ 推荐用php artisan optimize:clear清缓存 - 若仍报错，运行
php artisan package:discover强制重新扫描包
用 php artisan filament:install --panels 还是 --admin
这两个参数决定安装哪套核心模块：--panels 是 Filament v3 的默认后台系统（含用户、资源、仪表盘），--admin 是旧版 v2 的遗留别名，v3 中已废弃，强行使用会报错或生成不兼容结构。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- v3 项目必须用
--panels，否则后续php artisan make:filament-resource会失败 -
--panels会发布config/filament.php和routes/filament.php，并创建app/Providers/Filament/AdminPanelProvider.php - 如果项目已有
App\Providers\FilamentProvider（v2 风格），先删掉再运行 install，否则冲突 - 不加参数直接
php artisan filament:install会提示你选，但脚手架逻辑不稳定，建议明确指定
安装后访问 /admin 404 或跳转登录页空白
这不是 Composer 或安装命令的问题，而是路由未启用或中间件拦截导致的典型现象。Filament 的面板路由默认由 routes/filament.php 定义，但该文件不会自动被 Laravel 加载。
- 确认
routes/filament.php存在，且内容包含use Illuminate\Support\Facades\Route;和Route::filament()调用 - 检查
bootstrap/app.php（Laravel 11+）或app/Providers/RouteServiceProvider.php（Laravel 10-）中是否漏掉了对routes/filament.php的引入 - 登录页空白大概率是 Vite 构建未启动：运行
npm install && npm run dev，确保resources/css/filament.css和resources/js/filament.js被正确编译 - 若用 Laravel Sail，记得
npm run dev要在容器外执行，且VITE_PORT端口没被占用
升级 Filament 时 composer update filament/filament 失败
Filament v3 对 PHP 版本、Laravel 版本、Livewire 版本有硬性要求，盲目 update 容易触发依赖冲突，尤其在 Laravel 10 升 11 或 PHP 8.1 升 8.2 的过渡期。
- 先查官方 Releases 页面，确认目标版本支持的
laravel/framework范围（如 v3.2.59 要求 "^11.0"） - 运行
composer why-not filament/filament:^3.2查具体哪个包卡住升级 - 常见冲突源：
livewire/livewire（Filament v3 要求 "^3.5"）、blade-ui-kit/blade-ui-kit（v3 不再需要，得卸载） - 升级前务必删掉
vendor/filament和composer.lock中相关条目，再composer update全量重装
php artisan optimize:clear 或一次 npm run build。
