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 全量重装

Filament 的安装不是“跑完一条命令就完事”，真正卡住的地方往往在 Laravel 自动发现机制、Vite 编译链路、以及路由加载时机这些隐性环节。很多人反复重装，其实只差一行 php artisan optimize:clear 或一次 npm run build。