可视化与 DSP 预设

两类都是 纯 JSON，不改代码。概览 → JSON 内容。本页讲怎么调参、怎么 preview。

可视化 preset

新建

node .\bin\echo-workshop-sdk.mjs init .\viz-radial --recipe radial-visualizer
node .\bin\echo-workshop-sdk.mjs init .\viz-wave --recipe wave-visualizer
node .\bin\echo-workshop-sdk.mjs init .\viz-bars --recipe bars-visualizer
cd .\viz-radial

或拷贝示例：example visualizer-radial .\viz

`visualizer.json` 字段

{
  "type": "echo-workshop-visualizer-preset",
  "schemaVersion": 1,
  "id": "echo.harbor-visualizer-radial",
  "title": "Harbor Radial",
  "style": "radial",
  "palette": ["#66ccff", "#c48bff", "#f0b35b"],
  "barCount": 72,
  "smoothing": 0.7,
  "sensitivity": 1.35,
  "decay": 0.36,
  "mirror": false
}

字段	范围 / 说明
`style`	仅 `bars` · `wave` · `radial`（无 `particles`）
`palette`	1–8 个不重复 `#rrggbb`
`barCount`	8–128
`smoothing` / `sensitivity` / `decay`	0–2 左右，听感微调
`mirror`	是否镜像频谱（bars 常用）

CLI 快捷：

npm run set -- --style wave
npm run set -- --mirror
npm run add -- --color "#66ccff"

调参建议

目标	可试
更灵敏	略增 `sensitivity`，略减 `smoothing`
更「懒」的频谱	增 `smoothing`、增 `decay`
更密的长条	增 `barCount`（注意性能）
品牌色	2–3 色 palette，避免 8 色全用上

dev 里的预览是 fixture 数据，真歌频谱仍由 Audio Core 实时算；发布后在 ECHO 播放器里选你的可视化验证。

DSP / EQ preset

新建

node .\bin\echo-workshop-sdk.mjs init .\eq-vocal --recipe vocal-eq
node .\bin\echo-workshop-sdk.mjs init .\eq-bass --recipe bass-eq
# 平坦起点：--kind dsp-preset --preset flat

示例：example dsp-vocal .\eq

31 段规则（硬性）

频率表由宿主固定，不能增删 band 或改 frequencyHz 集合
每 band：gainDb -12..12，q 0.1..12，filterType 如 peaking
preampDb：-12..6（整体预增益，小心削波）

npm run set -- --preamp -4
npm run set -- --bars 72

（visualizer 的 --bars 是 barCount；DSP 项目里 set 含义以 guide dsp / 项目 kind 为准。）

听感取向（保守为先）

preset 思路	做法
人声向前	1–4 kHz 窄 Q 小幅提升，低高频略削
低频收紧	60–120 Hz 小幅衰减，避免轰头
平坦参考	`flat` preset 全 0，只调 preamp

JSON 只是预设文件；用户选用后由 Audio Core / native host 执行，不是插件改 buffer。

均衡能否用、是否与 Pro 功能绑定，以 ECHO 软件内说明为准。工坊条目只负责提供预设曲线。

验证

npm run check — band 数量与频率必须符合官方表
npm run dev — fixture 预览曲线形状
发布后用熟悉曲目 A/B 对比（低音量先听）

对比一览

	可视化	DSP
文件	`visualizer.json`	`dsp.json`
用户在哪选	播放器可视化样式	均衡器预设
宿主限制	3 种 style	31 段固定频率
recipe	`*-visualizer`	`vocal-eq` / `bass-eq`