企业官网建设流程全解析

如果你在使用 Aonsoku 连接 Navidrome 或 Subsonic 服务器，却总觉得操作不够顺手，那么这篇 Aonsoku 播放体验指南正适合你。Aonsoku 是一款基于 React 和 Electron 构建的现代化 Navidrome/Subsonic 桌面客户端，内置完整的播放快捷键体系与播放队列管理功能。下面将带你梳理全部快捷键清单，并分享随机播放、循环模式、队列增删等实用管理技巧，帮助你把日常听歌效率提升一个档次。

一、Aonsoku 是什么？为什么值得上手

Aonsoku 定位为现代音乐流媒体桌面客户端，专为自托管的 Navidrome / Subsonic 音乐服务器打造。它的亮点包括：

• 🖥️跨平台桌面体验：基于 Electron，支持 Windows、macOS、Linux
• 🎵完整播放能力：歌曲、网络电台、播客三类媒体统一播放
• 🧩丰富的播放控制：随机播放、三态循环、音量快捷键、ReplayGain 音量平衡
• 📋直观的播放队列：抽屉式队列面板，支持逐首删除、清空队列、指定下一首播放

二、快捷键完整清单：告别鼠标点一点

Aonsoku 内置了一套播放与导航快捷键。所有快捷键定义集中在 src/shortcuts/index.ts 中，在应用内按Ctrl + /（macOS 为⌘ + /）即可随时唤起快捷键帮助面板，面板实现见 src/app/components/shortcuts/dialog.tsx。

💡 以下表格中，Windows / Linux 使用Ctrl，macOS 使用⌘（Command）。

播放控制类快捷键

导航类快捷键

这些快捷键在播放器控件与音量组件中实际绑定，可参考 src/app/components/player/controls.tsx 与 src/app/components/player/volume.tsx。

两个容易踩的坑：

1. ⚠️ 播放类快捷键（空格、切歌、音量等）只在队列中至少有一首歌时生效。逻辑位于 src/app/hooks/use-audio-hotkeys.tsx：队列为空时快捷键自动禁用。
2. 播客播放时，播放器会出现-15 秒 / +30 秒快进快退按钮，方便来回找片段（见 src/app/components/player/controls.tsx）。

三、播放队列管理技巧

播放队列是 Aonsoku 的核心功能之一，队列界面从底部抽屉滑出，实现见 src/app/components/drawer/page.tsx，列表主体在 src/app/components/queue/song-list.tsx。

1. 快速打开与清空队列

• 点击播放器上的列表图标按钮即可展开/收起队列抽屉；
• 右键该按钮还会弹出小菜单：可快速「打开/关闭队列」或「清空队列」（实现见 src/app/components/player/queue-button.tsx）；
• 队列面板头部还显示歌曲来源、歌曲总数与总时长，右上角的清空按钮一键重置全部播放状态。

2. 精准插入：「下一首播放」与「添加到末尾」

在歌曲列表中，右键歌曲可以选择把歌曲插入队列，底层有两个核心动作：

• 下一首播放：插在当前歌曲之后，对应setNextOnQueue；
• 添加到末尾：追加到队列尾部，对应setLastOnQueue；

两者都会自动去重——已在队列中的歌曲不会重复加入（见 src/store/player.store.ts）。插入位置的计算逻辑在 src/utils/songListFunctions.ts，这也是「先听 A 歌手，最后再听 B 歌手」这类精细化排歌的基础。

3. 逐首删除与随机播放的正确姿势

• 队列中每首歌右侧有X 按钮，点击即可从队列移除该曲（src/app/components/table/queue-actions.tsx）；点击队列中的播放按钮可直接跳到该曲。
• 随机播放的打乱范围很有讲究：Aonsoku只打乱当前歌曲之后的剩余部分，当前曲目保持不动；关闭随机后会恢复为原始顺序而非之前的随机顺序，逻辑见 src/store/player.store.ts 与洗牌函数 src/utils/songListFunctions.ts。
• 循环模式按关闭 → 整列表循环 → 单曲循环三态轮转，Ctrl/⌘ + R一键切换（src/store/player.store.ts）。

4. 让音量控制更跟手

除了Ctrl/⌘ + ↑/↓快捷键，还可以：

• 将鼠标滚轮悬停在音量滑块或音量图标上滚动调节，同样每次 5%；
• 点击音量图标可一键静音 / 恢复，恢复时会取回静音前的音量值（src/app/components/player/volume.tsx）。

四、写在最后

掌握这份快捷键清单与播放队列管理技巧后，Aonsoku 的播放体验会顺畅许多：空格控制播放、S与R切换随机循环、右键队列按钮快速清空，再配合「下一首播放」精细排歌，几乎可以全程脱离鼠标完成操作。

📁 延伸阅读的相关源码路径：

• 快捷键定义：src/shortcuts/index.ts
• 播放状态与队列逻辑：src/store/player.store.ts
• 队列列表界面：src/app/components/queue/song-list.tsx
• 队列列定义（序号/标题/专辑/时长/删除）：src/app/tables/queue-columns.tsx

希望这份 Aonsoku 播放体验指南能帮你更充分地享受私有音乐库！