🐍 贪吃蛇大作战 - 游戏需求与架构文档#

版本： v1.0
创建时间： 2026-03-09
会话： main-session

一、游戏核心玩法分析#

1.1 核心机制#

┌─────────────────────────────────────────────────────────────┐
│                    贪吃蛇大作战核心玩法                       │
├─────────────────────────────────────────────────────────────┤
│  1. 控制蛇移动（鼠标/触摸/键盘）                              │
│  2. 吃食物变长（分数增加）                                    │
│  3. 包围其他玩家（击杀获得奖励）                              │
│  4. 避免撞墙/撞蛇（死亡重来）                                 │
│  5. 使用加速/道具（策略性）                                   │
│  6. 实时多人对战（排行榜）                                    │
└─────────────────────────────────────────────────────────────┘

1.2 与传统贪吃蛇的区别#

二、完整需求文档#

2.1 功能需求#

模块一：核心游戏#

1.1 蛇的控制
    ├── 鼠标控制（跟随鼠标方向）
    ├── 触摸控制（滑动方向）
    ├── 键盘控制（WASD/方向键）
    └── 加速控制（空格/点击）

1.2 蛇的行为
    ├── 移动（平滑转向）
    ├── 加速（消耗长度/能量）
    ├── 死亡（撞墙/撞蛇）
    └── 重生（安全区域）

1.3 食物系统
    ├── 普通食物（固定分数）
    ├── 特殊食物（随机效果）
    ├── 尸体食物（死亡蛇变食物）
    └── 刷新机制（定时/定量）

1.4 碰撞检测
    ├── 蛇头撞墙
    ├── 蛇头撞其他蛇身体
    ├── 蛇头吃食物
    └── 包围检测（可选）

1.5 地图系统
    ├── 大地图（可滚动）
    ├── 边界墙
    ├── 障碍物（可选）
    └── 小地图显示

模块二：多人在线#

2.1 房间系统
    ├── 快速匹配
    ├── 创建房间
    ├── 加入房间（房间号）
    └── 好友邀请

2.2 实时同步
    ├── 位置同步（10-20 次/秒）
    ├── 状态同步（加速/死亡）
    ├── 延迟补偿
    └── 断线重连

2.3 排行榜
    ├── 实时排名（本局）
    ├── 历史最高分
    ├── 好友排行
    └── 全服排行

2.4 聊天系统
    ├── 快捷消息
    ├── 表情
    └── 文字聊天（可选）

模块三：用户系统#

3.1 账号系统
    ├── 游客登录
    ├── 手机号登录
    ├── 第三方登录（微信/QQ）
    └── 账号绑定

3.2 个人信息
    ├── 昵称/头像
    ├── 等级/经验
    ├── 统计数据（场次/胜率/击杀）
    └── 成就系统

3.3 社交系统
    ├── 好友列表
    ├── 战队/公会
    └── 关注/粉丝

模块四：商业化#

4.1 皮肤系统
    ├── 蛇皮肤（颜色/图案/特效）
    ├── 食物皮肤
    ├── 击杀特效
    └── 获得方式（金币/钻石/活动）

4.2 道具系统
    ├── 加速道具
    ├── 护盾道具
    ├── 磁铁道具
    └── 使用时间限制

4.3 会员系统
    ├── 月卡/季卡
    ├── 专属皮肤
    ├── 经验加成
    └── 每日奖励

4.4 广告系统（可选）
    ├── 激励视频（复活/双倍奖励）
    └── 插屏广告

模块五：运营系统#

5.1 任务系统
    ├── 每日任务
    ├── 成就任务
    └── 活动任务

5.2 活动系统
    ├── 限时活动
    ├── 节日活动
    └── 排行榜活动

5.3 邮件系统
    ├── 系统邮件
    ├── 奖励邮件
    └── 公告邮件

5.4 数据分析
    ├── 用户行为
    ├── 留存分析
    └── 付费分析

2.2 非功能需求#

三、技术架构设计#

3.1 整体架构图#

┌─────────────────────────────────────────────────────────────────────┐
│                           客户端层                                   │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │   Web/H5    │  │  iOS App    │  │ Android App │  │  小程序     │ │
│  │  (Canvas)   │  │  (Unity)    │  │  (Unity)    │  │  (Canvas)   │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
                                    │
                                    │ WebSocket/HTTP
                                    ▼
┌─────────────────────────────────────────────────────────────────────┐
│                           网关层                                     │
│  ┌─────────────────────────────────────────────────────────────────┐│
│  │                    API Gateway / LB                             ││
│  │              (Nginx / Kong / 自研网关)                           ││
│  └─────────────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    │               │               │
                    ▼               ▼               ▼
┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│     游戏服务器        │ │      业务服务器       │ │      支撑服务        │
│  ┌────────────────┐  │ │  ┌────────────────┐  │ │  ┌────────────────┐  │
│  │  房间服务      │  │ │  │  用户服务      │  │ │  │  匹配服务      │  │
│  │  (WebSocket)   │  │ │  │  (HTTP)        │  │ │  │  (Redis)       │  │
│  ├────────────────┤  │ │  ├────────────────┤  │ │  ├────────────────┤  │
│  │  战斗服务      │  │ │  │  皮肤服务      │  │ │  │  排行榜服务    │  │
│  │  (帧同步)      │  │ │  │  (HTTP)        │  │ │  │  (Redis)       │  │
│  ├────────────────┤  │ │  ├────────────────┤  │ │  ├────────────────┤  │
│  │  地图服务      │  │ │  │  商城服务      │  │ │  │  消息推送      │  │
│  │  (AOI)         │  │ │  │  (HTTP)        │  │ │  │  (WebSocket)   │  │
│  └────────────────┘  │ │  └────────────────┘  │ │  └────────────────┘  │
└──────────────────────┘ └──────────────────────┘ └──────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────┐
│                           数据层                                     │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │   MySQL     │  │   Redis     │  │  MongoDB    │  │    OSS      │ │
│  │  (用户数据)  │  │  (缓存/状态) │  │  (日志)     │  │  (资源)     │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────────────────────┘

3.2 核心模块详细设计#

3.2.1 游戏服务器架构#

┌─────────────────────────────────────────────────────────────┐
│                      游戏服务器                              │
│                                                             │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                   Connection Manager                   │ │
│  │            (WebSocket 连接管理、心跳、断线检测)            │ │
│  └───────────────────────────────────────────────────────┘ │
│                            │                                │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                    Room Manager                        │ │
│  │         (房间创建/销毁、玩家加入/离开、房间状态)          │ │
│  └───────────────────────────────────────────────────────┘ │
│                            │                                │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                    Game Loop                           │ │
│  │    (16ms/帧 | 更新蛇位置 | 碰撞检测 | 食物生成)          │ │
│  └───────────────────────────────────────────────────────┘ │
│                            │                                │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                    State Manager                       │ │
│  │         (游戏状态快照、帧同步、状态压缩)                  │ │
│  └───────────────────────────────────────────────────────┘ │
│                            │                                │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                    AOI Manager                         │ │
│  │    (Area of Interest | 只同步附近玩家 | 性能优化)       │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

3.2.2 帧同步设计#

┌─────────────────────────────────────────────────────────────┐
│                     帧同步流程                               │
│                                                             │
│  客户端                          服务器                      │
│     │                              │                        │
│     │─── 输入操作 (方向/加速) ────▶│                        │
│     │                              │ 收集所有玩家输入        │
│     │                              │ 计算下一帧状态          │
│     │◀─── 帧数据 (状态快照) ──────│                        │
│     │                              │                        │
│     │ 渲染帧 N                     │ 发送频率：10-20Hz      │
│     │ 预测帧 N+1~N+3               │ 数据压缩：Protobuf     │
│     │ 插值平滑                     │                        │
│     │                              │                        │
└─────────────────────────────────────────────────────────────┘

帧数据结构：
{
  frameId: 12345,
  timestamp: 1709971200000,
  snakes: [
    { id: 'player1', x: 100, y: 200, angle: 1.57, length: 50, speed: 1 },
    { id: 'player2', x: 300, y: 400, angle: 3.14, length: 80, speed: 1.2 }
  ],
  foods: [
    { id: 1, x: 150, y: 250, type: 'normal', value: 10 },
    { id: 2, x: 500, y: 600, type: 'special', effect: 'speed' }
  ]
}

3.2.3 AOI（兴趣范围）设计#

┌─────────────────────────────────────────────────────────────┐
│                    AOI 九宫格设计                            │
│                                                             │
│  ┌───────┬───────┬───────┐                                 │
│  │  1,2  │  2,2  │  3,2  │  每个格子 500x500 像素           │
│  ├───────┼───────┼───────┤  玩家只看到周围 9 个格子的实体     │
│  │  1,1  │  2,1  │  3,1  │  减少同步数据量 80%+              │
│  ├───────┼───────┼───────┤                                 │
│  │  1,0  │  2,0  │  3,0  │                                 │
│  └───────┴───────┴───────┘                                 │
│                                                             │
│  玩家位置 (x: 250, y: 250) → 格子 (1, 1)                    │
│  同步范围：格子 (0-2, 0-2) 共 9 个格子                        │
└─────────────────────────────────────────────────────────────┘

3.3 数据库设计#

-- 用户表
CREATE TABLE users (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  openid VARCHAR(64) UNIQUE,
  nickname VARCHAR(32),
  avatar VARCHAR(255),
  level INT DEFAULT 1,
  exp INT DEFAULT 0,
  gold INT DEFAULT 0,
  diamond INT DEFAULT 0,
  vip_level INT DEFAULT 0,
  vip_expire_at DATETIME,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_openid (openid)
);

-- 用户统计
CREATE TABLE user_stats (
  user_id BIGINT PRIMARY KEY,
  total_games INT DEFAULT 0,
  total_wins INT DEFAULT 0,
  total_kills INT DEFAULT 0,
  max_length INT DEFAULT 0,
  max_score INT DEFAULT 0,
  total_play_time INT DEFAULT 0,
  FOREIGN KEY (user_id) REFERENCES users(id)
);

-- 皮肤表
CREATE TABLE skins (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(32),
  type ENUM('snake', 'food', 'effect'),
  rarity ENUM('common', 'rare', 'epic', 'legendary'),
  price_gold INT DEFAULT 0,
  price_diamond INT DEFAULT 0,
  unlock_condition JSON,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 用户皮肤
CREATE TABLE user_skins (
  user_id BIGINT,
  skin_id INT,
  acquired_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  is_equipped BOOLEAN DEFAULT FALSE,
  PRIMARY KEY (user_id, skin_id),
  FOREIGN KEY (user_id) REFERENCES users(id),
  FOREIGN KEY (skin_id) REFERENCES skins(id)
);

-- 对局记录
CREATE TABLE game_records (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  room_id VARCHAR(32),
  user_id BIGINT,
  score INT,
  length INT,
  kills INT,
  rank INT,
  duration INT,
  played_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_user (user_id),
  INDEX idx_time (played_at)
);

-- 排行榜（Redis ZSET，无需 MySQL）
-- Key: rank:daily:2026-03-09
-- Member: user_id, Score: max_score

3.4 通信协议设计#

WebSocket 消息格式#

// 客户端 → 服务器
{
  "type": "input",
  "data": {
    "angle": 1.57,
    "accelerating": true
  }
}

// 服务器 → 客户端
{
  "type": "frame",
  "data": {
    "frameId": 12345,
    "timestamp": 1709971200000,
    "snakes": [...],
    "foods": [...]
  }
}

// 协议类型枚举
enum MessageType {
  JOIN_ROOM = 'join_room',
  LEAVE_ROOM = 'leave_room',
  INPUT = 'input',
  FRAME = 'frame',
  GAME_START = 'game_start',
  GAME_OVER = 'game_over',
  CHAT = 'chat',
  HEARTBEAT = 'heartbeat'
}

四、技术选型建议#

4.1 客户端#

4.2 服务端#

4.3 基础设施#

五、开发路线图#

总周期：11 周（约 3 个月）

六、风险与挑战#

七、成本估算#

八、下一步建议#

1. 先做 MVP 版本 - 核心玩法验证（1-2 周）
2. 小范围测试 - 收集反馈迭代
3. 数据驱动 - 根据留存/付费调整
4. 快速迭代 - 每周更新版本

📄 文档版本：v1.0
创建时间：2026-03-09
会话：main-session