itch 自动化进阶：让游戏安装和启动从手动变成一次配置永久生效

项目	内容
软件	itch
版本	1
平台	Android APK
体积	20.66M
分类	游戏工具
包名	com.newh5itch
官网	itch 官网
下载一	itch 下载，itch 下载
下载二	itch 下载，itch 下载
文档	itch 文档
介绍	从 itch 内建的协议链接、启动选项、自动更新三项自动化能力出发，盘点哪些值得交给机器、哪些不值得，以及自动化失效时怎么快速救回来。

itch 是什么，以及为什么要折腾它的自动化

itch 是一个跨平台的独立游戏分发客户端，桌面端覆盖 Windows、macOS、Linux，游戏从 HTML5 网页版到原生可执行文件都有。客户端本身是 Electron + JavaScript 搭的 UI，底层用 Go 写原生助手，全部开源。和网页端不同，客户端必须登录才能用——但换来的是安装、更新、库管理这些事都能在本地自动处理。

我开始扒它的自动化能力，起因很实际：某天早上我连续装了五六个小游戏做体验，每个都要点「安装」→ 等进度条走完 → 再点「启动」，还要在偏好设置里切不同的安装位置。装完之后发现它们默认没带全窗口参数，又挨个进管理菜单加启动选项。这套流程重复三遍之后我翻了翻官方文档，发现 itch 其实内建了几条让你「设一次就不用再管」的通道——只是默认藏得比较深。

itch 内建的三条自动化通道

先说 itch 给你留了哪些自动化钩子。官方文档把它定位成「能当自动化组件用的桌面客户端」，不是空话。

第一条是 itch:// 协议链接。安装客户端时它会向系统注册 itch:// 和 itchio:// 两种协议，任何地方——浏览器地址栏、聊天工具、命令行——打开这类链接，应用就被拉到前台执行对应动作。动作类链接只做对话框触发，不会静默执行，比如 itch://install?game_id=12345&launch 是打开安装对话框并勾好装完启动，但最终确认还是你点；导航类链接直接打开页面，比如 itch://library/installed 跳已安装库、itch://downloads 跳下载页。命令行调用也很直接，Windows 下 start "" "itch://install?game_id=12345&launch" 就行，Linux 用 xdg-open，macOS 用 open。这条通道的好处是不用打开 itch 客户端界面，从脚本或其他应用里就能触发它的动作。

第二条是 每游戏独立的启动选项。在游戏右键菜单的「管理」区域有一个 Launch options 输入框，支持三种 shell 风格语法直接组合：附加参数原样传给游戏（比如 --fullscreen）、用 %command% 占位符套包装器（比如 mangohud %command% 叠加帧率显示层）、用 名字=值 开头注入环境变量（比如 MANGOHUD=1 mangohud %command% --fullscreen）。%command% 必须是独立词、至多出现一次，解析规则跟 shell 一致——含空格的参数要加引号。这套配置是每游戏独立保存的，设一次之后每次启动自动套用，不用重复输。

第三条是 自动更新。客户端自身在 Windows 和 macOS 上自动更，Linux 走包管理器，不用你操心。游戏更新是启动时检查一次，之后每三十分钟一轮后台检查，检测到新版本自动下载并安装。这项默认就开着，没什么好配置的，但知道它在跑能省掉手动点刷新的习惯。

还有一条没写进自动化通道的：把 itch 游戏做成 Steam 快捷方式时，Linux 上会自动配置 Proton 兼容层，Steam 那边的启动选项和 Proton 设置会自动跟过去——这条是 Steam 侧的联动，不是 itch 主动做的自动化，但配合起来很顺手。

值得自动化的两件事

从这三条通道里，我挑出两个频率够高、步骤够固定、收益够明确的场景。

场景一：从浏览器或命令行直接触发游戏安装并启动。 如果你经常在 itch.io 网页上逛到新游戏、想立刻装来试玩，来回切换浏览器和客户端点确认是很机械的操作。配置路径很简单：在浏览器里装一个自定义搜索插件，把 itch.io 的游戏页 URL 解析出 game_id，然后拼成 itch://install?game_id=<id>&launch 的协议链接，点一下就自动拉客户端、弹安装框、勾好装完启动。或者更狠一点，写个 PowerShell 小脚本，把剪贴板里的 itch.io 游戏 URL 自动转成协议链接——复制 → 运行 → 确认，三步完成原来五六步的事。这里的前提是你必须已经登录了 itch 客户端，否则链接会被保存、登录后才继续执行，这点文档里提醒过。

场景二：给某类游戏批量套统一的启动参数。 比如你手头有七八款 Linux 原生游戏都需要 mangohud 叠帧率显示，挨个进管理菜单输 MANGOHUD=1 mangohud %command% 很烦。itch 没有全局启动选项——这是它自动化能力的一个缺口——但可以绕过去：把那几款游戏全加进一个集合，然后用命令行循环给每款游戏的启动选项赋值。具体来说，用 PowerShell 的 Invoke-WebRequest 或直接调 itch 没有公开但稳定的本地配置 JSON 文件（位于安装位置的缓存目录里），批量写相同的启动选项字符串。这条路走的是非官方通道，但 itch 的配置 JSON 结构自 2020 年以来没大变过，风险可控。如果你不想碰内部文件，退而求其次：把你常用的包装器参数存成一个文本文件模板，每次进游戏管理界面复制粘贴——这已经比每次从零输快了。

不值得自动化的事

也有几件事我试过之后决定还是手动来，说清为什么。

跨平台安装的「仍然安装」判断不值得自动化。 itch 的安装对话框默认只显示当前平台兼容的构建，被折叠的版本点「显示全部下载」能看到，装非本平台版本时按钮会变成「仍然安装」并附警告。理论上你可以写脚本自动展开全部下载、挑非本平台的、触发 Install anyway 按钮——但风险是独立游戏的跨平台运行成功率极不稳定，Wine 和 Proton 能兜住一些，但不是全部。自动化触发一个「可能跑不起来」的安装，还不如手动挑你确定 Wine 能跑的那几款。

Steam 快捷方式的创建不值得自动化。 itch 能把游戏一键做成 Steam 快捷方式，Linux 上还自动配 Proton——但 Steam 侧的体验已经很好了，快捷方式创建本身就是一次点击的事，自动化省不了几步，反而要处理 Steam 没开、Steam 路径变了等边界情况，收益太小。

HTML5 网页游戏的启动选项不值得折腾。 itch 文档明确说了，启动选项只对原生可执行文件生效，网页游戏跑在内置浏览器里没有进程命令行，包装器和环境变量都套不上。硬要给网页游戏加帧率显示层，等于在内置浏览器外面再套一层，麻烦不说还容易崩溃。这类游戏直接手动启动就行。

自动化失效时怎么救

自动化不是银弹，得知道什么时候它没跑起来、怎么快速救回来。

itch:// 协议没反应。 先看客户端是不是在运行——协议链接只会在客户端启动时注册到系统。如果客户端在后台但还是没反应，打开 itch://applog 看应用日志，文档里说这是排障入口。再不行就把协议链接换成命令行调用的方式（Windows 下 start "" "itch://..."），绕过系统协议注册这层。

启动选项没生效。 打开游戏管理界面的 Launch settings，确认 %command% 只出现了一次、没有拼错词。如果用了包装器（mangohud 这类），先在命令行单独跑一遍 mangohud <游戏路径> 看包装器本身能不能工作——包装器挂了 itch 这边没问题也是白搭。环境变量前缀的写法要注意 = 两边不能有空格，有空格就变成参数名了。

自动更新停了。 客户端自身没更的话，Windows 上手动触发一下偏好设置里的检查更新按钮，macOS 和 Linux 分别走系统的软件更新和包管理器。游戏更新没自动跑的话，右键游戏 → 检查更新，手动触发一次；如果反复不更，看应用日志有没有报下载失败或路径权限问题——游戏装在只读目录里的话自动更新肯定挂，这是我踩过的坑。

杀软误报拦截。 这是 itch 官方 FAQ 里专门列的高频问题。Windows Defender 偶尔会把 itch 的原生助手进程当成可疑文件拦掉，表现就是安装失败、启动选项失效、自动更新卡壳。排查方法：临时关掉杀软实时保护试一次，确认是杀软的问题就把 itch 的安装目录加白名单。文档里有专门的杀毒软件冲突排查页，按那个来就行。

这套自动化能力适合谁

说穿了，itch 的自动化通道都是为「重度用户但不想折腾 Steam 的人」准备的。如果你一个月装不超过五六个独立游戏、每款玩一两个小时就删，那默认的点击流程够用，不值得花时间折腾协议链接和批量启动参数。但如果你手上有二十款以上的常驻游戏、每款都要配不同的包装器和参数、还经常从网页端发现新游戏想立刻试玩，那协议链接加启动选项这两条通道能把你每周花在安装和启动配置上的时间砍到原来的三分之一。

有一点要说清楚：itch 的自动化能力跟 Steam 比确实弱一截——没有全局启动选项、没有官方 CLI、内部配置 JSON 结构自维护但没文档。所以我不会推荐你把全部流程都自动化，只把那两件频率最高、收益最明确的事交给机器，剩下的手动来。自动化的目的是省重复劳动，不是让你变成脚本奴隶。

总结下来，itch 给的自动化钩子够用但不豪华，挑对场景上能省不少事，硬要全覆盖反而徒增维护成本——这个度才是「自动化进阶」的核心，不是按钮越多越好。

本文为个人基于网络公开资料整理编写，非官方内容，仅供学习交流参考；软件版权归原作者所有，请支持正版；使用过程中遇到问题请查阅官方渠道，本文不承担任何责任。