3.0.42
3.0.42 发布说明
变更
由提交历史按类型自动生成:新功能 / Bug 修复 / 优化·重构·依赖 / 文档 / 其他。
变更日志 (v3.0.41..v3.0.42)
优化 / 重构 / 依赖
- 01eab78 chore: 修正两处名不副实的 CI 文案 + 一处与实现相反的代码注释
- 8c0f196 refactor(daily-recommend): 清掉旧表/旧设置兼容代码(自用项目,不考虑向后兼容)
文档
- 592451f docs: 全仓文档时效性修订(校准数字 / 纠错 / 标注历史快照)
涉及文件与影响面
.github/workflows/ci.yml | 2 +-
AUDIT.md | 2 +
CHANGELOG.md | 30 +++++
CONTRIBUTING.md | 26 +++-
README.md | 16 ++-
SPEC.md | 31 +++--
backend/package.json | 2 +-
backend/scripts/check-builtins.mts | 7 +-
backend/src/db/index.ts | 9 --
backend/src/services/plugin/dailyRecommend.ts | 73 ++---------
docs/API.md | 6 +-
docs/DEVELOPER.md | 118 +++++++++++++++---
docs/PLUGIN_ARCHITECTURE.md | 23 +++-
docs/PLUGIN_DEV.md | 25 ++--
docs/PROCESS_MODEL_AND_ISOLATION_PLAN.md | 134 +++++++++++++--------
docs/SENDSPIN_ESPHOME_FLAC_2026-09-17.md | 2 +
docs/SENDSPIN_MA_ALIGNMENT_AUDIT.md | 2 +
docs/SENDSPIN_MULTIROOM_STREAMING_PLAN.md | 6 +-
docs/SENDSPIN_PITFALLS_2026-09-18.md | 2 +
docs/memory-optimization-plan.md | 7 ++
docs/player-unification-plan.md | 18 +--
docs/sandbox-limits-and-plan.md | 20 +--
docs/sendspin-renderer-handoff-2026-09-13.md | 2 +
.../2026-08-05-dlna-ma-style-player-controller.md | 2 +
.../plans/2026-09-12-sendspin-renderer.md | 2 +
.../specs/2026-09-12-sendspin-renderer-design.md | 2 +
frontend/src/stores/player.ts | 7 +-
27 files changed, 376 insertions(+), 200 deletions(-)
镜像
- ghcr.io/ray5378/musicflow:3.0.42 (Docker Hub 同步: ray5378/musicflow:3.0.42)
升级步骤
1. 服务端
- Docker / 容器:
docker compose pull && docker compose up -d - HA 加载项:点「更新」后重启加载项
2. Web 前端
- 浏览器
Ctrl + Shift + R强刷一次,清掉旧的静态资源与卡片缓存
3. 客户端配套版本
- 本次未改动客户端契约,无需同步升级;当前 client 最新 v5.0.15(Android apk / Windows setup)
可直接配用。
4. 预览面板 / 功能开关
- 本次无新增预览面板与功能开关。
本版为「清理 + 文档修订」版,无新功能。
- 删除每日推荐里最后的旧设置兼容分支(
loadCandidatesFromSettings/ 旧歌单认领 / 旧歌单改名,
以及daily_recommend_candidates、daily_recommend_retention两个 settings 种子键)。
这两个键已无任何代码读取,老库里留存无害、无需清理;候选池现在只由每日推荐插件自己的
配置承载,PUT /v1/daily-recommend/candidates的对外行为不变。- 全仓文档时效性修订:校准硬数字、修正 4 处与实现相反的描述(含 1 处代码注释)、
给 3 份方案文档回标落地状态、为 8 份历史文档加「⏳ 历史快照」横幅。- 数据无需迁移:本版不增删任何表结构,也不依赖任何旧字段。