Steam 图标修复工具（Steam Icon Fixer）

使用此技能修复 Linux 桌面环境下 Steam 启动器图标。

核心工作流程

1. 优先使用用户显式提供的输入（如存在）：
   • 已下载图像的路径
   • 游戏名称
   • Steam app ID
   • 特定的 .desktop 文件
2. 否则，推断常见的本地路径位置：
   • 启动器目录：${XDG_DATA_HOME:-~/.local/share}/applications
   • 图标目录：${XDG_DATA_HOME:-~/.local/share}/icons/hicolor
3. 从启动器元数据中识别 app ID：
   • 查找 Icon=steam_icon_
   • 查找 Exec=...steam://rungameid/
   • 必要时，按游戏名称在本地启动器中搜索
4. 运行内置的安装脚本。
5. 若脚本未自动刷新图标缓存，则手动刷新。

命令

扫描本地 Steam 启动器中缺失图标的项目：

python3 scripts/steam_icon_fixer.py scan

使用显式指定的 app ID 安装图像：

python3 scripts/steam_icon_fixer.py install 
  --image /path/to/image.png 
  --app-id 1086940

通过匹配游戏名称安装图像：

python3 scripts/steam_icon_fixer.py install 
  --image /path/to/image.png 
  --game "Baldur's Gate 3"

使用指定的桌面文件安装图像：

python3 scripts/steam_icon_fixer.py install 
  --image /path/to/image.png 
  --desktop-file ~/.local/share/applications/Baldur's Gate 3.desktop

在非标准系统上，显式指定目录路径：

python3 scripts/steam_icon_fixer.py install 
  --image /path/to/image.png 
  --game "DOOM: The Dark Ages" 
  --desktop-dir /custom/applications 
  --icons-dir /custom/icons/hicolor

内置资源

• scripts/steam_icon_fixer.py：用于 Steam 启动器图标的确定性安装器／扫描器。
• references/：若工作流程需针对特定机器提供指导，可在此目录中添加启动器或图标主题相关说明。

注意事项

• 脚本应生成标准尺寸的图标，并保持 Steam 原有的 steam_icon_.png 命名格式。
• 若输入为 .ico 格式图像，可能需要安装 Pillow 库。
• 若 GNOME 或其他 Dock 应用仍显示旧图标，请在刷新图标缓存后，先取消固定（unpin）再重新固定（re-pin）该启动器。