mokimoko/SillyTavern-DynamicAudioRedux

# Dynamic Audio Redux 一个 [SillyTavern](https://github.com/SillyTavern/SillyTavern) 扩展，提供能对聊天内容做出反应的背景音乐。根据情绪选择曲目，用 AI 为你的音乐库添加标签，从对话中生成播放列表，或者干脆让它随机播放你拥有的任何音乐。 基于 SillyTavern 团队原有的 [Dynamic Audio](https://github.com/SillyTavern/Extension-DynamicAudio) 扩展开发——围绕单一的多标签页弹窗、AI 打标签和更智能的播放列表工具进行了重构。

## 功能 **三种播放模式** — 纯器乐（匹配情绪的背景音乐）、歌曲（任何音乐，可选择按情绪过滤）或播放列表（基于标签的智能播放列表或手动精心挑选的播放列表）。 **AI 自动打标签** — 将其指向未添加标签的曲目，让 LLM 为其添加情绪和元数据标签。支持每次批量处理 10/15/20 首曲目，或者点击任意单行上的魔杖图标进行单次打标签。保存前可预览和编辑。 **从对话生成播放列表** — 根据当前场景生成智能播放列表。AI 会读取最近的消息，从你的音乐库中挑选曲目，或者生成基于标签的播放列表，引入符合氛围的任何曲目。 **可拖拽的迷你播放器** — 紧凑的浮动小部件，可放置在屏幕上的任何位置。可选贴边吸附。不会干扰 ST 的侧边栏和弹窗。 **音频库弹窗** — 主要的 UI。一个多标签页弹窗，包含实时正在播放控件、带有搜索和过滤功能的完整曲目库、带有双栏拖拽排序编辑器的播放列表管理功能，以及偏好设置。 ## 安装说明 使用 SillyTavern 内置的扩展安装程序： 1. 打开 **Extensions** → **Install Extension** 2. 粘贴此 URL： https://github.com/chatelainedev/SillyTavern-DynamicAudioRedux 3. 点击 **Install**，如果提示则重新加载 ## 设置 1. 将音乐文件添加至： - `data//assets/bgm/` — 全局曲目（随处可用） - `data//characters//bgm/` — 特定角色的曲目 - `data//user/files//` - 你想要的任何自定义文件夹，支持嵌套 2. 从扩展菜单（🎧 图标）打开 **Audio Library**，然后点击 **Scan**（或对自定义文件夹使用 Folder Import） 3. 为你的曲目打标签 — 手动打标签（任意行上的铅笔图标），或者点击 **Auto-Tag** 进行 AI 批量打标签 4. 在 Playback 标签页中开启音频，并选择一种模式 ## 曲目打标签 点击任意曲目上的编辑图标进行设置： - **标题** — 自动清理文件名中的“Official Music Video”等冗余信息 - **Instrumental** 标记 — 区分带人声的曲目和纯背景曲目 - **情绪** — 喜悦、悲伤、愤怒等（驱动匹配情绪的播放） - **自定义标签** — 任何你想要的自由内容。供智能播放列表使用。 ## 播放列表 **智能播放列表** — 基于标签。添加任何情绪标签、角色名、剧情标签（`arc:revenge`）或自由描述符的组合。匹配标签的曲目将被自动引入。 **手动播放列表** — 精心挑选。双栏编辑器：左侧为可用曲目，右侧为你的选择。点击在两栏之间移动，拖拽手柄进行重新排序。 **从对话生成** — AI 根据当前对话生成。选择要包含的最近消息数量，让其挑选曲目或生成匹配的标签。 ## 斜杠命令 ``` /d-audio on / off # Enable or disable /d-audio skip / prev # Transport /d-audio library # Open the Audio Library modal /d-audio scan # Rescan for new tracks /d-audio migrate # Re-link metadata after renaming files /d-audio status # Print all current settings /d-audio nowplaying # Print the current track name /d-audio mode=instrumental # Switch modes (instrumental / songs / playlist) /d-audio playlist="Chill" # Switch to a specific playlist /d-audio autoswitch=on # Auto-switch on emotion changes /d-audio shuffle=on /d-audio loop=on /d-audio volume=75 /d-audio "track name" playlist="Favorites" # Add a track to a manual playlist ``` 通过将其留空，可以获取任何设置的当前值：`/d-audio mode=`、`/d-audio volume=` 等。 ## 注意事项 - 标签匹配是模糊的，因此诸如 `Alice` 或 `revenge` 这样的日常标签会拉取带有这些术语的曲目，无论它们是手动设置的还是自动打标签的。 - 当你在 SillyTavern 外部重命名音频文件时，`migrate` 命令非常有用——它会尽可能将旧的元数据重新链接到新的文件名。 - Debug 模式（Preferences 标签页）会将检测信息记录到浏览器控制台。 ## 致谢 SillyTavern 团队开发的原始 [Dynamic Audio](https://github.com/SillyTavern/Extension-DynamicAudio) 扩展。

标签：AI打标, SillyTavern, 多模态安全, 扩展插件, 播放器, 数据可视化, 背景音乐, 自定义脚本