# 天梯S1 智能仓储机器人

**Repository Path**: style7-strawberry/intelligent-storage-robot

## Basic Information

- **Project Name**: 天梯S1 智能仓储机器人
- **Description**: 神奇代码岛 代码天梯排位赛 S1 参赛项目
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能仓储机器人 - 神岛代码天梯S1赛季参赛项目

## 项目简介

本项目是神岛代码天梯S1赛季的参赛作品，基于 **ArenaPro Creator** 开发，聚焦“智能仓储机器人”核心主题，通过分阶段实现机器人移动、货物分拣、任务系统、自动化分拣、资源管理等功能，构建一套完整的智能仓储分拣解决方案。

## 开发工具

### ArenaPro Creator

- 专业、高效的神岛游戏创作解决方案

- 融合 VSCode 强大能力与 TypeScript 类型安全特性

- 适配神岛创作生态，提供现代化开发工作流

## 赛事背景

神岛代码天梯S1赛季仅支持**个人形式创作**，创作主题为“智能仓储机器人”。赛事分三个阶段逐步提升开发难度，从基础功能实现到复杂系统协同，最终完成全流程智能仓储分拣体系：

- 前期（1-2周）：基础移动、碰撞收集 + 货物分拣与状态管理

- 中期（3-4周）：动态传送带货物、优先级计分 + 事件驱动任务系统

- 后期（5-6周）：自动化分拣站、效率统计 + 复合型任务与仓库资源管理

## 开发阶段与任务要求

### 第一阶段（1-2周）：基础移动与碰撞检测 - 货物分拣与状态管理

#### 核心目标

实现机器人基础移动、货物生成/收集逻辑，以及A/B类货物的分拣规则与状态管理。

##### 1.1 基础移动与货物收集

|任务项|具体要求|
|---|---|
|机器人移动|- WASD 键控制前后左右移动<br>- 移动速度恒定且可配置（如 5.0f）<br>- 受重力影响，平稳站立在地面|
|货物生成|- 场景随机位置生成“标准箱”货物<br>- 生成间隔3秒，场景最多同时存在10个货物|
|收集逻辑|- 机器人碰撞货物时，货物标记为“已收集”并消失（无需按键）|
|UI 显示|- 左上角文本UI实时显示：`已收集数量：X`（X为累计收集数）|
##### 1.2 货物分拣与状态管理

|任务项|具体要求|
|---|---|
|货物类型|- 生成A类（绿色立方体）、B类（红色立方体）货物，随机生成且比例各50%|
|分拣站|- 场景包含A站（绿色材质）、B站（红色材质）两个静止分拣站|
|分拣流程|- 拾取：机器人碰撞货物时吸附货物（悬浮在上方），记录类型，且不可同时拾取多个<br>- 投放：携带货物时靠近对应分拣站按空格键<br>  ✅ 匹配：货物消失，收集数+1<br>  ❌ 不匹配：中央显示红色提示“类型错误！”，货物掉落可重新拾取|
#### 验收标准

- 机器人移动、货物收集逻辑正常，UI计数准确递增；

- 可正确拾取/投放A/B类货物，系统对匹配/不匹配场景反馈准确。

### 第二阶段（3-4周）：动态货物与优先级 - 任务系统与事件驱动

#### 核心目标

新增传送带货物、收集优先级计分，以及事件驱动的任务系统，实现机器人自动导航与任务闭环管理。

##### 2.1 动态货物与优先级

|任务项|具体要求|
|---|---|
|货物来源|- 静态货物：同1-2周原地生成<br>- 传送带货物：传送带起点生成，固定速度向末端移动，未收集则到达末端后自动销毁|
|收集优先级与UI|- 传送带货物计2分，静态货物计1分<br>- UI更新为显示：`总分：Y`（Y为加权后总分）|
|自动导航|- 按下E键，机器人自动寻路至最近的传送带货物|
##### 2.2 任务系统与事件驱动

|任务项|具体要求|
|---|---|
|任务数据结构|- 任务类包含：任务描述、目标类型（A/B/任意）、目标数量、时间限制（仅限时任务）|
|任务生成|- 游戏开始生成首个任务，完成后自动生成新随机任务<br>- 随机任务类型：<br>  ① 收集3-5个A类货物<br>  ② 收集2-4个B类货物<br>  ③ 30秒内收集5个任意货物|
|任务UI|- 右侧任务面板显示：<br>  ✅ 当前任务：[任务描述]<br>  ✅ 进度：[当前数量]/[目标数量]<br>  ✅ 剩余时间：[秒]（限时任务）|
|任务完成|- 达成条件后UI显示“任务完成！”，奖励100分，自动刷新新任务|
#### 验收标准

- 传送带运行正常，不同货物计分准确，自动导航功能可用；

- 任务生成/完成逻辑闭环，进度、计时、奖励反馈准确。

### 第三阶段（5-6周）：自动化与效率挑战 - 高级任务与资源管理

#### 核心目标

实现效率统计、自动化分拣，以及复合型任务与仓库资源管理，保障系统稳定协同。

##### 3.1 效率统计与自动化分拣

|任务项|具体要求|
|---|---|
|效率统计系统|- UI新增效率面板，显示：<br>  ✅ 总操作时间：[秒]<br>  ✅ 平均每分钟收集数：[数值]<br>  ✅ 当前任务链连续完成数：[数值]|
|自动化分拣站|- 场景中央新增通用分拣站（黄色材质）<br>- 机器人携带货物进入区域时，自动识别类型并投入对应虚拟仓库，计入收集数<br>- 自动分拣仅计1分（不区分货物类型/来源）|
##### 3.2 复合型任务与资源管理

|任务项|具体要求|
|---|---|
|复合型任务|- 生成多条件复合任务，例如：<br>  ① 收集2个A类+2个B类货物<br>  ② 无错误分拣完成3次分拣<br>  ③ 使用通用分拣站处理5个货物|
|资源仓库与特殊事件|- A/B类货物各有独立仓库，容量上限10<br>- 仓库满时收集对应货物不加分，弹出提示（如“A类仓库已满！”）<br>- 仓库管理员NPC每60秒随机取走某类货物，UI通知事件|
|策略性UI|- 显示仓库容量：`A库：[当前]/10`、`B库：[当前]/10`<br>- 任务面板高亮复合任务子条件及完成状态|
#### 验收标准

- 效率数据实时更新，自动分拣功能正常；

- 复合任务进度清晰，仓库容量限制、管理员取货事件反馈准确；

- 全系统（移动、分拣、任务、仓库）稳定协同运行。

## 操作说明

|按键|功能|
|---|---|
|WASD|控制机器人前后左右移动|
|空格键|向分拣站投放携带的货物|
|E键|触发机器人自动导航至最近的传送带货物|
## 验收总览

本项目验收核心围绕“功能完整性、逻辑准确性、系统稳定性”三大维度：

1. 各阶段功能按要求实现，操作反馈符合预期；

2. 数据统计（收集数、总分、效率、仓库容量）准确无误；

3. 全流程无运行时错误，各模块协同工作稳定。
> （注：文档部分内容可能由 AI 生成）