Itch.io Butler 开源项目安装与使用指南

1. 项目目录结构及介绍

Itch.io Butler 是一个由 itch.io 平台开发的命令行工具，主要用于自动部署游戏或软件到itch.io平台。以下是其典型的项目目录结构概述：

butler/
├── bin/                 # 包含可执行文件，如butler二进制文件。
├── cmd/                 # 存放各个命令的实现代码，每个子目录对应一个命令逻辑。
├── config/              # 可能用于存放内部配置模板或示例配置文件。
├── doc/                 # 文档目录，可能包括API说明、开发者文档等。
├── internal/            # 内部使用的库和模块，不对外暴露。
├── pkg/                 # 包装好的各种工具或服务相关的代码。
├── LICENSE              # 许可证文件，描述了项目使用的许可证类型。
└── README.md            # 项目的主要说明文件，通常包含快速入门和基本说明。

请注意，实际的目录结构可能会随着项目的更新而有所变化。

2. 项目的启动文件介绍

Butler项目的“启动文件”实际上指的是运行Butler的入口点，一般位于bin目录下的butler脚本或者可执行文件。在开发环境中，这可能是通过Go语言编译生成的butler二进制文件。用户无需直接编辑这个文件，而是通过命令行调用来使用Butler的不同功能，例如上传游戏更新或管理发布。

基本使用命令范例：

butler upload <game-path> <itch-channel>

3. 项目的配置文件介绍

Butler主要依赖于命令行参数来执行操作，而不是传统意义上的本地配置文件。这意味着大多数设置是在每次调用时直接提供的。然而，为了重复任务的便利性，用户可以创建自己的脚本或者利用环境变量来存储这些参数，间接实现配置管理。

对于复杂的自动化流程，建议查阅Butler的官方文档，了解如何结合环境变量或其他外部脚本管理认证信息和常规参数。

示例环境变量设置（非直接配置文件）:

export BUTLER_API_KEY="your_api_key"

然后在命令中直接使用而不需每次输入API密钥。

总结，Butler设计上强调轻便和通过命令行交互，减少对配置文件的依赖，使得其更适合作为快速部署工具。确保查看GitHub仓库中的README.md文件获取最新和详细的使用指令。