Coffee Decky 插件
免费的 Coffee 做成了 Steam Deck 的 Decky 插件:在游戏模式里浏览游戏、登录网盘、下载并自动安装。
Coffee Decky 插件是免费版 Coffee 的 Steam Deck 版本,装在 Decky Loader 里,名字叫 Coffee。它是一个精简的游戏下载器:带封面的游戏列表、网盘登录、下载和自动安装。启动游戏交给 EmuDeck / ES-DE 或 Steam 本身;想要完整的游戏库、封面和刮削,请用 Tea 的 Steam Deck 版,两者可以同时装。

#获取与安装
插件的 zip 文件在 Analogue 的 B 站视频 简介里。
- 先在 Steam Deck 上装好 Decky Loader。
- 把
coffee-decky-<版本>.zip放到 Deck 上(例如~/Downloads),不用解压。 - 按 … 打开快速访问菜单,进入 Decky 的设置(齿轮),打开开发者模式(Developer mode)。
- 在开发者(Developer)页选「从 ZIP 安装插件」(Install Plugin From ZIP File),选中刚才的 zip。
- 安装完成后,快速访问菜单的 Decky 列表里会出现 Coffee。

更新时用新版 zip 再装一次即可,登录和设置都会保留。
#面板
在 Decky 列表里点 Coffee 打开面板。面板有三个页签,LB / RB 切换:
| 页签 | 内容 |
|---|---|
| 资源库 | 打开游戏库;天翼云盘、百度网盘、夸克网盘的登录 |
| 设置 | ROM 文件夹、PC 游戏文件夹、下载文件夹,保留压缩包 开关 |
| 下载 | 下载进度:暂停、继续、重试、清除记录、清除已完成 |
#登录网盘
- 在 资源库 页点要登录的网盘。
- 用对应的手机 App 扫码(天翼云盘 App、百度网盘 App、夸克 App),在手机上确认。
- 二维码过期时点 刷新二维码。
如果 Deck 上装了 Tea 并且已经登录同一个网盘,面板会给出两个选择:使用 Tea 的登录(不用再扫码,Tea 重新登录后也跟着更新),或 登录其他账号。在 Coffee 里退出登录不会影响 Tea。
提示:天翼云盘每个文件同时 16 路下载;百度网盘 SVIP、夸克会员同时 8 路;其他情况 1 路。暂停或断网后从断开的地方接着下。
#文件夹
默认位置:
| 文件夹 | 默认 |
|---|---|
| ROM 文件夹 | EmuDeck 的 ~/Emulation/roms(装在 SD 卡上时用卡上的) |
| PC 游戏文件夹 | ~/Games/Freedeck |
| 下载文件夹 | ~/Downloads/FreedeckCoffee |
装了 Tea 时,点 使用 Tea 的文件夹 就和 Tea 用同一套文件夹。恢复默认文件夹 回到上面的默认值。
#游戏库
在面板点 打开游戏库,进入全屏的游戏列表。

| 按键 | 作用 |
|---|---|
| LB / RB | 切换主机 |
| RT | 跳转到:所有主机的列表 |
| A | 打开游戏:大小、安装位置、剩余空间、来自哪个网盘,下载 |
| X | 隐藏已下载 / 显示已下载 |
| Start | 网格 / 列表切换 |
- 每个主机页签顶部有搜索框,往下滚时一直固定在顶上;点 ↑ 回到顶部。
- 已经在 Deck 上的游戏排在前面,标着 已下载。
- 还没下载的游戏会标出从哪个网盘下载;没登录的那个网盘显示为灰色,游戏详情里标着 (未登录)。
- 剩余空间不够时,大小旁边会显示 (空间不足)。
- 在游戏详情里点 收藏,封面会出现琥珀色角标,收藏的游戏排在最前;最后一个页签 收藏 汇总所有主机的收藏。
#下载与安装
在游戏详情里点 下载,进度在面板的 下载 页查看。下载完成后 Coffee 自动安装:
- 主机游戏:放进 ROM 文件夹里对应主机的子文件夹(EmuDeck / ES-DE 的目录结构)。压缩包自动解压(支持 RAR5 和分卷),卡带主机的 zip 保持原样。解压后压缩包会删除,打开 保留压缩包 则保留。
- PC 游戏:解压到 PC 游戏文件夹,并自动添加到 Steam 游戏库(非 Steam 游戏,使用 Proton Experimental,配上 Steam 的封面)。几秒后就能在游戏库里看到。没找到游戏程序时,在游戏详情里点 选择程序 手动指定;也可以 重新添加到 Steam。
#删除游戏
已下载的游戏,在详情里点 删除。确认框会列出将被删除的文件;PC 游戏还会一并删除它在 Steam 里的快捷方式。
#和 Tea 的区别
| Coffee Decky 插件 | Tea(Steam Deck 版) | |
|---|---|---|
| 价格 | 免费 | 支持者专享,见 下载 |
| 游戏来源 | 内置的社区免费资源列表 | 你自己网盘和 NAS 里的文件 |
| 游戏库、封面刮削、贴纸 | 无 | 有 |
| 启动游戏 | 交给 EmuDeck / ES-DE / Steam | Tea 里直接启动 |
| 同步、AI 功能、应用内更新 | 无 | 有 |
