mcpField
A
audio-router

audio-router

github.com/bbeierle12创意与媒体967 次安装1 天前更新
代码仓库

关于 audio-router

audio-router 是一个按音频需求将任务分配给三种专用技能的路由指南，面向音频播放、分析及音频驱动画面的开发。它根据请求信号选择技能，也列出组合使用方式。

主要功能

  1. 01按需求路由至三种技能
  2. 02依据关键词匹配任务
  3. 03支持组合多个音频技能
  4. 04提供任务决策表
  5. 05涵盖音频与视觉集成

适用场景

  1. 01为音频播放器选择技能
  2. 02规划频谱显示与节拍检测
  3. 03组合技能制作音频可视化
  4. 04将音频数据映射到视觉效果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill audio-router

安装后在 Claude Code 中输入/audio-router确认已加载。

附带文件_meta.json

详细介绍

音频路由器

根据音频需求路由到 3 个专用技能。

路由协议

  1. 分类 — 根据用户请求识别音频任务
  2. 匹配 — 应用以下信号匹配规则
  3. 组合 — 音视频项目需要组合使用 2-3 个技能
  4. 加载 — 实现前读取匹配的 SKILL.md 文件

快速路由

第 1 层：核心技能
需求技能信号
播放音频、音乐、SFXaudio-playbackplay、load、music、sound、mp3、transport、player、loop
提取音频数据audio-analysisFFT、frequency、spectrum、amplitude、waveform、beat detection
视觉与音频的关联audio-reactivevisualizer、reactive、respond to audio、sync、pulse、beat-driven

信号匹配

主要信号

audio-playback：

  • “play audio”、“load music”、“sound effect”
  • “Tone.js”、“Player”、“transport”
  • “loop”、“crossfade”、“volume”
  • “schedule”、“timing”、“sync to beat”
  • “background music”、“ambient sound”

audio-analysis：

  • “FFT”、“frequency”、“spectrum”
  • “beat detection”、“amplitude”
  • “waveform”、“audio data”
  • “frequency bands”、“bass”、“treble”
  • “analyze”、“extract”、“measure”

audio-reactive：

  • “visualizer”、“audio reactive”
  • “respond to music”、“sync visuals”
  • “pulse on beat”、“frequency to color”
  • “music driven”、“audio visualization”
  • “bloom on bass”、“particles on beat”
置信度评分
  • 高（3 个以上信号） — 直接路由到匹配的技能
  • 中（1-2 个信号） — 路由时搭配辅助技能
  • 低（0 个信号） — 从 audio-playback 开始

常见组合

简单音频播放器（1 个技能）
audio-playback → Load and play audio files
音频可视化器（3 个技能）
audio-playback → Load and control audio
audio-analysis → Extract frequency/beat data
audio-reactive → Map data to visual properties
背景音乐（1-2 个技能）
audio-playback → Looping, crossfade, volume
audio-analysis → Optional: beat sync features
节拍同步动画（2-3 个技能）
audio-analysis → Beat detection
audio-reactive → Trigger animations on beat
audio-playback → Control playback

决策表

任务主要技能辅助技能
播放音乐文件playback-
循环播放环境音playback-
创建可视化器reactiveplayback + analysis
检测节拍analysisplayback
随低音脉动reactiveanalysis + playback
显示频谱analysisplayback
音效playback-
音频响应粒子reactiveanalysis + playback
音量表analysisplayback

与其他领域集成

与后期处理（postfx-*）集成
audio-analysis → Bass/high frequency data
audio-reactive → Mapping strategy
postfx-bloom → Audio-reactive glow intensity
postfx-effects → Audio-reactive chromatic aberration

音频驱动后期处理参数。

与粒子（particles-*）集成
audio-analysis → Beat detection, energy levels
audio-reactive → Emission rate mapping
particles-systems → Particle emitter configuration

节拍触发粒子爆发，能量控制速度。

与 GSAP（gsap-*）集成
audio-analysis → Beat detection
audio-reactive → Timeline control
gsap-sequencing → Beat-synced timeline

音频事件触发或控制 GSAP 时间线的播放位置。

与 R3F（r3f-*）集成
audio-playback → Audio context in React
audio-analysis → Data extraction
audio-reactive → Update Three.js objects
r3f-fundamentals → Scene/mesh setup

音频数据驱动 3D 场景属性动画。

与着色器（shaders-*）集成
audio-analysis → Frequency uniforms
audio-reactive → Uniform update strategy
shaders-uniforms → Pass audio data to shaders

FFT 数据作为自定义效果的着色器 uniforms。

工作流模式

可视化器开发
1. audio-playback → Set up player and audio context
2. audio-analysis → Configure analyzers and band extraction
3. audio-reactive → Map frequencies to visual properties
节拍响应体验
1. audio-playback → Load audio
2. audio-analysis → Configure beat detection
3. audio-reactive → Define beat response animations
氛围音景
1. audio-playback → Looping players, crossfade
   (Single skill usually sufficient)

时间坍缩技术栈

用于新年倒计时音频体验：

audio-playback → Cosmic ambient loop, countdown ticks, celebration
audio-analysis → Beat detection, bass/mid/high extraction
audio-reactive → Map to bloom, particles, digit glow, vignette

主要功能：

  • 背景宇宙氛围音频（循环播放）
  • 每秒播放一次滴答声（最后 10 秒逐渐增强）
  • 节拍检测用于触发粒子爆发
  • 低音 → 泛光强度
  • 高频 → 色差
  • 倒计时归零时播放庆祝音乐

快速参考

任务 → 技能
任务所需技能
“播放背景音乐”playback
“循环播放环境音”playback
“在曲目间交叉淡化”playback
“显示频谱”analysis + playback
“检测音乐中的节拍”analysis + playback
“让视觉效果响应音频”reactive + analysis + playback
“让元素随节拍脉动”reactive + analysis
“音频响应泛光”reactive + analysis
“在事件发生时播放音效”playback
音频库快速参考
库使用场景
Tone.js完整的音频合成、分析和效果处理
Howler.js简单播放、精灵音效、移动端
Web Audio API底层、自定义处理
常见频段
频段范围视觉用途
亚低音20-60 Hz深沉脉冲、隆隆声
低音60-250 Hz尺度、强度、节拍
中低音250-500 Hz背景运动
中音500-2000 Hz整体能量
中高音2000-4000 Hz细节、闪光
高音4000+ Hz闪烁、像差

回退行为

  • 没有指定信号 → 从 audio-playback 开始
  • 提到“可视化器” → 完整技术栈：全部三个技能
  • “对音乐做出反应” → audio-reactive + audio-analysis
  • 仅播放音频 → 仅使用 audio-playback
  • 性能方面的顾虑 → 着重优化 audio-analysis

性能优先级

性能至关重要时：

  1. audio-analysis — 使用较小的 FFT 大小（64-128）
  2. audio-reactive — 应用平滑处理以减少抖动
  3. audio-playback — 预加载音频，重复使用播放器

评论

支持 Markdown