[pyss56]

概述

本 PR 将上游 XCQ0607/dev 的最新提交合并进本 fork 的 dev，并在此基础上补入备份管理、回滚与缓存一致性增强。合并过程仅 public/js/config.js 一处版本号冲突，已按上游版本号对齐（v2.1.4）。

注：本 PR 已排除 .github/workflows/docker.yml（fork 私有的 GHCR/CI 配置，未纳入上游），以避免强加上游不兼容的构建/推送配置与密钥引用。

主要变更

1. 备份管理页 — 歌单快照类型展示与筛选

• 快照列表每条新增类型角标：蓝色「我的歌单」/ 红色「我不喜欢」，便于一眼区分。
• 查询条件由快捷标签改为「全部类型 / 我的歌单 / 我不喜欢」下拉筛选（元素 #snapshot-kind-filter），按 kind 字段过滤快照。
• 修复类型标签此前被 .col-id 的 text-overflow: ellipsis 截断不可见的问题：.col-id 改为 flex 布局，ID 文本单独省略号截断，kind-tag 固定显示（桌面与移动端均已调整）。

2. 「我不喜欢」快照支持回滚

• 此前回滚接口仅支持歌单（list）数据。现已补齐 dislike 回滚完整链路：
  • dislikeDataManage.restore(data)：从指定快照内容恢复当前 dislike 规则。
  • DislikeManage.restoreSnapshot(name)：取快照 → restore → clearClients() + setLatest()（在 DislikeSnapshotDataManage 中补齐 clearClients / setLatest 方法）。
  • 后端 /api/data/restore-snapshot 接收 kind 参数，按 list / dislike 分流调用对应恢复逻辑。
• 前端「我不喜欢」快照记录区复用歌单回滚按钮与确认流程（同一提示文案），无需重复实现。

3. 回滚后主动失效派生缓存（缓存一致性）

• 回滚成功后按类型失效对应派生缓存，避免旧数据在缓存 TTL 内继续被返回：
  • list 回滚 → 新增 invalidateSubsonicPlaylistCache()（subsonic 模块导出）：清空 playlistDetailCache（原 10 分钟 TTL）、playlistRadioCache、sharedPlaylistCoverCache、leaderboardCoverCache，消除 Subsonic API 最长 10 分钟的陈旧歌单窗口。
  • dislike 回滚 → 调用已有的 invalidateDislikeCache(username)，消除「过滤不喜欢」最长 30 秒陈旧。
• 说明：缓存失效为服务端内存级，当前单实例部署完全生效；若多实例横向扩展则需改为跨实例广播失效。

4. 其它 UI / 可观测性优化

• 启动日志打印当前版本号：LX Music Server version: vX.Y.Z（读取 package.json），便于通过 docker logs 确认实际运行版本。
• 记录详情弹窗：补齐缺失的 .olb-detail-table / .olb-detail-key / .olb-detail-val 样式，修复「更多」弹窗布局挤压；弹窗标题与名称列只显示文件名，hover 提示显示完整路径。
• 修复「我不喜欢」快照导出为空 playList_v2 的 bug。

版本号

config.js 与 package.json 版本号已对齐上游 v2.1.4，避免强加 fork 版本号。

验证

• 前端 node --check 语法校验通过；后端代码经 TypeScript 编译验证。
• 部署镜像后确认：快照列表类型标签正常显示、下拉筛选可用；回滚「我的歌单」后 Subsonic 歌单立即刷新，回滚「我不喜欢」后过滤规则立即生效。

🎯 核心变更

扩展快照管理与 OpenList 备份流程，新增不喜欢快照的列表、下载、恢复和删除支持，并在恢复后清理相关缓存。配置备份支持自定义周期和计划时间，同时补充本地快照备份及 OpenList 历史配置备份。

📝 主要改动点

• 快照管理： API 和管理页区分歌单与不喜欢快照，增加类型筛选和类型标识。不喜欢快照导出原始规则数据；恢复时按类型分流，并触发对应缓存失效。
• 配置备份： 新增备份间隔和计划时间配置，管理页显示下次及上次备份时间。快照保存时可创建带时间戳的本地副本，删除快照时清理对应副本。
• OpenList： 增加系统配置历史副本、歌单及不喜欢快照同步、批量重试和存量文件回填。upload-delete 保护系统配置、数据及快照记录；管理页新增记录分页签、类型筛选和详情入口。
• 界面与日志： 调整备份记录布局和时间显示，启动日志增加版本号。

⚠️ 影响与注意事项

• 移除 openlist.keepLocalAfterUpload 配置项。OpenList 未指定模式的记录默认使用 upload；配置为 upload-delete 时，删除范围限于符合条件的歌曲及附件。
• 配置备份默认间隔为 24 小时，默认计划时间为 00:00。
• 当前提供的差异结果未包含 CI、构建或测试的执行结果，验证状态不可用。

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

本次改动增加配置备份周期调度和本地快照副本管理，扩展歌单与不喜欢快照的备份、下载和恢复流程，并调整 OpenList 备份规则、记录筛选及批量重试界面。

Changes: 备份与快照管理

Layer / File(s)	Summary
配置备份调度与本地副本 src/types/config.d.ts, src/types/app.d.ts, src/index.ts, src/server/server.ts, public/index.html, public/app.js	配置备份新增周期小时数和时间锚点。服务端新增定时重设，并返回下次与上次备份时间。配置备份清理同时清理过期快照副本。
歌单与不喜欢快照生命周期 src/modules/dislike/*, src/modules/list/snapshotDataManage.ts, src/server/server.ts, src/server/integrations/subsonic.ts, src/user/index.ts, src/utils/backupPolicy.ts, public/app.js	不喜欢快照新增恢复、目录更新、文件迁移和元数据管理。歌单与不喜欢快照接入本地备份及快照 API；界面支持按类型筛选、下载和恢复。
OpenList 备份规则与同步 src/server/openlistBackup.ts, src/server/server.ts, src/defaultConfig.ts, src/types/config.d.ts	移除 openlist.keepLocalAfterUpload。系统配置、数据和快照类型受上传后删除保护。同步增加快照备份、系统配置历史副本和存量文件回填。
备份记录与管理界面 public/app.js, public/index.html, public/style.css, src/server/server.ts	OpenList 记录页按媒体、系统配置和快照分类，并增加筛选、详情与批量重试。快照记录可区分歌单和不喜欢类型。相关时间显示改为中文 24 小时制。

运行时调整

Layer / File(s)	Summary
配置与运行时兼容调整 src/index.ts, src/server/server.ts, src/server/sources/userApi.ts	配置未显式设置 subsonic.standalone 且端口大于零时，合并后的配置将其设为开启。启动日志增加版本号；调试目录输出改用类型转换后的 console 调用。

Estimated code review effort: 4 (Complex) | ~60 minutes

Change: Feature

Sequence Diagram(s)

sequenceDiagram
  participant SnapshotUI
  participant SnapshotAPI
  participant DislikeManage
  participant DislikeDataManage
  participant SnapshotDataManage
  participant SubsonicCache
  SnapshotUI->>SnapshotAPI: 提交快照 id 和 kind
  SnapshotAPI->>DislikeManage: 恢复指定不喜欢快照
  DislikeManage->>DislikeDataManage: 恢复 dislike 数据
  DislikeManage->>SnapshotDataManage: 清除客户端记录并设置最新快照
  SnapshotAPI->>SubsonicCache: 使不喜欢缓存失效

Loading

Possibly related PRs

• XCQ0607/lxserver#506：描述的改动集合与本次 PR 相同。
• XCQ0607/lxserver#488：引入本次改动所调整的 OpenList 备份模块和配置项。
• XCQ0607/lxserver#469：涉及与本次相同的侧栏样式及调试目录输出代码。

Suggested reviewers: xcq0607

Merge Risk: Moderate · up to 0003d

The new backup and snapshot features have several functional bugs. Deleting a "我不喜欢" snapshot reports success but keeps the file, and a restored snapshot can later be cleaned up, losing the rules after a restart. Long backup intervals can make the scheduler spin, and some OpenList records are hidden or stay pending. These should be fixed before merge.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

[pyss56]

已重新整理提交：本 PR 现基于 upstream/dev 干净基底，提交历史不再含「改了又改回」的噪音，且排除了 fork 私有的 GHCR/CI 配置（.github/workflows/docker.yml）。请重新 review。

[pyss56]

本 PR 已关闭，由 #508 替代。

原因：本 PR 的 head 分支 pr-upstream-clean 在整理提交时被删除，且其中混杂了 fork 私有的 CI / GHCR 构建提交、版本号 bump 与临时合并提交，commit 历史不适合上游 review。

新 PR 改为基于 upstream/dev 的干净单 commit 分支 pyss56:upstream-pr：仅含通用功能改动，不含 .github/workflows/docker.yml 变更、不含任何版本号改动。