OpenSteamToolDesktop

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

OpenSteamToolDesktop

★ 22 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">OpenSteamTool-Desktop</h1>

基于 <a href="https://github.com/OpenSteam001/OpenSteamTool">OpenSteamTool</a> 的 Steam 游戏库管理桌面工具 
 Windows 11 Fluent Design 风格 GUI，一站式游戏解锁与管理体验

<a href="README_EN.md">English</a>

---

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

---

## 下载

前往 [Releases](https://github.com/yong0512/OpenSteamToolDesktop/releases) 页面下载最新版本。

---

## 目录

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

---

## 功能概览

| 功能             | 说明                                                  |
| -------------- | --------------------------------------------------- |
| **注入管理**       | 一键部署/移除 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 安装状态、注入状态和游戏库概览：

![首页](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-13-38-03-image.png)

---

## 使用指南

### 第一步：注入 Steam

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

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

![注入管理](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-13-38-34-image.png)

### 第二步：搜索入库

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

![搜索入库](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-13-38-55-image.png)

### 第三步：管理游戏库

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

![游戏库](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-13-39-06-image.png)

---

## 入库效果

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

![入库后](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-13-49-34-image.png)

---

## 安全软件提示

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

1. 打开 Windows 安全中心

![Windows 安全中心](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-14-16-28-image.png)

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

![管理设置](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-14-27-30-image.png)

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

![关闭实时保护](https://raw.githubusercontent.com/Yong0512/OpenSteamToolDesktop/main/assets/2026-06-03-14-27-05-image.png)

---

## 常见问题

### 注入后 Steam 没有变化？

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

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

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

### 如何卸载注入？

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

---

## 开发者指南

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

### 环境要求

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

### 1. 克隆仓库

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

### 2. 创建虚拟环境

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

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

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

### 3. 安装依赖

```bash
pip install -r requirements.txt
```

主要依赖一览：

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

### 4. 启动调试

```bash
# 直接运行
python main.py
```

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

**调试技巧：**

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

### 5. 使用 IDE 调试

1. 安装 [Python 扩展](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
2. 打开项目根目录
3. 选择解释器：`Ctrl+Shift+P` → `Python: Select Interpreter` → 选择 `.venv` 中的 Python
4. 按 `F5` 启动调试，或在 `launch.json` 中添加配置：

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

</details>

<details>
<summary>PyCharm</summary>

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

</details>

### 6. 运行测试

```bash
# 运行全部测试
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. 打包构建

```bash
# 安装打包工具
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](https://github.com/OpenSteam001/OpenSteamTool) 为开源项目。

---

## Star 走势

[![Star History Chart](https://api.star-history.com/svg?repos=yong0512/OpenSteamToolDesktop&type=Date)](https://star-history.com/#yong0512/OpenSteamToolDesktop&Date)

---

Made with ❤️ for the Steam community

OpenSteamToolDesktop

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README