QPlayer

QPlayer 是一款基于 QML 渲染的跨平台音乐播放器，核心定位是「本地播放引擎 + 插件扩展」。本体不内置任何在线音源，装好就能当纯粹的本地播放器用；需要在线功能时，通过安装 JavaScript 插件即可解锁推荐、聚合搜索、歌单、心动模式等页面，界面元素会跟着插件能力自动出现或隐藏。

播放器架构与定位

1. 跨平台播放器，界面用 QML 渲染，整体架构是「播放器外壳 + 插件系统」的组合。

2. 本体不携带任何在线音源，开箱就是纯净的本地播放器，没有捆绑服务，也没有多余功能干扰。

3. 安装 JavaScript 音源插件后，推荐、搜索、歌单、心动模式等页面会自动出现，操作体验与原生功能一致。

4. 界面元素按插件声明的能力动态显隐，没装对应功能的插件就不会显示空白入口，界面保持干净。

基础操作流程

1. 打开应用后，可以根据自己的需要安装音源插件。

2. 下载好对应的音乐插件后，直接安装即可。

3. 安装成功进入应用，主页就会显示推荐内容。

4. 点击搜索按钮进入搜索页，在输入框里输入关键词就能查找音乐。

5. 点击「本地」，应用会自动扫描手机里已有的音乐文件。

6. 播放音乐后，可以点击底部的播放条。

7. 点击后就能查看当前歌曲的歌词。

8. 在「我的」页面可以登录音源账号，同步自己的歌单。

主要功能

· 插件驱动架构：核心与功能完全解耦，所有在线能力都由第三方 JS 插件提供，用户可以自己挑选需要的服务，避免功能冗余。

· 动态界面适配：UI 会根据已安装插件声明的能力实时调整布局，未启用的功能入口自动隐藏，界面保持简洁一致。

· 纯本地播放基座：不联网也能顺畅播放本地音频文件，支持常见格式解码，作为独立播放器开箱即用。

· 跨平台兼容：基于 QML 构建统一渲染层，在 Windows、Linux、macOS 等系统上保持一致的交互体验和视觉风格。

· 高度可扩展：开放插件接口，社区可以开发新音源或增强功能，生态持续演进，不必等官方更新。

· 轻量高效运行：模块化加载机制让未使用的插件不占资源，启动快、内存占用低，专注音乐播放本身。

功能特色

1. 插件系统扩展性高，想听哪个平台就自己找对应音源安装，不被单一服务商绑定。

2. 不装插件时就是纯粹的本地播放器，专注离线音乐管理，适合长期收藏本地歌曲的用户。

3. 登录、喜欢、最近播放等功能随插件按需加载，用不到的能力不占位置，也不会在后台消耗资源。

产品亮点

1. 音源代码与播放器完全分离，隐私安全更有保障，不用担心播放记录被上传或追踪。

2. 插件生态开放透明，社区贡献的音源可以审查、可以替换，避免闭源黑箱带来的风险。

3. 轻量高效，启动快，即使装了多个插件也不会卡顿，兼顾扩展性与日常使用的流畅度。

版本更新记录

新功能

· 桌面端改用 GraalVM Native Image，提供 Linux AppImage、Windows ZIP / 安装程序、macOS Apple Silicon DMG，不再随包携带 JRE。

· Android 与桌面端的内置 QML 组件在构建期预编译，启动时直接加载，不再依赖运行时编译。

· 悬浮歌词支持屏幕旋转后按比例重定位，并提供锁定开关避免误触。

优化

· 文件选择器改用系统原生接口，移除 Swing 依赖。

· WebView 保留原有 WebView2 / WKWebView / WebKitGTK 内核，改用独立原生窗口承载。

· 优化 macOS 菜单栏图标，支持从 Dock 唤回隐藏窗口。

修复

· 修复桌面端首次安装音源插件时，QML 属性写入与渲染队列刷新竞争，触发「绑定求值检测到循环」导致退出的问题。

· 修复 macOS Command-Q 与菜单退出失效、Retina 下指针坐标偏移的问题。

· 修复搜索历史在进入页面、点历史/热搜时被误写的问题，改为播放、下载或喜欢时记录，并做大小写不敏感去重。