# 音乐播放器

> 提供 Apple 级质感的音乐播放体验，支持歌单管理、拖拽重排与状态同步。

- Skill: `helloeveryboby/skill-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add helloeveryboby/skill-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/helloeveryboby/skill-4/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: helloeveryboby (https://skillmd.com/u/helloeveryboby)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/helloeveryboby/skill-4

---


# 音乐播放器技能 (MusicSkill)

本技能是 Butler 核心音乐功能的标准化接口，负责前端 UI 与后端 C++/Python 播放引擎之间的状态协调。

## 核心职责
1. **状态同步**：确保前端旋转光碟的状态与后端实际播放进度严格对齐。
2. **持久化排列**：当用户在前端完成拖拽重排后，立刻将 `new_id_list` 写入 `music_library.json`。
3. **播放控制**：封装底层的播放、暂停、切歌逻辑。

## 交互规范
- 前端通过 `ModernBridge` 调用本技能的 `update_order`。
- 本技能在状态变更时，通过事件总线通知全系统。