用途:在 Laravel 13 上使用 Livewire 4 构建响应式 UI,无需编写 JavaScript。主要能力包括响应式 PHP 组件与 Blade 视图、wire:model 双向绑定、从前端调用 PHP 方法的 actions、组件间通信 events,以及单文件组件 Volt 和基于文件的路由 Folio。
使用方式:该技能要求先并行启动三个 agent(explore-codebase 检查现有组件、research-expert 通过 Context7 核对 Livewire 4 模式、mcp__context7__query-docs 查询具体特性),实现后用 sniper 验证。组件选型上,复杂逻辑用类组件,简单页面用 Volt 函数式 API,中等复杂度用 Volt 类式,快速嵌入用 @volt 内联,文件路由用 Folio + Volt。绑定方面,表单实时校验用 wire:model.live.blur,搜索输入用 wire:model.live.debounce.300ms,复选框用 wire:model.live,下拉用 wire:model。
限制与规则:循环中必须使用 wire:key;敏感 ID 用 #[Locked];破坏性操作需 authorize();内部逻辑用 protected 方法;避免在 render() 中查询、避免所有字段都用 .live、避免在公共属性存敏感数据。Livewire 4 要求 PHP 8.1+ / Laravel 10+,端点改为 /livewire-{hash}/update,需更新防火墙与 CDN 规则;从 Livewire 3 迁移需 composer require livewire/livewire:^4.0 后执行 php artisan optimize:clear。4.1+ 中 .blur/.change 仅同步客户端状态,需网络请求时写 wire:model.live.blur。具体模板与参考文档细节暂未提供。