v1.0 帮助 · 神剑HiFi播放器

01 · 入门

先听起来

解压便携包后运行 SwordX.exe。首次使用可直接把音频文件拖到主窗口，或用菜单 打开文件…（Ctrl+O）选曲。

若有整库音乐文件夹，建议先在 设置 → 媒体库 添加监视文件夹，让索引在后台建好，再用媒体库按歌手、专辑、流派等方式浏览。

用户数据默认在 %LOCALAPPDATA%\Sword-X HiFi Companion\ （会话、设置、媒体库数据库、播放列表与皮肤等）。设置里可「打开数据目录」快速定位。

02 · 菜单

主菜单怎么用

打开主菜单有两种方式：点击主窗口上的菜单按钮（具体位置随皮肤变化），或在主窗体空白处单击右键。常用项如下。

打开与来源

打开文件…（Ctrl+O）：选择本地音频加入当前列表并播放。
打开电台URL…（Ctrl+U）：输入网络电台或流地址。
播放 CD…：从光驱读取并播放音频 CD（可按设置查询网络 CD 信息）。

控制

「控制」子菜单会补齐皮肤上没有做成按钮的功能；播放模式始终可在此切换。

播放 / 暂停 / 停止、上一曲、下一曲（皮肤已有对应按钮时可不出现在菜单里）。
播放模式：顺序播放、列表循环、单曲循环、随机播放。
播放列表（Ctrl+L）、均衡器（Ctrl+E）、歌词：显示或切换对应窗口（视皮肤布局与是否已有切换按钮）。

音频

设备信息：查看并调整当前输出设备相关能力。
声道：立体声 / 左 / 右 / 合并声道。
输出：WASAPI 共享、WASAPI 独占、WASAPI DoP (DSD)、DSD Native；若编译启用 ASIO，还有 ASIO Native (DSD)。DSD 相关项在当前曲目非 DSD 时会灰显。
菜单下方列出可用播放设备，点选即可切换（当前设备名前带 ●）。

其它

皮肤：切换已安装主题；发行版通常还提供打开皮肤编辑器。
设置…：常规、音频、媒体库（含界面语言、启动与会话、窗口与托盘、网络与缓存、标签默认等）；关于对话框也在设置页入口。
退出。
曲目的编辑标签 / 批量编辑在播放列表或曲目右键菜单中，不在主菜单。

03 · 媒体库

索引型曲库，不靠塞满内存

媒体库与「当前播放队列 / 命名播放列表」相互独立：库负责索引与浏览，列表负责这一次听什么。元数据落在本地 SQLite，文件夹变更可后台增量扫描。

添加与扫描

打开 设置 → 媒体库（或库内入口「设置媒体库」）。
用添加文件夹加入要监视的音乐目录；不需要的目录可移除。
首次会后台扫描；之后可随时重新扫描强制对账。状态栏会显示「监视中 · N 首」或扫描进度。

浏览视图

在库栏标题或相关菜单中切换查看方式，右侧列出该分类下的曲目：

播放列表
歌手
专辑
风格
年代
年份
文件夹
评分
文件类型
比特率
最常播放
最近播放
收藏
自定义筛选

歌手视图还可按地区、性别、类型筛选；支持合并歌手与取消合并，用于整理同名不同写法的艺人。封面可设置、清除、重新搜寻或切换上一张。

从库到播放

查找曲目（Ctrl+F）：按标题、歌手、专辑或文件名定位。
添加到播放列表 / 添加到新建列表：写入命名播放列表。
插入到当前播放队列的下一首 / 末尾：不离开浏览即可改队列。
F6：在媒体库视图与播放列表视图之间切换。
F7：定位到当前播放队列。
Alt+↑ / Alt+↓：在左栏切换相邻的播放列表或媒体库分类，并刷新右侧曲目。Ctrl+↑ / Ctrl+↓：按分类导航（view_list）的顺序切换，包含当前播放。

04 · 播放列表

队列与命名播放列表

当前播放队列是正在听的那一串曲目； 命名播放列表保存在数据目录的 playlists/ 下，可反复打开。皮肤决定播放列表是嵌入主窗还是独立窗口；主窗、播放列表、均衡器可启用窗口吸附一起拖动。

管理列表

新建列表：创建空的命名播放列表。
另存为 / 另存为 m3u8…：导出为应用格式或通用 M3U8。
导入 m3u 播放列表：从外部播放列表导入。
删除 / 清空：移除命名列表或清空当前列表内容（注意确认）。
插入播放列表 / 添加播放列表到最后：把已有播放列表并入当前队列。

曲目操作

添加 / 插入 / 追加文件；删除当前或批量删除。
查看属性、编辑标签、评分、收藏、排序。
CD 抓轨为 FLAC（在支持的上下文菜单中）；对曲目扫描 / 应用 ReplayGain（设置中可开关并选曲目或专辑模式）。
列表内：双击或 Enter 播放；↑↓ 移动焦点；字母键可按曲名首字母跳转（列表有焦点时）。

05 · 快捷键

少点鼠标，多听几首

下列为全局加速键（主窗口活跃时）；在标签编辑等对话框中，空格等键优先给输入框使用。

全局

快捷键	功能
`Ctrl`+`O`	打开文件
`Ctrl`+`U`	打开电台 URL
`Ctrl`+`E`	均衡器
`Ctrl`+`L`	播放列表
`F6`	媒体库 ↔ 播放列表切换
`F7`	定位当前播放队列
`Space`	播放 / 暂停
`Ctrl`+`←`	上一曲
`Ctrl`+`→`	下一曲

列表与库（焦点在主窗 / 列表窗时）

快捷键	功能
`Ctrl`+`F`	查找曲目
`Ctrl`+`A`	全选当前浏览列表曲目
`Delete`	删除选中项（按上下文）
`F2`	重命名（如命名列表）
`↑` / `↓` / `Enter`	移动焦点 / 播放
`Esc`	清除当前查找筛选
`Alt`+`↑` / `↓`	切换播放列表 / 媒体库分类
`Ctrl`+`↑` / `↓`	切换分类导航（view_list）条目，包含当前播放

系统媒体控件（SMTC）可在「设置 → 窗口与托盘」中注册开始菜单快捷方式，便于锁屏与硬件键显示本程序名称。

06 · 皮肤

换一套长相，热切换

打开主菜单 → 皮肤，在列表中点选即可切换；主窗、播放列表与均衡器布局会一并更新，无需重启。

内置主题包括（名称以安装包为准）：autumn、earth、forest、Industrial-Metal、moon、pinkish、plain、simple、simple-dark、summer、winter 等。皮肤格式为 sword-x-skin/1：目录内含 skin.json 与 theme.css。

安装自定义皮肤

将皮肤文件夹（或解压后的 ZIP 内容）放到用户目录 %LOCALAPPDATA%\Sword-X HiFi Companion\skins\，或与程序同级的 skins\（视分发方式而定）。
回到皮肤菜单重新打开列表，选中新主题即可。
需要改布局时，可用菜单中的打开皮肤编辑器可视化调整 role 几何与贴图。