[pyss56]

概述

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

主要变更

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 歌单立即刷新，回滚「我不喜欢」后过滤规则立即生效。

🎯 核心变更

本次 PR 合并上游改动，并增强快照管理、恢复和备份能力。用户可按类型筛选歌单与「我不喜欢」快照，并恢复对应数据；恢复后会清理相关缓存。

📝 主要改动点

• 增加「我不喜欢」快照的列表、读取、下载、删除和恢复支持。恢复接口 /api/data/restore-snapshot 根据 kind 选择快照类型。
• 快照写入时支持本地备份和云端同步；删除时清理对应本地副本。配置备份支持按小时设置周期和锚点时间，并清理过期配置备份及快照副本。
• OpenList 备份增加系统配置、用户数据和歌单快照处理，支持批量重试、记录筛选和快照类型展示，并调整 upload-delete 的保护规则。
• 更新备份管理页面、快照筛选和记录详情展示；启动日志增加应用版本号。
• Docker 工作流增加 dev 和 main 分支推送触发，并调整 GHCR 登录和镜像标签配置。

⚠️ 影响与注意事项

• 移除 openlist.keepLocalAfterUpload 配置项。未指定 OpenList 条目模式时，默认使用 upload。
• upload-delete 不会删除受保护的系统配置、用户数据和歌单快照。
• 缓存失效作用于服务端内存；多实例部署需要跨实例同步缓存失效。
• 当前 PR head 的 CI、构建和测试结果：not available。

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

本次变更增加配置备份周期和状态管理，扩展歌单与不喜欢快照的保存、恢复和筛选，并调整 OpenList 备份策略及记录操作。Docker 工作流改为面向 GHCR 的分支构建。另有 Subsonic 配置默认值、沙箱控制台调用和启动版本日志调整。

Changes: 配置自动备份

Layer / File(s)	Summary
配置项与接口字段 src/types/config.d.ts, src/types/app.d.ts	新增备份周期、时间锚点和备份状态字段。
备份执行与清理调度 src/index.ts	配置备份按小时周期槽位执行；过期清理使用独立的每日定时器。
配置接口与管理页面 src/server/server.ts, public/app.js, public/index.html	服务器校验备份设置并返回备份状态；页面提供周期、时间锚点及上次和下次备份时间。

快照存储与恢复

Layer / File(s)	Summary
本地快照副本与目录 src/index.ts, src/modules/dislike/snapshotDataManage.ts, src/user/index.ts, src/utils/backupPolicy.ts	配置备份目录保存和清理快照副本。不喜欢快照目录支持路径更新、文件迁移及外部目录映射。
快照保存与元数据 src/modules/list/snapshotDataManage.ts, src/modules/dislike/snapshotDataManage.ts	保存歌单或不喜欢快照时触发可选的云端同步和本地备份；不喜欢快照增加元数据操作。
不喜欢快照恢复与缓存失效 src/modules/dislike/dislikeDataManage.ts, src/modules/dislike/manage.ts, src/server/integrations/subsonic.ts, src/server/server.ts	恢复接口按类型读取或恢复快照，并使对应缓存失效；删除接口可处理两类快照。
快照列表与类型操作 public/app.js	页面支持按类型筛选、下载和恢复快照。不喜欢快照下载为原始规则数据。

OpenList 备份与记录

Layer / File(s)	Summary
本地保留与上传模式 src/defaultConfig.ts, src/types/config.d.ts, src/server/openlistBackup.ts	移除全局本地保留配置。系统、数据和歌单类型不使用上传后删除模式。
快照、系统配置与存量文件同步 src/server/openlistBackup.ts	同步流程增加快照备份、系统配置历史副本和存量文件回填。
服务端配置、回填与批量重试 src/server/server.ts	符合条件的 OpenList 规则会触发存量回填；新增管理员批量重试接口。
记录分类、筛选与操作 public/app.js, public/index.html, public/style.css	记录页面增加分类、快照类型筛选、批量重试和详情展示；更新页面说明、表格及导航样式。

Docker 发布工作流

Layer / File(s)	Summary
分支构建与镜像发布 .github/workflows/docker.yml	工作流新增 dev 和 main 分支 push 触发器，使用 GHCR 凭据，并按分支设置镜像标签。

Subsonic 启动配置

Layer / File(s)	Summary
独立模式默认值 src/index.ts	未显式设置独立模式且 Subsonic 端口大于零时，配置合并逻辑将独立模式设为启用。

调试控制台调用

Layer / File(s)	Summary
沙箱控制台调用 src/server/sources/userApi.ts	rawSandboxConsole.dir 改为通过类型断言调用 console.dir。

启动版本日志

Layer / File(s)	Summary
启动版本信息 src/server/server.ts	服务器启动时记录应用版本；无法读取版本时记录 unknown。

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

Change: Feature

Sequence Diagram(s)

sequenceDiagram
  participant App as 管理页面
  participant Server as 快照 API
  participant DislikeManage as 不喜欢快照管理器
  participant SnapshotStore as 快照存储
  participant Cache as 播放列表缓存

  App->>Server: 提交快照 ID 和 kind
  Server->>DislikeManage: 按 kind 请求恢复
  DislikeManage->>SnapshotStore: 读取指定快照
  SnapshotStore-->>DislikeManage: 返回快照数据
  DislikeManage-->>Server: 恢复规则并更新快照状态
  Server->>Cache: 使对应缓存失效
  Server-->>App: 返回恢复结果

Loading

Possibly related issues

• [Feature] 自动播放列表不优先取缓存问题 #490：本次变更在符合条件的 upload-delete 规则下启用 OpenList 优先播放，但提供的信息不足以确认其实现了该问题涉及的缓存取回行为。

Suggested reviewers: xcq0607

Merge Risk: High · up to 4bcd0

This change can delete local music files without confirming the cloud copy still exists, can wipe or lose "dislike" rules during restore or directory changes, may spin in a backup loop for long intervals, forgets backup schedule settings after restart, and the image workflow can overwrite or delete published images. These should be fixed before merging.

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

Tip

🎯 Customize your risk assessments

Guide how CodeRabbit assesses merge risk and security architecture risk. Highlight sensitive changes and explain your security boundaries using Merge Risk Instructions and Security Risk Instructions in your review settings. Security architecture risk assessments require the Advanced plan or above.

✅ Automatic approvals, with your rules

Let CodeRabbit approve pull requests once required threads are resolved, pre-merge checks pass, and your risk limits are met. Enable Automatic approvals in review settings, with overrides for teams or file paths.

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]

已由 #507 替代：本 PR 移除了 fork 私有的 GHCR/CI 配置（.github/workflows/docker.yml），新 PR 已基于干净分支 pr-upstream-clean 提交，欢迎 review。