OpenSteamToolDesktop

KO | EN

gitlite — search

#ai #machine-learning #rust #deep-learning #macos #nodejs #windows #cli #kubernetes #pytorch #security #ios #openai #open-source

OpenSteamToolDesktop

(★ 22)

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

OpenSteamToolDesktop Latest Version Download

Download Latest Version (.zip)

// 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

OpenSteamToolDesktop Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

OpenSteamToolDesktop

OpenSteamToolDesktop Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README