本轮文档与首页实机画面核对于 2026 年 9 月 22 日，主要对应正在开发的 WinUI 预览版。
先确认你使用的版本
| 版本 | 界面与运行方式 | 阅读方式 |
|---|---|---|
| WinUI 预览版 | 原生 Windows 主界面，Rust 播放宿主，沉浸与胶囊使用共享 Web 视图 | 本站用户指南的主要对象 |
| Tauri 桌面版 | 既有 Vue / Tauri 桌面应用 | 功能可能相近，按钮位置与原生设置不同 |
| 网页版 | 在浏览器中打开 /app | 使用浏览器文件与站点存储能力 |
| OFPlayer Hub | 独立或与桌面协作的音乐服务方向 | 参见手机接力与 Hub 的能力区分 |
首页的 WinUI 预览图不是安装包发布公告。请从下载页确认产物标识、系统要求和发行说明；不要用 Tauri 安装包替换 WinUI 的更新产物。
当前已经接入的功能
- 本地导入、扫描目录、曲库与歌单、搜索和格式筛选。
- 原生专辑封面网格，以及艺术家 → 专辑 → 曲目浏览。
- 播放队列、播放模式、输出设备、系统媒体控制。
- 歌词绑定、沉浸视图、独立歌词胶囊。
- WebDAV、Subsonic 和 FTP 的远端来源入口、连接测试、浏览和播放链路。
- 手机局域网配对、曲库同步、设备播放状态与桌面接回。
- 首次引导、收听统计、存储分析和诊断入口。
这里表示当前实现包含相关用户入口，不代表所有设备、文件格式和服务器组合都已完成实机验收。
仍在完善
| 项目 | 当前说明 |
|---|---|
| 自动更新 | 检查入口已有，下载、验证、安装与重启闭环尚未完成 |
| 多语言 | 部分入口可切换，仍有中文硬编码文本 |
| 主题与材质 | 保留原生外观，Web 三套皮肤未迁移；部分效果选项仍在调整 |
| 远端大库 | 加载更多仍有数量上限，不是无限游标分页 |
| 歌词呈现 | 原生列表与共享 Web 的逐字效果仍需逐项对齐 |
| 发布安装 | 干净机器安装、依赖、升级与数据保留需要独立验证 |
数据不会自动合并
WinUI 预览版、Tauri 旧版和网页的数据空间不同。切换版本后看不到原曲库时，先核对数据位置，不要重置旧数据或让多个客户端直接共写同一份数据库。
本地开发与隔离运行见构建与本地运行。