Steam 游戏白图标一键修复软件下载及介绍

Steam 游戏白图标一键修复软件

Steam 图标修复工具是一个用 Python 编写的程序，主要用于修复 Steam 创建的桌面快捷方式图标丢失的问题，在重装系统或将已有游戏迁移到新电脑上时非常实用。

确保本地搭建好 Python 开发环境，开发和测试使用的是 Python 3.9 和 3.12 版本。
切换到代码目录，使用 Conda、Virtualenv 等工具创建虚拟环境。
激活虚拟环境，在代码目录下运行 “pip install -r requirements.txt” 安装依赖项。
修改功能：
- 若要改变核心功能，修改 main.py 文件。
- 修改 iputils.py 文件可改变检测 IP 地址的方式和返回的显示语言类型。
- 翻译人员可修改 icon_translations.py 来添加或修改翻译。
修改完成后，运行 “python main.py” 测试效果。
若需要，运行 “rebuild_icon_cache.bat” 重建图标缓存。

语言检测：开始修复前，程序会利用 IP 地址查询的 API（优先使用国内服务器 / 使用国外服务器作为回退）检测公共 IPv4 地址所在的大概国家或地区，然后根据规则使用不同的显示语言。目前支持简体中文（中国大陆地区）、繁体中文（中国香港 / 澳门特别行政区和中国台湾地区）和英语（其他国家和地区）。
Steam 安装目录扫描：
- 程序首先按盘符字母顺序自动扫描默认的 Steam 安装目录（每个盘符下的 “Program Files (x86)/Steam”、“Program Files/Steam”、“Steam” 文件夹），若找到 steam.exe 文件，则将其所在目录作为 Steam 安装目录。
- 若未在默认目录下发现 Steam 安装，需要用户手动指定 Steam 的安装目录（即 steam.exe 文件所在文件夹），并进行校验直到找到 steam.exe 文件。
游戏 APPID 获取：程序会自动扫描 Steam 安装目录下 steamapps 文件夹中的 Steam 库配置文件 libraryfolders.vdf（保存 Steam 库的位置和游戏的 APPID），并读取所有游戏的 APPID。若该文件损坏，则无法修复。
图标下载：扫描完成后，程序会按照 APPID 检测 Steam 安装目录下 steam/games 文件夹中对应的游戏图标是否已经存在，若存在则跳过，否则在 Steam 网站上查询游戏的客户端图标并下载，每个程序最多尝试 5 次，下载完成后会提示状态。

如果使用的代理服务器软件在设置系统代理时没有明确标明其使用的协议类型，urllib 会默认代理服务器使用的协议类型和访问时提供的 URI 的协议相同。若代理服务器软件不支持 HTTPS 和 FTP 代理协议，访问 HTTPS 和 FTP 网站的请求会因握手失败而无法发送到代理服务器。