feat: smart playlists - rule-based auto-updating collections

[LWWZH]

简介与背景

目前 FeelUOwn 的收藏（collection）是静态的文本文件（.fuo 格式，TOML 头部 + URI 列表）。用户需要手动添加/删除歌曲。对于大型曲库来说，这不够高效。

同时，RecentlyPlayed（feeluown/player/recently_played.py）和 Playlist 已经在追踪播放历史和队列状态，但这些数据没有被充分利用来生成动态歌单。

Smart Playlists（智能歌单）是 iTunes/Apple Music、Spotify、Roon 等主流播放器的标配功能，能让用户基于规则自动生成和更新歌单。

方案概述

核心思路

在现有 Collection 体系上扩展，支持声明式规则（而非静态 URI 列表）。规则引擎在应用启动时和播放事件触发时重新评估，动态更新歌单内容。

规则设计

在 .fuo 文件的 TOML 头部中新增 rules 字段：

+++
title = "最近常听"
description = "过去 30 天播放次数最多的 50 首歌"
type = "smart"
rules = """
sort_by = "play_count_desc"
time_range_days = 30
limit = 50
"""
+++

支持的规则字段

规则	类型	说明
sort_by	enum	play_count_desc, last_played_desc, date_added_desc, title_asc
time_range_days	int	仅统计最近 N 天的播放数据
limit	int	最大歌曲数
sources	list	仅包含指定来源（如 ["netease", "qqmusic"]）
min_play_count	int	最低播放次数
exclude_disliked	bool	排除标记为不喜欢的歌曲

需要修改的模块

1. Collection（feeluown/collection.py）

   • 识别 type = "smart" 标记
   • 新增 SmartCollection 子类，持有规则而非静态模型列表
   • 在 load() 中解析 rules 字段

2. 新增 SmartPlaylistEngine（建议 feeluown/collection.py 或新文件）

   • 接收规则，查询 RecentlyPlayed 和播放计数数据
   • 返回排序后的歌曲列表
   • 提供 evaluate() 方法供定时刷新

3. CollectionManager（feeluown/collection.py）

   • 在加载完所有 collection 后，触发 smart collection 的首次评估
   • 监听播放完成事件，增量刷新受影响的 smart collection

4. RecentlyPlayed（feeluown/player/recently_played.py）

   • 新增 get_play_counts(time_range_days=None) 方法
   • 新增 get_most_played(limit, time_range_days) 方法

5. GUI 集成

   • 在侧边栏和集合页面中区分 smart collection 和普通 collection（例如显示不同的图标）
   • Smart collection 不显示 "添加歌曲" 按钮
   • 在设置中提供 smart collection 的刷新频率选项

内置 Smart Playlists

提供几个预置的 smart playlist 模板，用户可以在设置中一键创建：

• 最近播放：最近 7 天播放过的歌曲
• 最常听：播放次数最多的 50 首
• 新发现：最近添加但播放次数 < 3 的歌曲
• 长曲目：时长 > 6 分钟的歌曲

不在本次范围内

• 基于 AI 的推荐规则（可后续扩展）
• 跨设备同步 smart playlist
• 嵌套规则（AND/OR 逻辑组合）

参考

• feeluown/collection.py — Collection 和 CollectionManager
• feeluown/player/recently_played.py — 播放历史追踪
• feeluown/player/playlist.py — 播放计数基础设施

[cosven]

太赞了，我也非常想要智能歌单的功能 ~

实现角度看的话，我感觉智能歌单不一定要和 Collection 这个概念绑定起来。
我目前觉得和 FM 这个概念绑定起来更好一点，细节可以参考 fm.py 模块。

[LWWZH]

@cosven

我看了看，确实 FM 更合适。智能歌单本质上是动态生成歌单内容，跟 FM 的 fetch-and-feed 模式更像，而不是往 .fuo 文件里写死 URI。

整理了下思路，大概这样做：

核心架构：仿照 fm.py 的模式，搞一个 SmartPlaylistManager。跟 FM 一样，有个 activate/deactivate 生命周期，但 fetch 函数变成本地规则评估，不是调 provider API。

数据来源：需要扩展 RecentlyPlayed，加一个 play count 的持久化（现在只在内存里，关了就没了）。这样 "最常听" 之类的规则才有数据基础。

规则引擎：定义 SmartPlaylist 数据类，包含规则（sort_by、time_range、limit 等）。评估函数查 RecentlyPlayed + play counts，返回排序后的歌曲列表。

UI 集成：

• 侧边栏加一个 "智能歌单" 区域，跟 collection 分开，用不同图标区分
• 点击某个智能歌单就 activate 它，把歌曲喂进 playlist
• 详情页展示规则和当前歌曲列表

持久化：智能歌单的规则定义存到 ~/.FeelUOwn/smart_playlists.json，内置的几个（最近播放、最常听）预置好，用户也可以自己创建。

内置的几个：

• 最近 7 天播放过的歌
• 播放次数最多的 50 首
• 最近添加的歌

有几个问题想确认下：

1. activate 智能歌单的时候，是清空当前队列还是追加？（FM 是清空的）
2. 歌曲变化时刷新频率怎么定？每次 song_changed 都评估一次，还是 debounce 一下？
3. 同一时间只能有一个激活的智能歌单，还是可以叠加？

你看看这个方向行不，有什么建议？

---

P.S. 其他的PR有空看一下呗？