跳到主要内容

快速入门指南

提示

您可以参考往年的快速入门视频。

下载前端、后端和 SDK​

  • 前端：提供图形化界面，展示回放中的比赛情况。
  • 后端：作为服务器，控制比赛进行，并生成比赛回放。
  • SDK：是若干不同编程语言的程序文件，提供编写比赛程序所需的接口。选手可以选用 C++ SDK 或 Python SDK 编写程序。

请从此链接下载最新版本（Latest）的前端（client）、后端（server）和 SDK，以便开始使用开始编写比赛程序。下载完成后，解压文件至您的工作目录。

提示
  • 务必根据您的操作系统版本选择适当的版本。例如，您的操作系统为 Windows 11，您应该下载 thuai-8-client-StandaloneWindows64.zip 和 thuai-8-server-windows-x64.zip。
  • github 中的 releases 会折叠一部分 Assets，若您没有找到对应的版本，请点击 show all assets。
  • 若您在运行后端的可执行文件出现了闪退或报错等情况，可能是因为您没有安装 .NET Core 运行时环境。请根据您的操作系统版本下载并安装 .NET Core 运行时环境，版本至少为 8.0。可使用如下 Windows 下载地址：.NET Core

编写比赛程序​

配置好代码环境后，选手需要使用提供的 SDK 编写比赛程序，根据战场形势决定最优策略。选手的所有逻辑包括条件判断、动态的检测与决策等都必须在代码中完成，一旦开始对战就无法通过任何形式（如命令行）改变逻辑或手动输入命令。

环境配置请参考编写 Agent 文档；详细接口信息请参考 C++ SDK 文档 或 Python SDK 文档。

启动后端和 SDK 程序​

编写或编译完成后，由于后端默认需要 2 个玩家，因此需要同时运行两个 SDK 程序。注意，两个 SDK 程序的 token 必须不同，您可以在命令行中指定 token，也可以在代码中指定。随后启动后端的可执行程序 Thuai.Server.exe，开始比赛。比赛完成后，后端的 data 目录下会生成一个回放文件 *.dat。

使用前端查看回放文件​

打开前端，在 ADD 界面，选择后端生成的回放文件 *.dat，即可查看回放。具体操作请参考前端使用指南。您也可以用修改 .dat 文件属性为 .zip 后解压，然后查看其中的 JSON 文件，以了解比赛的详细信息。

提交代码​

在线评测平台已经上线，各位调试者可以访问 saiblo 平台 将代码提交到我们的比赛服务器，与其他选手进行对战，评测自己精心编写的代码。可在服务器上查看天梯比赛结果。

在提交之前需要先创建团队：

  1. 点击上方的“小组”菜单，进入“第八届人工智能挑战赛”： 步骤 1

  2. 进入初赛： 步骤 2

  3. 创建团队： 步骤 3

  4. 注意创建团队之后在选择 AI 的时候会看不到自己之前提交的 AI。因为之前提交的代码都是以个人身份提交的，而创建团队在初赛只能提交团队 AI。这里我们回到“游戏”菜单，选择切换团队，之后切换到自己的队伍再次提交代码，便可以在初赛中提交。如果你之前利用 saiblo 参加过其他比赛，那么所有比赛的小组都会在这里，请注意不要选错。虽然之前参加过的用不到这条说明 步骤 4 步骤 5

最终应提交一个 zip 文件，其中必须包括所有的代码，目录结构应该类似于下面这样：

cpp_code.zip/
├── src/
│   ├── agent/
│   │   └── ...
│   ├── main.cpp
│   ├── logic.cpp
│   └── ...
├── Dockerfile
└── xmake.lua