JSON 内容：歌词、可视化、DSP、语言包

主题和插件之外，四类内容主要改 JSON，入口都在 content/。索引 → 创意工坊 SDK。

歌词场面（lyrics-style）

宿主拥有所有 UI 槽位；你用 JSON 描述布局与样式，把官方 slot 摆到场景里。

1. 新建：

   node .\bin\echo-workshop-sdk.mjs init .\cinema --recipe cinema-lyrics
   cd .\cinema

2. 编辑 content/lyrics-style.json 的 scene 树：type: "slot" + slot: "title" 等。
3. 若 hostChrome.miniPlayer 设为 hidden，场景里必须有 play-toggle（及通常的 prev/next）。
4. npm run set -- --style cinema 或 --background cover-blur 改常用项。
5. npm run check → npm run dev 看 fixture 预览。

常用 slot：

slot	含义
cover	封面
title / artist / album	标题、歌手、专辑
lyrics / current-line / previous-line / next-line	歌词区
translation	译文
progress / seek-bar / time-current / time-duration	进度与时间
spectrum	频谱条
play-toggle / previous-track / next-track	播放控制
volume-slider / shuffle-toggle / repeat-cycle / like-toggle	其它控制

Preset：editorial（默认网格）、compact、cinema、cover。详情：

node .\bin\echo-workshop-sdk.mjs guide lyrics

可视化（visualizer-preset）

1. init .\viz --recipe radial-visualizer（或 bars-visualizer / wave-visualizer）。
2. 编辑 content/visualizer.json：style 只能是 bars、wave 或 radial（没有 particles）。
3. 调色板 palette：1–8 个不重复 #rrggbb；barCount 范围 8–128。
4. npm run set -- --mirror 仅可视化项目可用（镜像频谱）。
5. npm run check — dev 页频谱是夹具，真频谱仍由 Audio Core 提供。

node .\bin\echo-workshop-sdk.mjs guide visualizer

DSP / 均衡预设（dsp-preset）

31 段频率布局由宿主固定，JSON 只描述增益曲线。

1. init .\eq --recipe vocal-eq（或 bass-eq，或 --preset flat）。
2. 编辑 content/dsp.json：每 band 含 frequencyHz、gainDb（-12..12）、q（0.1..12）、filterType。
3. preampDb 范围 -12..6。
4. 不要删段、不要改频率表；只做「人声略抬」「低频略收」这类保守预设。
5. npm run check → 用户在 ECHO 均衡器里选用（Steam 版需 Pro 等相关能力，以软件内为准）。

node .\bin\echo-workshop-sdk.mjs guide dsp

语言包（locale-pack）

给 ECHO 五套内置语言之外的字符串表，例如文言文。

1. init .\lzh --recipe wenyan-locale
2. 编辑 content/locale.json：按 key 填翻译；缺 key 回退到宿主内置语言（通常简体中文）。
3. 语言只存在于工坊包 JSON，不会改 ECHO 安装包本体。
4. npm run check

音频插件接入（audio-plugin-profile）

这不是 VST 本身，而是告诉用户如何在本机启用某厂商插件的 接入配置（厂商名、插件名、Class ID 等）。适合配合 Steam 创意工坊 里「音频插件接入」类条目。

node .\bin\echo-workshop-sdk.mjs init .\vst-help --kind audio-plugin-profile

按生成项目里的 CUSTOMIZE.md 填写说明字段。

三类 JSON 对比

类型	入口文件	用户在哪用
lyrics-style	lyrics-style.json	歌词页 / 场面切换
visualizer-preset	visualizer.json	播放器可视化样式
dsp-preset	dsp.json	均衡器预设
locale-pack	locale.json	语言设置（若宿主支持该 pack）

通用注意

• 改 JSON 后 npm run check，不要手改 echo.workshop.json 哈希。
• 列表 description 建议 ≥ 80 字；tags 用宿主配置的 Steam 标签（warning 时查 kinds / 质量报告）。
• 可视化 / 歌词 / DSP 在 dev 里看 fixture；最终效果仍以 Steam 版 ECHO 使用 后为准。

主题与 CSS → 主题教程。插件与联网 → 插件教程。