用途 sfx 用于管理创作者自己的音效（SFX）库，服务于视频剪辑流程。它不提供内置音效，仓库不附带任何声音；素材库属于创作者本人，存放于 biblioteca/sfx/<category>/*.wav，并要求归一化为 48 kHz、起音位于第 0 个采样点、峰值 −1 dBTP，同时配合 biblioteca/sfx/catalogo.json 目录文件。每个源文件都需在 biblioteca/LICENCIAS.md 中登记许可证信息。
主要能力 一是添加素材。仅接受许可证明确的音效：创作者自己的录音、CC0，或创作者持有的许可证。不得从无许可证的网站下载；Freesound 只限 CC0，且需由创作者本人下载并记录其 URL。原始文件放入项目内某个文件夹（例如 biblioteca/sfx/_originales/propios/），原始文件只读取、不修改。使用 seleccion.json 记录来源、文件夹、许可证与每个文件的类别。若文件名无法判断内容，可向创作者询问：短点击声对应 clic/toque，气泡感对应 burbuja/pop，气流声对应 whoosh，长音或搞怪音对应 especial。 二是编目。运行 npx tsx herramientas/sfx/catalogar.ts --sin-red 进行归一化、生成 ±1 半音变体并写出目录；未在 seleccion.json 中列出的文件会被报告并排除。可选从 Kenney（kenney.nl）获取免费 CC0 音效包：不带 --sin-red 运行时下载并校验；其 drop/pluck/tick 需创作者试听 out/f3-sfx/hoja-pop.wav 并用 --aprobar-pop=1,4,7（或 =ninguno）确认后才计为 pop。 三是为某次剪辑挑选音效。使用 npx tsx herramientas/sfx/elegir.ts --edicion proyectos/<slug>/edicion-vN.json --salida proyectos/<slug>/edicion-v(N+1).json。仅在最终渲染版本加 --guardar-historial，以避免跨视频重复。规则包括：最近 5 个带音效事件中不出现同一文件或其变调版本；同一类别不连续超过 2 次；部分层保持静音；音效在画面出现前后 0–2 帧内开始。 四是复查。运行 npx tsx herramientas/sfx/catalogar.ts --solo-revisar 统计各类别源文件数量，某类别需 ≥5 个才能进入事件映射；库为空或过小时应明确说明，导演会减少或不用音效。
使用方式与配置 交互语言遵循 creador.json 的 idioma（es/en）。来源限制由 creador.json 的 sfx.solo_fuentes 控制：为空表示目录中所有来源；["propios"]（即 seleccion.json 中写的 fuente）表示仅限创作者自有素材。elegir.ts 的 --solo-fuente a,b 或 --todas-las-fuentes 可在单次运行中覆盖该设置，扩大范围前应先询问。
适用场景与限制 适用于需要自有、授权清晰、可追溯来源的音效库管理，以及为系列视频挑选不重复音效的剪辑工作。限制包括：仓库不含任何音效；不接受许可证不明确的素材；原始文件不得修改；类别需达到一定数量才能参与事件映射；库过小时可用音效数量有限。