more docs available

Author: XiaoKuge

README.md

@@ -4,30 +4,35 @@
 
 ## You Command, AI Conquers
 
+
+
+| 比赛阶段     | 时间                                                         |
+| ------------ | ------------------------------------------------------------ |
+| 初赛：       | 2025年8月1日-8月31日，线上比赛（[报名网站](https://hackathon.scimigo.com/)） |
+| 决赛嘉年华： | 2025年9月13日-9月14日，中国 杭州 [GOSIM AI 大会](https://hangzhou2025.gosim.org) |
+
 **红色警戒：AI 崛起！**《红色警戒》（Red Alert）是一款划时代的即时战略（RTS）游戏，由 Westwood Studios 于 1996 年推出，是经典《命令与征服》（Command & Conquer）系列的重要代表作。游戏构建在架空的冷战背景下，玩家可选择扮演盟军或苏联，通过建设基地、采集资源、调配军队进行激烈对抗。其深度的战术系统与紧凑的游戏节奏在当年引发轰动，至今仍被无数玩家所津津乐道。
 
-对老玩家来说，《红色警戒》不仅是一款锻炼战术与协作的游戏，更承载着一段青春记忆；对新玩家而言，虽然画面与操作显得复古，但其独特的魅力与挑战性依旧吸引着一代又一代的玩家。
+对老玩家来说，《红色警戒》不仅是一款锻炼战术与协作的游戏，更承载着一段青春记忆；对新玩家而言，虽然画面与操作显得复古，但其独特的魅力与挑战性依旧。就这样，《红警》吸引着一代又一代的玩家。
 
 那么，如果把AI引入这款经典游戏会怎样？如果让AI成为你的副官，由你下达命令，AI来征战沙场——**You command, AI conquers**，会不会打开一扇全新的大门？
 
-Red Alert: AI Uprising，红警AI崛起，我们邀你来共同回答这个问题！加入《Code Alert》 AI红警黑客松，开发一个能理解玩家自然语言指令并转化为游戏操作的智能体（Agent）。你就是指挥官，AI就是副官——听你号令，指哪打哪！
+Red Alert: AI Uprising，红警之AI崛起！我们邀你来共同探索！加入《Code Alert》 AI红警黑客松，开发一个能理解玩家自然语言指令并转化为游戏操作的智能体（AI Agent）。你就是指挥官，AI就是副官——听你号令，指哪打哪！
 
 ------
 
 ## 游戏引擎与开发接口
 
 本次大赛基于开源项目 **[OpenRA](link)**，它致力于重构与现代化经典的红警游戏，引擎支持 Windows、macOS 和 Linux 平台，并在玩法上引入诸多现代机制。目前 OpenRA 在 GitHub 上已有超过 15,700 Stars（截至 2025年7月）。
 
-在 OpenRA 基础上，黑客松组委会简化了游戏，仅保留核心单位，并开发了具备开放接口的游戏引擎（[link]），支持通过 Socket 控制游戏，可以进一步封装成C#、Python、RESTful API，甚至 MCP Client 。
-参赛者可自由选择擅长的语言与接口，构建属于自己的 AI Agent。
+在 OpenRA 基础上，黑客松组委会简化了游戏，保留核心单位，并开发了具备开放接口的游戏引擎([GitHub代码仓](https://github.com/OpenCodeAlert/Hackathon2025))，支持通过 [Socket API](https://github.com/OpenCodeAlert/Hackathon2025/blob/main/APIs/socket-apis.md)控制游戏，参赛者可自由选择擅长的语言与接口，可以进一步封装成C#、Python、RESTful API，MCP 工具等，构建属于自己的 AI Agent 。
 
 ------
 
 ## 报名方式
 
-报名入口：[link]
+报名入口：[https://hackathon.scimigo.com/](https://hackathon.scimigo.com/)
 支持个人参赛，也支持组队（由队长报名并提交队员信息）。
-报名成功后，每支队伍将收到专属识别用的 key token，请妥善保管避免被盗用。
 
 ------
 
@@ -38,75 +43,71 @@ Red Alert: AI Uprising，红警AI崛起，我们邀你来共同回答这个问
 | 初赛 | 线上进行         | 8月1日 - 8月31日  | 参赛者组队并下载游戏引擎，通过自然语言指令操控AI智能体通关官方提供的关卡。结果上传至大赛官网评估。 |
 | 决赛 | 杭州 · GOSIM大会 | 9月13日 - 9月14日 | 邀请初赛表现优异的队伍到场参赛，进行现场对战、展示及AI红警世界杯总决赛。 |
 
+## 初赛
 
+初赛的基本方式是由参赛者下载游戏引擎和关卡到本地，开发大语言模型驱动的Agent，执行游戏API，完成关卡的方式进行。
 
-------
+- 初赛的时间是8月1日至8月31日。
+- 初赛关卡由黑客松组织者通过GitHub代码仓提供。【注意】：关卡会在GitHub分期上线，因此，选手可能需要更新其本地软件。组委会预计提供20个左右关卡。
+- 当选手的AI Agent完成某关卡，游戏引擎将生成该关卡的Log文件。选手需将Log文件上传官网。Log文件将作为比赛评分的主要依据。
+- 更加详细的信息，请参考开发者指南文档。
 
-### 初赛
+【注意】：基于开发者的自我修养，**严禁选手更改log文件**。否则，组委会有权取消开发者的比赛资格。
 
-#### 比赛资源获取
+### 比赛资源获取
 
 - [比赛官网][https://hackathon.scimigo.com/]（提供报名信息、日程安排、规则说明、FAQ 等）
-- [游戏引擎与开发文档](https://github.com/OpenCodeAlert/Hackathon2025)
-  - 下载定制版红警游戏引擎
-  - 获取开发接口文档与示例 Agents
-    - [MCP Agents](https://github.com/OpenCodeAlert/Hackathon2025/tree/main/examples/mcp)
-    - [MoFA Agents](https://github.com/OpenCodeAlert/Hackathon2025/tree/main/examples/mofa)
-  - 下载官方设计的 20 个关卡文件（暂定）
-
-#### 比赛任务 (Missions)
-
-开发一个 AI Agent，接收用户输入的自然语言指令，在 20 个关卡中完成任务目标。每当完成一个关卡，游戏将生成一份加密日志，参赛者需上传该日志至官网用于评分，得分将实时公布在 Leader board 榜单。
-
-- Missions Accomplished：已完成关卡数目
 
-- Mission Time：关卡完成时间
-
-- Mission Economy:
+- [游戏引擎与开发文档](https://github.com/OpenCodeAlert/Hackathon2025)
 
-- Mission Kills:
+  - 下载定制版红警游戏引擎
 
-- Mission Casualty:
+  - 获取开发接口文档与
 
-- Mission Building Loss:
+  - 示例 Agents：组委会邀请了两组开发者，用不同的Agent技术开发了简单的示例Agents供大家参考。
 
-   
+    - [MCP Agents](https://github.com/OpenCodeAlert/Hackathon2025/tree/main/examples/mcp)
+    - [MoFA Agents](https://github.com/OpenCodeAlert/Hackathon2025/tree/main/examples/mofa)
 
-- Number of Human Commands: 关卡完成所需要的AI命令
+    【注意】示例Agents仅提供了非常有限的实现。组委会也无意其实现的方式。其唯一目的就是提供参赛者参考，方便参赛者启动自己的项目。组委会鼓励参赛者用
 
-- Number o
+  -  20 个关卡文件（暂定）与游戏引擎在同一软件包中提供。
 
-- Number of AI Actions：关卡完成所需要的API Calls的数量  
 
-#### 关卡设计
+### 指令输入方式
 
-关卡难度从易到难，涵盖多种战术挑战，包括但不限于：单兵控制，小队战术指挥，基地防守与进攻，多单位协调作战等
+初赛阶段的玩家指令将通过文本方式传递给 Agent。
+欢迎尝试语音输入（非必选），如有集成将视为加分项。
 
-#### 评分与日志上传
+### 评分与日志上传
 
 - 游戏自动生成包含关键指标（通关时间、击杀数、战损比等）的加密日志
 - 参赛者将日志与 key token 上传至官网（[link]）
 - 组委会根据评估规则评分并更新排名
 
-#### 指令输入方式
+## 决赛(嘉年华)
 
-初赛阶段的玩家指令将通过文本方式传递给 Agent。
-欢迎尝试语音输入（非必选），如有集成将视为加分项。
+决赛将于 9月13日-14日 在 GOSIM China 大会现场举办。这不仅仅是是进一步的技术比拼，我们更希望将它打造为红警玩家、AI开发者和开源爱好者的盛事（嘉年华）。
 
-------
+- 初赛前六名的团队将受邀参加决赛（嘉年华）阶段的比赛。
 
-### 决赛
+- 组委会将邀请至多两个团队持外卡参加决赛。
 
-决赛将于 9月13日-14日 在 GOSIM China 大会现场举办。除了是技术比拼，我们更希望将它打造为红警玩家、AI开发者和开源爱好者的年度嘉年华。
+- 组委会将承担每队至多两人的食宿。
 
-#### AI红警世界杯
+- 如前六名团队中有团队不能参加决赛阶段的比赛，将依名次从前到后的原则递补。
 
-比赛采取 **2队对战、单循环制**。胜率最高队伍夺冠，如胜率相同则进行加赛。
+  
 
-- 玩家通过**语音输入**指令，指挥 AI Agent 作战
+#### AI红警“世界杯”
+
+决赛比赛原则上采取 **2队捉对厮杀、单循环制**。胜率最高队伍夺冠，如胜率相同则进行加赛。
+
+- 与初赛文本输入的方式不同，参赛者将通过**语音输入**指令。这要求参加决赛的团队在9月1日到9月12日之间开发相应功能。
 - 组委会提供本地部署的 Moxin-7B 模型，实现语音转文字支持
+- 与初赛的参赛者指挥Agent打关卡的方式不同，决赛的参赛者将指挥各自的AI Agent 作战与“敌方“参赛者指挥的AI Agent进行作战。
 - 比赛将在大屏幕进行现场展示，并通过网络进行直播
-- GOSIM大会期间，还将安排观众挑战赛，邀请红警资深玩家与AI参赛队同台竞技
+- GOSIM大会期间，还将安排观众挑战赛，邀请红警资深玩家与AI参赛队同台竞技等嘉年华活动。
 
 ------
 
@@ -118,7 +119,14 @@ Red Alert: AI Uprising，红警AI崛起，我们邀你来共同回答这个问
 
 ------
 
-欢迎每一位热爱红警、热爱AI的你，
-加入这场命令与征服的新战役！
+## 免责申明
+
+感谢大家支持对黑客松的支持和参与。这次活动是一次尝试和探索的活动，组委会深知有很多地方都会不够成熟，比如在评分规则、关卡设计、比赛流程设计等方面，都毫无意外地会出现不尽人意之处。组委会希望得到大家的谅解。希望不仅仅将这次活动视为一次竞赛，更将其视为一次开源社区，游戏社区和智能体开发社区的嘉年华，让我们一起来享受这个前所未有的过程。
+
+同时，组委会一定会认真接受大家的意见建议，尽可能地改进这次比赛和未来比赛的开发者体验！
+
+欢迎每一位热爱红警、热心AI的你，加入这场命令与征服的新战役！
+
+**你来指挥，AI来战！** 
 
-**你来指挥，AI来战！**
+**You Command, AI Conquers!**

evaluation.md

@@ -0,0 +1,25 @@
+# 初赛测评
+
+当开发者通过某关卡时，以下的信息将被保存在该局的log文件中。当用户上载到官网时，这些指标将被用于对该局的打分。
+
+- Missions Accomplished：已完成关卡数目
+
+- Mission Time：关卡完成时间
+
+- Mission Economy:
+
+- Mission Kills:
+
+- Mission Casualty:
+
+- Mission Building Loss:
+
+   
+
+- Number of Human Commands: 关卡完成所需要的AI命令
+
+- Number 
+
+- Number of AI Actions：关卡完成所需要的API Calls的数量  
+
+#### 

guideline.md

@@ -0,0 +1,13 @@
+# 开发者指南
+
+### 安装和运行
+
+[quick-start.md](./quick-start.md)
+
+### 关卡
+
+[missions.md](./missions.md)
+
+### 评测
+
+[evaluation.md](./evaluation.md)

missions.md

@@ -0,0 +1,40 @@
+# 游戏关卡
+
+### 比赛任务 (Missions)
+
+开发一个 AI Agent，接收用户输入的自然语言指令，在 20 个关卡（暂定）中完成任务目标。每当完成一个关卡，游戏将生成一份加密日志，参赛者需上传该日志至官网用于评分，得分将实时公布在 [Leader boards]() 榜单。
+
+### 关卡场景
+
+游戏关卡设计的难度有易有难，涵盖多种挑战。不同的关卡反映不同的场景，包括但不限于：
+
+- 生产建造类场景：
+
+  - 基础建造训练 & 基础生产训练 
+
+- 探索迷雾类场景：
+
+  - 步兵探索（寻找敌方基地）
+
+  - 飞机探索（开图）
+
+- 战略撤退类场景：
+- 战略防御类场景：
+  - 修复建筑和单位
+
+- 战略进攻类场景：
+  - 两路夹击
+
+- 战术指挥类场景：
+
+  - 空中作战
+
+  - 地面作战
+
+
+
+#### 评分与日志上传
+
+- 游戏自动生成包含关键指标（通关时间、击杀数、战损比等）的加密日志
+- 参赛者将日志上传至官网（[link]）
+- 组委会根据评估规则评分并更新排名

quick-start.md

@@ -81,29 +81,7 @@ export PATH="/usr/local/share/dotnet/x64:$PATH"
 
 在比赛中，我们设计了一些游戏关卡，用于您测试您的AI-Agent完成任务的能力，有简单的任务比如：
 
-- 展开基地车
 
-- 建造3个步兵
-
-- 基础的上下左右移动
-
-- 建造车间，雷达，电厂
-
- 也有一些更加高级的任务，比如：
-
-- 探索地图
-
-- 建造一些有前置需求的建筑
-
-- 攻击敌人
-
-- 探索敌人位置，遇敌返回
-
-- 多路进攻敌人
-
-- 优先进攻某些建筑
-
-  ### 安装关卡
 
 ## 运行OpenRA游戏引擎