应用清单文件：.itch.toml 定义启动动作与前置依赖

应用清单（app manifest）是一个放在构建顶层目录的 .itch.toml 文件，用来告诉客户端「这个软件该怎么启动、缺什么依赖、要什么权限」。没有它，客户端靠启发式猜测可执行文件；有它，一切按你声明的来。

清单能声明什么

• 启动动作：一个或多个（play 之外还能加编辑器、文档、外部链接等条目），可按平台区分，可带参数，可选择加入沙盒。
• API 权限：申请作用域，让软件在启动时拿到临时 itch.io API 密钥（见 游戏内 API 集成）。
• 前置依赖：声明启动前要装好的运行库，客户端自动处理——支持 VC++ 运行时、.NET、XNA Framework、DirectX 这些常见项。

最小示例

[[actions]]
name = "play"
path = "FooBar.exe"

[[prereqs]]
name = "vcredist-2010-x86"

两段话的意思：启动动作叫 play，执行 FooBar.exe；启动前确保 VC++ 2010 x86 运行库已安装。name 为 play 的动作会成为默认启动项。

什么时候该用清单

• 启动入口有多个（游戏 + 编辑器 + 工具集）。
• 需要特定运行库，不想让玩家手动装。
• 要接 API 集成，或希望明确选择沙盒行为。

什么时候不该用

官方有一句很直白的提醒：「启动了错误的东西」通常不是发布清单的好理由——那是启发式没认对你的目录结构，先走排障流程（游戏启动失败排查）理清结构，再考虑清单。字段级的完整定义在官方的 butlerd 类型文档里，本文不重复。