PC 端游戏包体上传工具

TapRails 是 TapTap 平台提供的 PC 游戏包体上传工具，用于将 PC 端游戏包体上传至 TapTap 开发者中心。支持 Windows、macOS 和 Linux 系统，提供命令行界面，支持大文件分片上传。

环境要求

• 操作系统：Windows 7 或更高版本、macOS、Linux
• 文件格式：支持 .7z、.zip 格式的游戏包体
• 文件命名：仅支持字母、数字、下划线(_)、中横线(-)和点号(.)

准备工作

1. 获取开发者资源

在开始使用前，您需要：

1. 在 TapTap 开发者中心 注册开发者账号
2. 创建游戏应用并在「你的游戏」→「游戏服务」→「应用配置」获取以下信息：
   • App ID：应用的 ID
   • Client ID：应用的唯一标识符
   • Server Secret：用于 server to server API 调用的密钥

2. 下载工具

1. 访问 TapRails Releases 页面
2. 根据您的操作系统选择对应的版本：
   • Windows: taprails-windows-amd64.zip
   • macOS (Intel): taprails-darwin-amd64.zip
   • macOS (Apple Silicon): taprails-darwin-arm64.zip
   • Linux: taprails-linux-amd64.zip
3. 解压工具包到对应目录

使用说明

1. 配置文件

参考 config.example.json 配置创建 config.json 配置文件：

{
  "app_id": 12345,
  "client_id": "从开发者中心「游戏服务」→「应用配置」获取的 client_id",
  "server_secret": "从开发者中心「游戏服务」→「应用配置」获取的 server_secret",
  "chunk_size": 104857600
}

配置项说明：

• app_id：应用 ID，从开发者中心获取
• client_id：Client ID，从开发者中心 「游戏服务」→「应用配置」获取
• server_secret：服务端密钥，从开发者中心 「游戏服务」→「应用配置」获取
• chunk_size：分片上传的分片大小，单位字节，默认 100MB (104857600)

3. 命令行使用

# 基本用法
./taprails-cli upload --file /path/to/game.7z --package-version 1.0.0 --config config.json

# 显示详细日志
./taprails-cli upload --file /path/to/game.zip --package-version 1.0.0 --config config.json --verbose

4. 参数说明

参数	缩写	必传	说明
--file	-f	✅	游戏包体文件路径 (.7z/.zip 格式)
--package-version	-p	✅	游戏包体版本号 (必须符合 semver 规范)
--config	-c	✅	配置文件路径
--verbose	-v	❌	显示详细日志

版本号规范

版本号必须符合 语义化版本控制 (semver) 规范。

输出示例

成功上传

Uploading large-game.7z (250.25 MB) for app[12345]...
Getting upload token...
Uploading file...
Using multipart upload (file size: 250.25 MB, chunk size: 100.00 MB)
Uploading chunks [████████████████████████████████████░░░░░░░░░░░░░░] 66.7% (2/3)
Completing multipart upload...
File uploaded successfully

常见问题

配置相关

• 验证 app_id 是否有效
• 检查 client_id 和 server_secret 是否正确
• 检查分片大小是否过大