核心用法
mupibox-media-db 是一个命令行工具，用于管理 MuPiBox 音乐播放器的媒体数据库 (data.json）。通过 REST API 与后端交互，提供完整的 CRUD 操作：
- 查询：
list命令支持分页、类型过滤（spotify/youtube 等）、类别筛选（music/audiobook） - 添加：支持原始 JSON 输入或 Spotify URL 自动解析 ID，简化内容录入
- 删除：可按索引或 Spotify ID 精准移除条目
- 编辑：
set命令支持多字段批量更新，字段值接受标准 JSON 类型 - 排序：
move命令实现数据库条目重排 - 备份恢复：自动本地备份 + 手动恢复机制，防止误操作数据丢失
显著优点
1. 操作原子化：每次变更前自动创建时间戳备份，支持精确回滚
2. ID 智能解析：Spotify URL 自动提取专辑/曲目 ID，减少人工复制错误
3. 字段类型安全：--field 参数接受原生 JSON 值（布尔、数字），避免字符串污染
4. 工作流引导：Agent 模式提供标准化操作流程（查询→确认→执行→验证）
潜在局限
- 生态绑定：仅限 MuPiBox 系统使用，无法迁移至其他媒体平台
- 网络依赖：所有操作需实时连接后端 API，离线无法使用
- Spotify 中心化：深度优化 Spotify 场景，其他源（YouTube）支持相对基础
- 无图形界面：纯 CLI 工具，对非技术用户存在门槛
适合人群
- MuPiBox 家庭用户需要批量整理有声书/音乐库
- 智能家居管理员维护多房间音频内容
- 开发者调试或初始化 MuPiBox 实例
常规风险
| 风险项 | 等级 | 说明 |
|--------|------|------|
| 误删数据 | 中 | 虽有备份，但恢复需手动执行命令 |
| API 未授权访问 | 低-中 | 依赖 MuPiBox 网络安全配置，脚本本身无认证机制 |
| Spotify ID 冲突 | 低 | 重复添加相同 ID 可能导致播放列表异常 |
| 备份文件堆积 | 低 | 频繁操作会产生大量时间戳备份，需定期清理 `~/.mupibox-db-backups/` |