qsm 用户使用说明

01认识 qsm

qsm 是一款 Windows 桌面音乐工具，内置了 musicdl 聚合搜索引擎：一次关键词搜索，可同时从数十个国内外音乐平台拉取结果；找到歌之后可以直接在线试听、下载到本地，也支持粘贴歌单链接批量下载整张歌单，并自带音视频转码能力（如把视频里的音轨抽成 MP3）。

02快速上手

第一次使用只需三步：打开应用 → 搜索 → 播放或下载。核心流程如下：

flowchart LR
    A[启动 qsm] --> B[后端服务自动连接]
    B --> C[搜索页输入关键词]
    C --> D{选择动作}
    D -->|点击播放| E[在线试听 · 加入队列]
    D -->|勾选后下载| F[下载管理]
    D -->|歌单页粘贴链接| G[解析并下载全部]
    E --> H[播放条 · 歌词 · 队列]
    F --> I[保存到下载目录]
    I --> J[可选：自动转码]
    

1. 启动应用双击 qsm.exe。应用会自动拉起内置后端服务（本机端口，无需任何配置），左下角状态点变绿即代表就绪。启动时还会自动检查新版本，若有更新会自动下载安装并重启应用。
2. 搜索歌曲在「搜索」页输入歌曲名、歌手或专辑，按回车或点击「搜索」。默认使用推崇源（酷狗 + 酷我），结果逐个返回。
3. 试听 / 下载点击行内播放按钮即可即点即放试听；勾选想要的歌曲，点「下载选中」批量下载。文件默认保存到 Downloads\qsm-download。

03界面总览

04搜索与下载

发起搜索

1. 输入关键词支持歌曲名、歌手或专辑名，回车或点击「搜索」发起。搜索进行中按钮显示「搜索中…」，此时输入新词再回车可直接覆盖当前搜索。
2. 选择音质搜索栏的音质下拉共四档：全部音质最高音质320k128k。
3. 选择数据源（可选）点搜索栏右侧「数据源」按钮展开面板，用推崇（酷狗 + 酷我）、默认、全选快速选择，或逐个勾选。完成过测速后，面板只展示延迟低于 30 秒的达标源，并按延迟从快到慢排序。
4. 查看搜索过程（可选）发起搜索时「数据日志」面板会自动展开，实时显示每个源的搜索进度（转圈 = 进行中，n/N = 已返回条数）、耗时，失败源会标记 ⚠。

搜索结果操作

结果表共八列：歌曲、歌手、时长、大小、类型、码率、来源、操作。当前正在播放的行会显示三格跳动的均衡器动画。

05歌单批量下载

「歌单」页用于把整张在线歌单一次性拉下来。

1. 粘贴歌单链接复制歌单页的 URL 粘贴到输入框，例如网易云歌单：https://music.163.com/#/playlist?id=xxx。
2. 点击「解析歌单」解析期间按钮显示「解析中…」。默认使用网易云音乐源解析；若你在搜索页勾选了其他数据源，会按所选源解析。
3. 核对结果并下载解析完成后显示「共解析到 N 首」及每首歌的歌名、歌手、专辑与来源徽标，点击 「下载全部」 一键入队下载。

06下载管理

文件保存位置

下载完成后文件会自动移动到你的下载目录，默认为 用户目录\Downloads\qsm-download，可在「设置 → 下载目录」中修改、保存或恢复默认。未设置时文件留在后端下载根目录。

07播放与歌词

播放条控制

• 上一首 / 播放·暂停 / 下一首：沿播放队列移动；队列为空或到达边界时按钮置灰，缓冲中播放键显示转圈。
• 进度条：点击或拖动可直接跳转播放位置。
• 音量：悬停音量图标弹出音量条，可调节大小或静音。
• 连播模式：点击循环图标轮换 列表循环 → 单曲循环 → 随机播放，选择会记住（本机保存），同时作用于自动连播与上/下一首。

歌词

当前歌曲带有歌词时，播放条才会出现「歌词」按钮；点击从右侧滑出歌词面板：

• 歌词随播放进度自动高亮并把当前行滚到面板中部；时间对齐歌词可点击某行直接跳转到该位置。
• 两种展示样式在「设置 → 播放」中切换：逐行高亮（经典整行变色，默认）与 扫色跟唱（已唱文字逐字扫色推进）。
• 切歌后面板自动回到新歌词顶部；点击面板外任意处或按 Esc 收起。

播放列表（队列）

点击播放条「播放列表」按钮打开队列抽屉，按钮上的角标显示队列数量（当前队列由搜索页点播建立）：

• 双击任意行切换到该歌曲播放；当前播放行显示均衡器动画并以主题色标注。
• 鼠标悬停非当前行可从列表移除；顶部「清空」按钮可清空整个队列（不删除文件）。

视频播放窗口

搜索结果中的视频类内容，或本地音视频文件，可在独立播放器窗口中观看：从转码管理页的视频行点「在独立播放器窗口中打开」，或打开空窗口后自行选择本地文件。窗口支持进度拖动、后退/前进、播放/暂停、音量与静音、倍速播放、全屏。若提示「未选择视频源」请先打开文件；遇到浏览器内核不支持的格式（如 H.265），可点 「本地转码后播放」，转码完成后自动播放。

08转码管理

「转码管理」页是音视频格式转换工作台，内置 ffmpeg（页面顶部会提示 ffmpeg 是否可用）。典型用途：把视频转成纯音频 MP3、压缩视频体积、统一下载文件的格式。

添加文件

• 拖拽添加：把文件或整个文件夹拖到页面上即可批量登记。
• 粘贴路径：在输入框粘贴文件/文件夹路径（逗号或换行分隔可一次添加多个），回车添加。
• 浏览文件 / 浏览文件夹：通过系统选择对话框添加。

转换参数

先选择目标形态，再按需调整参数（设置页的「自动转码档案」与此共用同一套参数）：

任务操作

• 单个转码：点击文件行的转码按钮立即排队执行；批量转码：勾选多行后点顶部主按钮，一次提交。
• 排队机制：并发跑满时新任务在后端排队，空闲槽位自动续发，无需等待。
• 行内操作：播放成品、打开文件位置（已转码的定位到产物，否则定位源文件）、删除/取消任务、视频行可在独立播放器打开。
• 清空列表 / 刷新：「清空列表」仅清除当前显示的登记，不删除任何磁盘文件、不取消后台任务，重新添加文件即可恢复查看。

09设置详解

点击左下角设置图标进入。设置分为两类：标注「本机」的偏好只保存在你这台电脑；其余配置保存在后端服务，对所有入口生效。

10数据源平台一览

qsm 接入 musicdl 生态的 60+ 音乐数据源，按用途分为下面几组。搜索页默认只展示测速达标的源，因此你实际看到的列表可能更少——这是为了保证速度，属于正常现象。

11常见问题