Pr/cleanfix: 落实 PR #365 CodeRabbit 评审(不喜欢鉴权/专辑契约/音质源配置等)

changelog.md

@@ -1,28 +1,36 @@
 # Changelog
 
-## v2.0.3 (2026-09-10)
+## v2.1.0 (2026-09-13)
 
 ### 🎨 管理后台 UI 现代化全面重构
 
 - **仪表盘全新设计**: 重构仪表盘页面，新增 CPU 与内存实时折线图，支持动态纵轴自适应与数值标注，数据卡片增加趋势指示与动效，整体视觉大幅升级。
-  - ![Dashboard UI](md/log/2.0.3-1.png)
+  - ![Dashboard UI](md/log/2.1.0-1.png)
 - **WebDAV 同步页面重设计**: 全面重构 WebDAV 同步视图，将操作入口整理为「云端存储协同」与「本地离线备份」两大分组卡片，新增同步状态与健康度面板、同步日志实时推送面板，操作流程更清晰直观。
-  - ![WebDAV UI](md/log/2.0.3-2.png)
+  - ![WebDAV UI](md/log/2.1.0-2.png)
 - **全局界面优化**: 统一各列表（用户管理、快照管理、数据查看等）的表格与卡片风格，升级系统日志工具栏（自动轮询开关、刷新按钮），移动端侧边栏布局更紧凑。
 
 ### 🌟 新增功能
 
 - **WebDAV 多阶段任务进度与实时日志**:
+
   - 全量备份支持多阶段进度展示（准备 → 打包 → 传输 → 完成），进度条实时联动文件名与上传速率。
   - 同步日志通过 SSE 实时推送，新日志自动推入并高亮，无需手动刷新。
   - 云端恢复支持弹窗选择「全量 ZIP 快照还原」或「散文件增量恢复」两种模式，并可查看历史快照版本列表。
-
 - **WebDAV 传输性能优化**:
+
   - HTTP Keep-Alive 连接池复用，减少重复 TCP/TLS 握手开销。
   - 文件流缓冲区升级至 1 MB，ZIP 压缩等级调优至 level 4（打包速度提升约 3～4 倍）。
   - 散文件并发上传提升至 8 线程，自动递归创建目录防 404，兼容坚果云/群晖/Alist/Nextcloud 等主流 WebDAV 服务。
-
 - **系统日志自动轮询**: 日志视图新增「自动轮询刷新」开关，激活后每 3 秒自动拉取并智能贴底跟随。
+- **不喜欢 (Dislike) 规则与管理全面升级 (#366 @pyss56)**:
+  - **前端可视化管理**: 支持在 Web 端直接管理“不喜欢”的歌曲、歌手和专辑，提供完整的规则解析、匹配、增删及缓存管理能力。
+  - ![Dislike Web UI](md/log/2.1.0-3.png)
+  - **自动剔除不喜欢歌曲**: 系统设置中新增了“播放时自动剔除不喜欢歌曲”开关，在替换播放队列时自动过滤被标记为“不喜欢”的内容（主动点击播放的除外）。
+  - ![Auto Filter Disliked](md/log/2.1.0-4.png)
+  - **精准匹配与联动**: 落实专辑维度契约 `{ albumName, singers }`，支持专辑名与歌手双校验；新增评分与不喜欢的双向联动；排行榜中增加“不喜欢”快捷操作。
+  - **Subsonic 配置与兼容性增强**: 完善前端配置，新增音质/音源优先级、客户端码率限制与推荐过滤，重构底层鉴权头合并和规则编解码（修复 `@` 分隔符问题），支持歌名后缀归一化，整体提升兼容性与交互体验。
+  - ![Subsonic Dislike and Quality Settings](md/log/2.1.0-5.png)
 
 ### 🔧 修复与优化
 
@@ -33,10 +41,10 @@
 ### 🌟 新增功能
 
 - **Subsonic 公开排行榜映射 (#348 @pyss56)**:
+
   - **在线排行榜暴露**: 在 Subsonic 协议中将各平台（如 QQ 音乐）的在线排行榜暴露为只读虚拟歌单，歌单统一归属于虚拟用户 `lxserver` 的公开歌单中，支持通过平台设置查看不同平台的榜单数据。
   - **设置项扩展**: 在系统设置中新增了独立的“开启公开排行榜映射”开关及“排行榜音源平台”配置，界面采用现代 Tag 标签单选交互，方便一键切换目标数据源。
   - ![Subsonic Leaderboard Settings](md/log/2.0.2-2.png)
-
 - **Subsonic 播放缓存能力** :
 
   - **播放时触发服务器缓存 (#339 @pyss56)**: 新增 `subsonic.cacheOnPlay` 独立开关，支持在通过 Subsonic 协议播放音乐时，在后台自动将曲目落盘至用户的缓存目录，已缓存的会自动跳过，极大增强离线体验。（注意：开启此项可能产生较大流量）
@@ -60,21 +68,26 @@
 ### 🔧 修复与优化
 
 - **播放列表回退逻辑修复 (#343)**:
+
   - **搜索与歌单列表回退 UI 刷新**: 修复了在关闭“播放时切换歌单”相关设置后，点击搜索列表或歌单中的单曲播放时，界面播放队列依然错误显示为整个搜索列表/歌单，且当前播放索引被强制置零的 Bug。现在回退默认试听列表时 UI 会正确刷新并精确定位到刚刚播放的新歌。
 - **Subsonic 收藏 (红心) 状态全局联动修复**:
+
   - **`getStarred` 接口精准剥离**: 修复了获取已星标收藏列表时，服务端错误地聚合所有自定义歌单的 Bug。现在客户端的“我的收藏”严格镜像服务端的 `love` 列表。
 - **Subsonic 封面代理与首页/推荐专辑封面修复 (#344 @pyss56)**:
+
   - **抽取独立封面代理模块 (`coverProxy`)**: 将此前客户端 302 重定向拉取封面的模式重构为服务端代理流式返回，内置并发信号量调度（限制同时回源并发数）、自动失败重试（最多 3 次）与内存缓存降级（`STALE`）保护，彻底解决音流等客户端冷启动并发拉取封面被平台 CDN 封禁导致的封面大面积空白问题。
   - **恢复首页/推荐与云端专辑封面**: 新增 `buildAlbumCoverUrl` 根据 mid 动态构造云端封面，并为网易云等无法直接拼接 URL 的专辑接入 SDK 详情兜底拉取首曲封面；同时为推荐接口引入抖动自动重试机制。
   - **进程级并发队列与请求防击穿**: 将媒体库专辑/歌手补全封面的并发控制提升至模块进程级，并实现 In-flight Promise 复用，防止多客户端并发请求击穿音源；带缓存容量上限管理，预防内存泄露与 OOM。
 - **歌曲命名方式修改与重命名联动修复 (#342)**:
+
   - **修复新命名规则无法选中及保存**: 修复前端 `SETTINGS_UI_MAP` 中 `serverCacheNamingPattern` 的 `normalize` 规则遗漏新命名模式的问题，解决选择“歌手-歌名-音质-专辑”、“歌手-歌名”或“歌名-歌手”后无法选中并自动弹回“简洁”的 Bug。
 - **配置持久化与 Docker 升级数据保留优化 (#345)**:
+
   - **配置文件默认迁移至数据卷目录 (`data/config.js`)**: 将服务配置文件的默认持久化路径从容易随容器销毁而丢失的根目录重定向至持久化卷目录 `data/config.js`，彻底解决 Docker/Watchtower 升级或重建容器后通过后台保存的所有设置（密码、路径、用户权限等）静默重置为默认值的 Bug。
   - **平滑无感兼容迁移**: 服务启动时若 `data/config.js` 尚不存在，将自动从根目录旧 `config.js` 迁移至 `data/config.js`，无需用户手动修改挂载映射。
   - **WebDAV 备份与同步统一**: WebDAV 增量同步与全量打包天然覆盖 `data/config.js`，移除了繁琐的根目录文件特判与转移代码，增强了数据备份的稳定性。
-
 - **自定义目录与本地音乐异常报错修复 (#347)**:
+
   - **修复 songmid 类型异常导致的崩溃**: 修复了在自定义目录关联歌曲、重新渲染或操作本地音乐列表时，由于极少部分未索引歌曲的 `songmid` 为数字类型从而触发 `item.songmid.includes is not a function` 导致组件或整个页面崩溃、误报权限错误的 Bug。
 
 ### 💡 升级与迁移建议 (Migration Guide)

docs/subsonic-status.md

@@ -0,0 +1,86 @@
+# Subsonic 协议支持状态对照
+
+> 范围：`src/server/subsonic.ts` 对 Subsonic REST API 的**自定义实现**对照表。
+> 图例：✅ 已实现可用　🟡 占位（返回空 / no-op，兼容客户端握手）　❌ 未实现（返回 `Method not found`）
+> 更新：2026-09-10（新增「每日推荐歌曲」接口，见文末）
+
+---
+
+## 一、已实现 / 可用接口
+
+| 方法 (method) | 类别 | 状态 | 说明 |
+|---|---|---|---|
+| `ping` | 系统 | ✅ | 握手 / 存活检测 |
+| `getLicense` | 系统 | ✅ | 许可信息 |
+| `getScanStatus` | 系统 | 🟡 | 固定返回 `scanning:false` |
+| `getMusicFolders` | 浏览 | ✅ | 单一音乐库 |
+| `getMusicDirectory` | 浏览 | ✅ | 专辑 / 歌单 / 歌手目录 |
+| `getGenres` | 浏览 | ✅ | 流派（来自 QQ 音乐 discovery） |
+| `getArtists` | 浏览 | ✅ | 按字母索引的歌手 |
+| `getArtist` | 浏览 | ✅ | 歌手详情 |
+| `getArtistInfo` / `getArtistInfo2` | 浏览 | ✅ | 歌手信息 |
+| `getAlbum` | 浏览 | ✅ | 专辑详情（含歌曲列表） |
+| `getAlbumList` / `getAlbumList2` | 浏览 | ✅ | 含 `recommend`/`random`/`newest`/`recent` 推荐专辑逻辑 |
+| `getStarred` / `getStarred2` | 浏览 | ✅ | 收藏 |
+| `getSong` | 媒体 | ✅ | 单曲信息 |
+| `stream` / `download` | 媒体 | ✅ | 在线音频流（按 `source_songmid` 解析） |
+| `getCoverArt` | 媒体 | ✅ | 封面代理 |
+| `getUser` | 用户 | ✅ | 当前用户 |
+| `search` / `search2` / `search3` | 搜索 | ✅ | 本地 + 在线全网搜索 |
+| `getPlaylists` / `getPlaylist` | 歌单 | ✅ | |
+| `createPlaylist` / `updatePlaylist` / `deletePlaylist` | 歌单 | ✅ | |
+| `star` / `unstar` | 收藏 | ✅ | |
+| `setRating` | 评分 | ✅ | 评分按用户持久化（0-5，0=清除）；每日推荐会排除评分落入「不喜欢」阈值（`subsonic.dislikeRating`，默认 1）的歌曲 |
+| `scrobble` | 播放 | 🟡 | no-op（返回成功） |
+| `getNowPlaying` | 播放 | 🟡 | 返回空列表 |
+| `getLyrics` / `getLyricsBySongId` | 歌词 | ✅ | |
+| `getOpenSubsonicExtensions` | 扩展 | ✅ | |
+| `getRandomSongs` | 发现 | ✅ | 本地库随机 / 流派随机 |
+| `getSongsByGenre` / `getSongsByGenre2` | 发现 | ✅ | 按流派拉取云端歌曲 |
+| `getSimilarSongs` / `getSimilarSongs2` | 发现 | ✅ | 同歌手相似 |
+| `getTopSongs` | 发现 | ✅ | 歌手热门 |
+| `getInternetRadioStations` | 电台 | ✅ | QQ 音乐电台 |
+| **`getRecommendedSongs`** | **发现（新增）** | ✅ | **每日推荐歌曲（见第二节）** |
+| **`getDailySongs`** | **发现（新增）** | ✅ | **`getRecommendedSongs` 的别名** |
+| **`getSongsByTag`** | **发现（新增）** | ✅ | **别名，同样映射为每日推荐**（lx-server 未实现独立按标签检索） |
+
+---
+
+## 二、新增：每日推荐歌曲（2026-09-10 实现）
+
+### 背景
+此前代码里**完全没有**歌曲级「每日推荐」接口（`getRecommendedSongs` / `getDailySongs` / `getSongsByTag` / `DailySongs` 在 `subsonic.ts` 中均为空，走 default 分支返回 `Method not found`）。仅 `getAlbumList2` 带有「推荐专辑」逻辑（`cachedRecommend → fetchRecommendedAlbums`，专辑级）。
+
+### 实现
+- 新增数据源 `src/server/utils/recommendSongs.ts`：`fetchRecommendedSongs(size)`
+  - 复用已验证的 `fetchRecommendedAlbums('random')` 拿推荐专辑；
+  - 逐张调用 `musicSdk.tx.extendDetail.getAlbumSongs(mid)` 取出专辑内歌曲；
+  - 按 `tx_<songmid>` 去重，按「自然日」做种子洗牌（当天稳定、跨天换批），返回可直接播放的在线歌曲。
+  - 全程公开接口、无需登录；QQ 抓取失败时回退到上次成功结果，避免每日推荐空白。
+  - **评分过滤**：返回前按请求用户过滤——评分落入「不喜欢」区间（`0 < rating <= subsonic.dislikeRating`，默认阈值为 1，可配置）的歌曲不会进入每日推荐（`setRating` 设置）。
+- `subsonic.ts` 分发开关新增 `case 'getRecommendedSongs' / 'getDailySongs' / 'getSongsByTag'`，handler `handleGetRecommendedSongs` 复用 `renderRandomSongs` 输出（与 `getRandomSongs`/`getSongsByGenre` 同一条渲染链路，封面 / 播放均正常）。
+
+### 调用示例
+```
+GET /rest/getRecommendedSongs?u=<user>&p=<pass>&f=json&size=20
+GET /rest/getDailySongs?u=<user>&p=<pass>&f=json
+```
+返回结构：`{ recommendedSongs: { song: [ ... ] } }`（XML 下为 `recommendedSongs > children > song`）。
+
+---
+
+## 三、未实现（官方标准方法，当前返回 `Method not found`）
+
+| 方法 | 类别 |
+|---|---|
+| `getIndexes` | 浏览 |
+| `getVideos` | 媒体 |
+| `getBookmarks` / `createBookmark` / `deleteBookmark` | 书签 |
+| `getPlayQueue` / `savePlayQueue` | 播放队列 |
+| `createUser` / `updateUser` / `deleteUser` / `changePassword` / `getAvatar` | 用户管理 |
+| `getPodcasts` / `getNewestPodcasts` / `refreshPodcasts` 等播客系列 | 播客 |
+| `getChatMessages` / `createChatMessage` | 聊天 |
+| `createShare` / `getShares` / `deleteShare` | 分享 |
+| `createInternetRadioStation` / `updateInternetRadioStation` / `deleteInternetRadioStation` | 电台管理 |
+
+> 注：lx-server 定位是「个人音乐库桥接」，未实现多用户管理 / 播客 / 分享 / 聊天等协作类接口属预期范围。

package.json

@@ -6,6 +6,7 @@
     "prebuild": "node scripts/download-binary.js && node scripts/update-build-hash.js",
     "build": "rimraf server && tsc --project tsconfig.json && tsc-alias -p tsconfig.json",
     "test": "node --test test/*.test.cjs",
+    "test:unit": "tsx --test test/*.test.ts",
     "prestart": "node scripts/download-binary.js && node scripts/update-build-hash.js",
     "start": "node ./index.js",
     "predev": "node scripts/update-build-hash.js",