heshuren371/dsh-music-player-tui

README excerpt

dsh-music-player-tui DeepSeek Harness TUI 界面（dsh-tui）的本地音乐播放器插件。输入 /music 打开全屏「音乐」场景（与 /trace 轨迹场景同款机制），在终端里边聊边听歌。 A local music player plugin for the dsh-tui terminal front door — /music opens a full-screen scene (same machinery as the /trace trajectory scene) so you can listen while you chat. 快速安装 / Quick Install 前置条件：已安装并能运行 dsh-tui （≥ 0.8，首次运行会自动初始化 profile）。 重启 dsh-tui ，输入 /music 回车——全屏场景出现即成功。想锁定版本： github:heshuren371/dsh-music-player-tui v0.2.0 。 建议再装个 mpv（ brew install mpv ）：无缝暂停、即时音量/seek、精确进度，听感最好；没有也不影响使用（自动回退 ffplay/afplay）。 功能 / Features - 📁 本地目录递归扫描： flac / mp3 / m4a / aac / ogg / opus / wav ，内嵌标签解析（缺省回退「歌手 - 歌名」文件名约定） - 🎵 曲目列表：歌名、歌手、时长；↑/↓ 或 j/k 选择，窗口随终端高度自适应 - 🔀 排序：歌名 / 歌手 / 时长，升降序切换； 播放顺序 = 可见列表顺序 （排序/搜索后，「下一首」就是你看到的下一行） - 🔍 搜索过滤：歌名 / 歌手 / 文件名 - 🔁 循环模式：列表循环 / 单曲循环 / 播完即停 - ⏩ 快进快退：←/→ ±5s（Shift ±30s）；音量 +/- 调整（每次 5%）——mpv 后端下即时生效、无接缝 - ⏯️ 退出场景音乐不中断 ：播放进程由宿主 spawn，关掉场景照样唱，随时 /music 回来 - 🗑️ 删除曲目：场景内 x 二次确认（本地文件一并删除，不可恢复），或 /music delete （需唯一匹配） - 💾 状态持久化：目录 / 音量 / 循环模式 / 最后播放曲目与进度（ lib/state.json ），重启后曲目以暂停态 cue 在原位置 - 🎛️ /music 子命令直达： dir / play [关键词] / pause / next / prev / vol / refresh / delete ，不进场景也能操控 - 🧩 标准 bundle 插件：零核心改动，进插件清单，卸载即净 播放后端 / Playback b…

Category