玩 Steam Deck 的玩家应该都有同款困扰，想边打游戏边听歌，流程实在太折腾。要么切桌面模式装音乐软件，添加到 Steam 库来回切换；要么蓝牙连手机播放，操作卡顿还没法切歌看歌词；市面上少数 Decky 音乐拓展只支持单一平台，收藏歌单、逐字歌词全都没有，体验差一大截。
经常玩掌机、离不开 QQ 音乐、网易云音乐的朋友，可以试试 Decky Music 这款 Decky Loader 专用拓展，不用切桌面、不用第三方中转，在游戏模式侧边栏就能完整操控两大音乐平台，听歌、切歌、看歌词一步到位。
Decky Music 是开源免费拓展，基于 Python+TS 开发，适配全版本 Decky Loader，构建流程简单，支持 Docker 一键打包部署，全程无广告、不收集用户播放数据，掌机游玩时后台占用极低，不会拖累游戏帧率。
主要功能特点
- 🎵 多平台支持 – 同时支持 QQ 音乐 和 网易云音乐，双平台资源深度集成
- 🔐 扫码登录 – 支持 QQ、微信及网易云扫码登录，安全便捷
- 📅 个性化推荐 – 每日推荐歌曲、精选歌单、智能“猜你喜欢”
- 📂 我的音乐 – 完整支持个人收藏歌曲、自建歌单及收藏歌单
- 🔍 智能搜索 – 支持关键词搜索、搜索建议及热门搜索列表
- 🎭 全屏播放器 – 沉浸式全屏界面，支持逐字歌词 (QRC/KRC)、标准歌词及歌词翻译
- 🕒 播放历史 – 自动记录最近播放的歌曲，随时找回心头好
- ⚙️ 高度可定制 – 可自由设置主平台、兜底顺序及首选音质
双音乐平台兼容，扫码登录更省心
同时接入 QQ 音乐、网易云音乐两套音源，QQ / 微信、网易云 APP 扫码登录，不用手动输账号密码，登录信息本地加密存储。能自定义主播放平台，设置音源兜底顺序，其中一个平台资源缺失时自动切换另一平台曲库。
完整个人曲库，个性化推荐全覆盖
首页自带每日推荐、猜你喜欢、官方精选歌单；同步账号内自建歌单、收藏歌单、点赞单曲，不用单独打开软件整理。内置智能搜索，输入关键词弹出热门搜索与匹配歌曲，找曲不用跳转页面。
沉浸式全屏播放器，逐字歌词同步
点击底部播放条一键进入全屏界面，高清专辑封面全屏展示，兼容 QRC、KRC 逐字滚动歌词，附带歌词翻译。不用盯着小窗口，休息间隙切全屏听歌，氛围感拉满。
掌机原生按键快捷控制
完全适配 Deck 实体按键，X 键一键播放暂停，L1/R1 切换上一首、下一首，不用触摸屏幕操作。底部常驻播放进度条，滑动就能调节播放进度，随时查看剩余时长。
播放历史与音质自定义
自动缓存全部播放记录，想听老歌直接在历史列表找回；支持多档音质自由切换，根据网络情况选择标准、高清、无损，节省掌机流量。
轻量化开源，部署门槛低
提供 Release 压缩包一键安装，也支持本地源码构建，搭配 mise、uv 管理开发依赖，开发者可通过 SSH 远程部署到 Steam Deck，自带日志、配置独立存储目录，不会和其他拓展冲突。
简单安装步骤，新手也能上手
设备提前装好 Decky Loader（https://github.com/SteamDeckHomebrew/decky-loader）
登录与设置
1. 打开 Steam Deck 的游戏模式，按下 … 按钮打开快速访问菜单。
2. 切换到 Decky 拓展标签页，找到并打开 Decky Music。
3. 进入 Provider 设置： 分别进行 QQ 音乐（支持 QQ/微信扫码）和 网易云音乐（支持网易云 APP 扫码）的登录。 设置首选播放音质。
核心功能
- 推荐与发现 – 首页展示每日推荐、推荐歌单及个性化推荐。
- 我的歌单 – 在“歌单”页面查看个人创建和收藏的列表。
- 搜索歌曲 – 进入搜索页面，支持关键词搜索和搜索建议。
- 播放历史 – 快速访问最近听过的歌曲。
播放控制
- 基础控制 – 点击歌曲开始播放，底部播放条支持播放/暂停、进度调节。
- 快捷键支持： 使用 X 键控制播放/暂停。 使用 L1/R1 键切换上一首/下一首。
- 全屏播放器 – 点击底部播放条进入全屏模式，可查看精美封面及滚动歌词（支持逐字显示）。
使用小提醒
平台内部分付费歌曲需要对应平台 VIP 权限才能完整播放，拓展仅做音源整合，仅用于个人学习交流，遵守两大音乐平台用户协议。后续版本还会更新悬浮歌词功能，进一步优化游戏听歌体验。
以往想在 Steam Deck 听歌，总要来回切换桌面、多开软件，操作繁琐还占用内存。Decky Music 直接把两大主流音乐平台搬进游戏模式侧边栏，不用额外软件、不用中转设备，收藏、推荐、歌词、快捷控制全部配齐，掌机玩家听歌刚需一个拓展就能解决。
⚠️ 注意事项
- 部分歌曲可能需要对应平台的 VIP 才能播放。
- 请遵守各音乐平台的使用条款。
- 本插件仅供学习交流使用。
官方网站
https://github.com/jinzhongjia/decky-music
