OpenSteamTool-Desktop

基于 OpenSteamTool 的 Steam 游戏库管理桌面工具
Windows 11 Fluent Design 风格 GUI，一站式游戏解锁与管理体验

English

---

⚠️ 仅支持 Windows 10 / Windows 11 64 位系统，需要已安装 Steam 客户端并登录。不支持 macOS / Linux。

---

下载

前往 Releases 页面下载最新版本。

---

目录

• 功能概览
• OpenSteamTool 底层能力
• 首页概览
• 使用指南
• 入库效果
• 安全软件提示
• 常见问题
• 开发者指南
• 免责声明
• 开源许可

---

功能概览

功能	说明
注入管理	一键部署/移除 OpenSteamTool DLL，三层验证确保注入状态准确，支持快捷重启 Steam
游戏搜索入库	按 AppID 或英文名称搜索 Steam 游戏，自动获取元数据并生成入库配置
DLC 全解锁	自动识别游戏关联的 DLC 列表，一键全部入库
Depot 解密密钥	自动获取每个加密 Depot 的专属解密密钥，确保游戏内容可正常下载
游戏库管理	卡片式浏览已入库游戏，支持排序、搜索、右键快捷操作（查看/复制/出库）
版本自动更新	启动时自动检测 GitHub Release 最新版本，确保始终使用最新版本

---

OpenSteamTool 底层能力

OpenSteamTool 是通过 DLL 注入 Steam 客户端的 C++ 引擎，本工具为其提供图形化管理界面。注入后可实现：

能力	说明
游戏解锁	解锁未拥有的游戏及其全部 DLC
Depot 解密	自动注入 Depot 解密密钥，支持游戏文件正常下载
Manifest 下载	自动下载 Depot Manifest，支持锁定特定版本防止自动更新
Access Token	支持需要访问令牌的受保护游戏/DLC
统计与成就	为未拥有游戏启用 Steam 统计和成就系统
热重载	Lua 配置文件修改后自动生效，无需重启 Steam

---

首页概览

启动后自动检测 Steam 安装状态、注入状态和游戏库概览：

---

使用指南

第一步：注入 Steam

1. 进入「注入管理」页面
2. 点击 「注入 Steam」 按钮
3. 重启 Steam 客户端即可生效

如果 Steam 正在运行，程序会自动提示关闭后继续。

第二步：搜索入库

1. 进入「搜索入库」页面
2. 输入游戏 AppID（如 730 = CS2）或英文游戏名
3. 点击 「入库」，系统自动获取元数据、DLC 列表、解密密钥并生成配置

第三步：管理游戏库

1. 进入「游戏库」页面查看所有已入库游戏
2. 支持按名称/AppID 排序和搜索过滤
3. 右键游戏卡片可：复制 AppID、复制游戏名、在 Steam 中查看、出库

---

入库效果

入库成功后，游戏将直接出现在你的 Steam 游戏库中：

---

安全软件提示

如果 Windows 安全中心对程序报毒（DLL 注入行为可能触发误报），请按以下步骤处理：

1. 打开 Windows 安全中心

2. 点击「病毒和威胁防护」→「管理设置」

3. 关闭「实时保护」。Windows 安全中心对 DLL 注入类工具容易产生误报，关闭后可避免程序被拦截影响运行。

---

常见问题

注入后 Steam 没有变化？

请确保已重启 Steam。DLL 注入只在 Steam 启动时生效。可在「注入管理」页面点击「验证注入」检查状态。

游戏入库后提示「内容仍处于加密状态」？

部分 Depot 缺少解密密钥时会触发此提示。系统已自动获取解密密钥，如果仍有问题，请检查网络连接是否正常。

如何卸载注入？

在「注入管理」页面点击「移除注入」，然后重启 Steam。也可以手动删除 Steam 根目录下的三个 DLL 文件。

---

开发者指南

本项目为开源项目，欢迎参与开发与调试。以下是本地搭建开发环境的步骤。

环境要求

依赖	版本要求
操作系统	Windows 10 / 11（64 位）
Python	3.10+（推荐 3.12 或 3.13）
Steam 客户端	已安装并登录
Git	任意版本

1. 克隆仓库

git clone https://github.com/yong0512/OpenSteamToolDesktop.git
cd OpenSteamToolDesktop

2. 创建虚拟环境

# 在项目根目录创建 .venv
python -m venv .venv

# 激活虚拟环境
.venv\Scripts\activate

激活后命令行前缀会显示 (.venv)，表示已进入虚拟环境。

3. 安装依赖

pip install -r requirements.txt

主要依赖一览：

包名	用途
PyQt6	GUI 框架
PyQt6-Fluent-Widgets	Windows 11 Fluent Design 组件库
httpx	HTTP 客户端（API 请求、封面下载）
requests	备用 HTTP 客户端
pytest	单元测试

4. 启动调试

# 直接运行
python main.py

程序启动后会自动：

• 检测 Steam 安装路径（注册表）
• 检查 DLL 版本并自动下载（如缺失）
• 检查应用版本更新
• 加载游戏库

调试技巧：

• 日志文件位于 ~/.OpenSteamToolDesktop/logs/main.log，启动时实时查看可快速定位问题
• 配置文件位于 ~/.OpenSteamToolDesktop/config.json
• DLL 缓存位于 ~/.OpenSteamToolDesktop/DLL/
• Lua 配置文件位于 ~/.OpenSteamToolDesktop/config/lua/

5. 使用 IDE 调试

VS Code

1. 安装 Python 扩展
2. 打开项目根目录
3. 选择解释器：Ctrl+Shift+P → Python: Select Interpreter → 选择 .venv 中的 Python
4. 按 F5 启动调试，或在 launch.json 中添加配置：

{
    "name": "OpenSteamToolDesktop",
    "type": "python",
    "request": "launch",
    "program": "${workspaceFolder}/main.py",
    "console": "integratedTerminal",
    "justMyCode": false
}

PyCharm

1. File → Open 打开项目根目录
2. File → Settings → Project → Python Interpreter → 选择 .venv\Scripts\python.exe
3. 右键 main.py → Debug 'main' 即可断点调试

6. 运行测试

# 运行全部测试
pytest

# 运行单个测试文件
pytest tests/test_game_manager.py

# 显示详细输出
pytest -v

7. 项目结构

OpenSteamToolDesktop/
├── main.py                  # 应用入口
├── config.py                # 全局配置常量（URL、颜色、HTTP 等）
├── requirements.txt         # 运行时依赖
├── build_exe.py             # 打包脚本（PyInstaller / Nuitka）
├── OpenSteamToolDesktop.spec # PyInstaller 配置
├── core/                    # 核心业务逻辑
│   ├── steam_bridge.py      #   Steam 桥接（DLL 管理、注入）
│   ├── game_manager.py      #   Lua 游戏配置生成与管理
│   ├── metadata_fetcher.py  #   Steam 元数据获取
│   ├── dll_manager.py       #   DLL 下载与版本管理
│   ├── dll_injector.py      #   DLL 注入与验证
│   ├── version_checker.py   #   应用版本检查
│   └── ...
├── gui/                     # 界面层
│   ├── main_window.py       #   主窗口
│   ├── home_page.py         #   首页
│   ├── search_page.py       #   搜索入库页
│   ├── library_page.py      #   游戏库页
│   ├── inject_page.py       #   注入管理页
│   ├── accelerate_page.py   #   科学加速页
│   └── widgets/             #   自定义控件
├── utils/                   # 工具模块
│   ├── http_client.py       #   统一 HTTP 客户端
│   ├── async_worker.py      #   QThread 异步任务封装
│   ├── logger.py            #   日志模块
│   └── ...
├── resources/               # 静态资源
│   └── fallback_dlls/       #   内置兜底 DLL
├── assets/                  # 截图、图标
└── tests/                   # 单元测试

8. 打包构建

# 安装打包工具
pip install pyinstaller

# PyInstaller 打包（默认，生成 dist/ 目录 + Zip 包）
python build_exe.py

# Nuitka 编译打包（C++ 编译，代码保护更强）
python build_exe.py --nuitka

# 仅清理构建产物
python build_exe.py --clean

# 打包但不生成 Zip
python build_exe.py --no-zip

打包产物位于 dist/ 目录，同时会在项目根目录生成 OpenSteamToolDesktop-{版本号}.zip。

---

免责声明

本项目仅供学习和研究使用。请遵守以下原则：

• 本工具不提供游戏下载功能
• 请尊重游戏开发者的劳动成果，支持正版
• 使用本工具产生的任何后果由使用者自行承担
• 禁止将本工具用于任何商业用途

---

开源许可

本项目基于底层引擎 OpenSteamTool 为开源项目。

---

Star 走势

---

_{Made with ❤️ for the Steam community}