# Unifideck：Steam Deck 全平台游戏库统一解决方案

## 项目概述

Unifideck 是一款专为 Steam Deck 设计的 Decky Loader 插件，旨在解决掌机玩家在多个游戏平台间切换的痛点。该插件将 Steam、Epic Games Store、GOG、Amazon Games、Ubisoft Connect、Battle.net 和 Xbox Cloud Gaming 等主流平台的游戏整合到一个统一的游戏库界面中，让玩家无需离开游戏模式即可访问和游玩所有平台的游戏作品。

该项目由开发者 Numan Mubarak 创建，目前已在 GitHub 上获得 1300+ Star 和 54 Fork，采用 GPL-3.0 开源许可证发布。

## 核心功能解析

### 统一游戏库体验
Unifideck 的核心价值在于将分散在不同平台的游戏资源集中管理。插件将 Epic、GOG、Amazon、Ubisoft、Battle.net 和 Xbox 平台的游戏直接整合到 Steam 库界面中，与原生 Steam 游戏并排展示，支持以标签页形式浏览不同平台的内容。这种集成方式彻底消除了玩家在桌面模式和各平台独立启动器之间来回切换的繁琐流程。

### 无缝安装与启动
游戏安装过程和 Steam 原生游戏完全一致。玩家在游戏详情页点击"安装"按钮，即可实时查看安装进度，完成后直接点击"播放"启动游戏——整个过程均在 Gaming Mode 中完成，无需切换到桌面模式。Unifideck 支持自定义安装位置，玩家可根据需求选择内部存储、SD 卡或任意自定义路径。

### Proton 兼容层自动配置
对于 Windows 平台的游戏，Unifideck 自动配置最新版本的 Proton 兼容层，确保大多数游戏开箱即用。面对特定兼容性问题的游戏，玩家可通过 Steam 原生的"兼容性"菜单手动指定 Proton 版本，获得更精细的控制。

### 丰富的游戏元数据
插件自动抓取游戏封面图、图标、Metacritic 评分以及 Steam Deck 兼容性评级，使非 Steam 平台的游戏在视觉效果和信息完整度上与原生 Steam 游戏保持一致，提供了统一且高质量的浏览体验。

### 云存档同步
Unifideck 支持 Epic 和 GOG 平台的云存档功能，自动同步游戏进度至对应商店的云端服务，实现多设备间的进度无缝衔接。当本地存档与云端版本不一致时，系统会主动提示玩家，避免数据冲突或丢失。

## 技术架构与实现

### 前端技术栈
插件前端采用 React 和 TypeScript 构建，集成 Decky Loader 的 UI 组件库，使用 i18next 实现国际化支持。目前支持包括英语、法语、巴西葡萄牙语、俄语、日语、德语、西班牙语、意大利语、简体中文、韩语、荷兰语、波兰语、土耳其语和乌克兰语在内的 14 种语言界面。

### 后端架构
后端采用 Python 编写，基于 Decky Loader 的 RPC 机制，构建了五层架构体系。核心组件包括：
- **事件总线（EventBus）**：处理模块间的异步通信
- **依赖注入核心**：提高代码可维护性和可测试性
- **基于 CDP 的认证模块**：实现安全的浏览器登录流程
- **存储工具集成**：整合 legendary、gogdl、nile、comet 等命令行工具

### 安装要求
使用 Unifideck 需要预先安装 Decky Loader，且系统需具备 Microsoft Edge 浏览器——这是商店登录和 Xbox 云游戏功能的基础依赖。其他商店的 CLI 工具和辅助软件均已打包在插件内，无需用户单独安装。

## 使用指南与注意事项

### 快速上手流程
1. 从 Releases 页面下载最新插件 ZIP 文件
2. 打开快捷访问菜单，进入 Decky 设置，启用开发者模式
3. 通过"从 ZIP 安装插件"功能完成安装
4. 在快捷访问菜单中启动 Unifideck，连接所需商店账号
5. 设置默认安装位置（内部存储、SD 卡或自定义路径）
6. 执行"同步库"或"强制同步"操作
7. 按提示重启 Steam，使新快捷方式和封面图生效

### 已知功能限制
- 插件会替换 Steam 默认的"所有游戏"、"已安装"和"Great on Deck"标签页，部分排序和过滤功能可能受影响
- 需在 Steam 重启后才能完全刷新游戏库
- Xbox 云游戏仅支持串流方式，依赖 Edge 浏览器
- 云存档功能目前仅覆盖 Epic 和 GOG 平台，且各游戏支持程度存在差异
- Proton 版本和启动选项需通过 Steam 原生快捷方式属性配置，插件内不提供选择器

### 常见问题排查

**安装卡住**：卸载当前版本后重新安装最新 ZIP。这曾是 0.6.0 至 0.6.1 版本升级时官方推荐的解决方案。

**游戏或封面不显示**：执行"强制同步"后重启 Steam。

**Epic 登录白屏**：先在普通浏览器中登录 Epic 账号，接受所有待处理的法律更新，再在插件中重试。

**Ubisoft 游戏登录或密钥问题**：确保 Epic 和 Ubisoft 账号已关联，必要时清理认证缓存和游戏前缀文件夹。

## 日志与调试支持

Unifideck 提供完善的日志系统。最便捷的方式是在插件的快捷访问面板中使用"捕获日志"功能，一键收集所有日志和状态文件，生成包含设备信息和文件位置的压缩包，直接附加到问题报告中。该功能不会收录密码、商店登录令牌或浏览器 cookies，确保用户隐私安全。

## 开发与社区生态

### 构建与贡献指南
项目支持多种开发流程：生产构建使用 `./build-plugin.sh prod`，开发构建支持自动递增构建号，还提供了快速同步功能的 `dev quick-install` 命令。完整的代码质量保障体系包括前后端测试、覆盖率报告和类型检查。

### 致谢的开源项目
Unifideck 构建在众多优秀开源项目之上：Decky Loader 提供平台支持，legendary、gogdl、nile 等工具处理商店对接，TabMaster、SteamGridDB Decky、Heroic Games Launcher 等项目提供了重要参考。

## 项目定位与展望

Unifideck 作为非官方的第三方工具，与 Valve、Epic Games、CD Projekt、Amazon、Ubisoft、Blizzard 和 Microsoft 均无官方关联。它代表了 Steam Deck 社区对更开放、更统一游戏体验的追求，通过整合多平台资源，显著提升了掌机的实用性和玩家体验。随着云游戏和跨平台趋势的发展，Unifideck 这类工具的价值将持续增长，为玩家提供更自由、更便捷的游戏方式。