Filament v5 和 Filament Blueprint 发布

在 Filament v4.5 发布一周之后，Filament v5 和 Filament Blueprint 也随即发布了。

为什么选择 Filament v5？

Filament v5 集成了 Livewire v4，该版本由 Caleb Porzio 和 Livewire 团队于本周发布。祝贺他们取得这一重要里程碑！

我们将版本号升级到新的主版本，是为了确保那些不直接依赖 livewire/livewire 的项目不会意外地出现自定义 Livewire 代码失效的问题。除了支持 Livewire v4 之外，Filament v5 与 v4 版本相比没有其他任何更改，官方将继续为这两个版本推送新功能。

Filament v5 提供了一个简明的升级指南，无需任何手动操作步骤。与往常一样，官方提供了一个升级脚本，用于检查兼容性问题并自动应用更改。如果你使用了自定义 Livewire 组件，请同时参考 Livewire 的升级指南。

引入 Filament Blueprint

同时推出了 Filament Blueprint，这是一款工具，可以帮助 AI 编码代理为 Filament v4 和 v5 项目生成更好的实现计划。

AI 生成的 Filament 代码存在的问题

当你让 AI 代理使用 Filament 构建应用时，通常会得到一个模糊、笼统的计划，其中包含太多需要自行理解和推断的内容。AI 可能理解你的需求，但它并不了解 Filament 的实际工作原理。当代理开始实施计划时，它经常会弄错组件命名空间、遗漏重要的配置细节，或者创建一些不合理的布局。

Filament Blueprint 是一款高级 Laravel Boost 扩展程它可以为你的 AI 代理提供关于 Filament 组件、模式和最佳实践的全面知识。当你请求实施计划时，代理会生成一份详细的规范，可以直接执行，无需任何猜测。

Blueprint 计划示例

将 Blueprint 安装到 Laravel Boost 后，你可以使用规划模式，让你的代理程序为你的功能创建一个“Filament Blueprint”。例如：

Using Filament Blueprint, produce an implementation plan for a Filament v4 application. The application is
a SaaS invoicing system with the following capabilities:
 
- Manage customers
- Manage products
- Create and edit invoices
- Add line items to invoices
- Send invoices to customers
- Record and track payments
 
The plan should:
- Describe the primary user flows end to end (for example: creating an invoice,
  sending it, recording a payment).
- Map each domain concept and flow to concrete Filament primitives (Resources,
  Relation Managers, Pages, Actions).
- Identify state transitions (such as draft → sent → paid) and the Actions that
  trigger them.

我们在安装和未安装 Blueprint 的情况下运行了此提示。

安装 Blueprint 之前——典型的 AI 生成方案：结构清晰，但细节模糊
安装 Blueprint 之后——蓝图增强后的输出：完整的实施规范

Blueprint 的输出包括：

每个表单字段、表格列和操作都提供精确的组件引用和文档链接
提供方便代理使用的命令行指令来生成文件，无需代理从头创建文件或猜测正确的非交互式命令
精确的配置链，例如 ->relationship('customer', 'name')->searchable()->preload()->createOptionForm([...])
响应式字段规范，使用 ->live() 和 afterStateUpdated() 精确展示行项目总计和发票总计如何自动计算
合理的布局选择，考虑页面不同部分的网格列数，以确保良好的用户体验
完整的操作定义，包含可见性规则、模态狂表单和行为规范
涵盖验证、组件配置、操作可见性和业务逻辑的测试用例设计

你无需花费数小时纠正 AI 的错误，即可获得可以直接实施的规范。

开始使用 Blueprint

为庆祝 Blueprint 正式发布，可以使用优惠码 BPLAUNCH20 在结账时享受限时 20% 折扣。

安装后，你可以在 AI 代理中启用规划模式，并让它为你的功能创建 Filament Blueprint。你可以在文档中了解更多关于 Blueprint 的信息。