particles-router

粒子路由器

根据任务需求路由到 3 个专用粒子系统技能。

路由协议

1. 分类 — 识别粒子效果类型和规模
2. 匹配 — 找出信号匹配度最高的技能
3. 组合 — 大多数粒子系统需要结合使用 2-3 个技能
4. 加载 — 实现前阅读匹配技能的 SKILL.md 文件

快速路由

第 1 层：核心（始终考虑）

任务类型	技能	主要信号词
渲染	particles-gpu	points、instanced、buffer、shader、thousands、performance
运动	particles-physics	gravity、wind、attract、force、velocity、turbulence、collision
生成	particles-lifecycle	emit、spawn、fade、trail、pool、birth、death、age

信号匹配规则

优先级顺序

出现多个信号时，按以下优先级处理：

1. 性能问题 — “millions of particles” → 优先使用 particles-gpu
2. 运动类型 — “swirling”、“attracted to” → particles-physics
3. 发射模式 — “burst”、“continuous”、“trails” → particles-lifecycle
4. 默认情况 — 通常需要一起使用全部三个技能

置信度评分

• 高（3 个以上信号） — 立即路由
• 中（1-2 个信号） — 包含全部三个技能（典型情况）
• 低（0 个信号） — 询问：“描述一下你想要的粒子效果”

常见组合

基础粒子系统（全部 3 个技能）

particles-gpu       → Buffer setup, shader rendering
particles-physics   → Gravity, basic motion
particles-lifecycle → Emission, fade out

连接方式：GPU 提供渲染基础，生命周期处理生成和消亡，物理添加运动。

雪/雨效果（3 个技能）

particles-gpu       → Points with texture
particles-physics   → Gravity, wind, turbulence
particles-lifecycle → Continuous emission, recycling

连接方式：生命周期持续发射，物理处理下落和漂移，GPU 高效渲染。

爆炸（3 个技能）

particles-gpu       → Instanced or points rendering
particles-physics   → Radial velocity, drag
particles-lifecycle → Burst emission, fade + shrink

连接方式：生命周期成批生成粒子，物理施加向外的力并使其减速，GPU 处理缩放。

火/烟（3 个技能）

particles-gpu       → Custom shader with noise
particles-physics   → Upward force, turbulence
particles-lifecycle → Continuous emit, color gradient, size over life

连接方式：生命周期管理颜色/大小曲线，物理添加闪烁运动，GPU 使用混合模式渲染。

群集/鸟群（2-3 个技能）

particles-gpu       → Instanced mesh (if 3D shapes)
particles-physics   → Attractors, flow fields, separation
particles-lifecycle → (Optional) Population management

连接方式：物理通过行为力发挥主导作用，GPU 负责渲染。

魔法轨迹（3 个技能）

particles-gpu       → Points with glow shader
particles-physics   → Follow path, slight randomness
particles-lifecycle → Trail history, fade along length

连接方式：生命周期存储位置历史，GPU 使用 Alpha 渐变渲染。

彩纸（3 个技能）

particles-gpu       → Instanced flat planes
particles-physics   → Gravity, tumbling rotation, air resistance
particles-lifecycle → Burst emission, ground collision death

连接方式：物理处理逼真的下落，生命周期管理成批生成和清理。

决策表

效果类型	GPU 重点	物理重点	生命周期重点
星星/闪烁	点、静态	最少	闪烁（Alpha）
雪/雨	点、纹理	重力、风	持续、循环
火	着色器、混合	向上、湍流	颜色/大小曲线
爆炸	高数量	径向、阻力	成批生成、淡出
烟	柔和着色器	上升、卷曲	缓慢淡出、增大
群集	实例化	吸引器、场	生成/消亡
轨迹	线或点	路径跟随	位置历史
灰尘	小点	布朗运动	随机生成

粒子数量指南

数量	方法	技能优先级
< 100	简单，任意方法	lifecycle > physics > gpu
100 - 1,000	点或实例化	同等优先
1,000 - 10,000	侧重 GPU	gpu > physics > lifecycle
10,000 - 100,000	GPU 必不可少	gpu >> physics（着色器）> lifecycle
> 100,000	完全使用 GPU/计算	仅 gpu，物理在着色器中处理

技能依赖关系

particles-gpu (rendering foundation)
├── particles-physics (motion layer)
└── particles-lifecycle (management layer)

• particles-gpu 始终用于渲染
• particles-physics 和 particles-lifecycle 相互独立，但可以互补
• 对于简单效果，可以跳过物理或生命周期，极少同时跳过两者

回退行为

• 未知效果 → 从全部三个技能开始
• 性能问题 → 专注于优化 particles-gpu
• 运动问题 → 深入研究 particles-physics
• 生成/时序问题 → 专注于 particles-lifecycle

快速决策流程图

User Request
     │
     ▼
┌─────────────────────────┐
│ Rendering particles?    │──Yes──▶ particles-gpu (always)
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ Movement/forces needed? │──Yes──▶ + particles-physics
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ Birth/death/emission?   │──Yes──▶ + particles-lifecycle
└─────────────────────────┘
     │
     ▼
Most effects need all 3 skills

效果配方

快速入门模板

效果	从以下内容开始
氛围尘埃	gpu（点）+ lifecycle（持续）
按钮闪光	gpu（点）+ lifecycle（爆发、淡出）
角色轨迹	gpu + lifecycle（轨迹）
天气	三者全部
魔法咒语	三者全部
数据可视化	gpu + lifecycle

与其他领域集成

组合对象	用例
shader-noise	湍流运动、有机形状
shader-effects	粒子上的辉光、色差
r3f-performance	优化、剔除、LOD
gsap-fundamentals	脚本化粒子动画
audio-reactive	音乐驱动的粒子效果

参考

有关详细模式，请参阅各个技能文件：

• /mnt/skills/user/particles-gpu/SKILL.md
• /mnt/skills/user/particles-physics/SKILL.md
• /mnt/skills/user/particles-lifecycle/SKILL.md