whale-town/USER_MANUAL.md

# AI Town Game 用户使用手册

## 🎮 游戏简介

AI Town Game 是一款基于 Godot 引擎开发的 2D 多人在线游戏。玩家可以创建自己的角色，在 Datawhale 办公室场景中与其他玩家进行实时交流和互动。

### 游戏特色

- **多人在线**: 支持多个玩家同时在线互动
- **持久化世界**: 角色在玩家离线时仍作为 NPC 存在
- **实时对话**: 与其他角色进行文字对话交流
- **品牌场景**: 精心设计的 Datawhale 办公室环境
- **跨平台**: 支持网页版和桌面版

## 🚀 快速开始

### 系统要求

**最低配置**:
- 操作系统: Windows 10 / macOS 10.14 / Ubuntu 18.04
- 内存: 2GB RAM
- 显卡: 支持 OpenGL 3.3
- 网络: 稳定的互联网连接

**推荐配置**:
- 操作系统: Windows 11 / macOS 12+ / Ubuntu 20.04+
- 内存: 4GB RAM
- 显卡: 独立显卡
- 网络: 宽带连接

### 安装和启动

#### 网页版（推荐）
1. 打开浏览器（Chrome、Firefox、Safari、Edge）
2. 访问游戏网址
3. 等待游戏加载完成
4. 开始游戏

#### 桌面版
1. 下载游戏安装包
2. 运行安装程序
3. 启动游戏
4. 开始游戏

## 🎯 游戏指南

### 创建角色

1. **首次进入**: 游戏会自动显示角色创建界面
2. **输入角色名**: 
   - 长度: 2-20 个字符
   - 不能为空或只包含空格
   - 建议使用有意义的名称
3. **确认创建**: 点击"创建角色"按钮
4. **进入游戏**: 角色创建成功后自动进入游戏世界

### 基础操作

#### 移动控制
- **键盘**: 使用 WASD 键或方向键移动角色
- **触摸设备**: 使用屏幕上的虚拟摇杆

#### 交互操作
- **E 键**: 与附近的角色或物体交互
- **ESC 键**: 打开菜单或退出对话

#### 相机控制
- **自动跟随**: 相机会自动跟随你的角色
- **调试模式**: 开发者可以使用鼠标滚轮缩放视图

### 对话系统

#### 开始对话
1. 走近其他角色（在线玩家或离线 NPC）
2. 按 E 键开始对话
3. 对话框会出现在屏幕上

#### 发送消息
1. 在对话框中输入文字
2. 按回车键或点击发送按钮
3. 消息会显示在对话历史中

#### 观察对话
- 其他角色之间的对话会以气泡形式显示在角色头顶
- 你可以看到附近角色的对话内容

#### 结束对话
- 点击对话框的关闭按钮
- 或按 ESC 键退出对话

## 🏢 游戏世界

### Datawhale 办公室

游戏场景是一个精心设计的 Datawhale 办公室，包含以下区域：

#### 入口区域
- **位置**: 场景上方
- **特色**: 欢迎标识和 Datawhale Logo
- **功能**: 新角色的默认出生点

#### 工作区
- **位置**: 场景中央
- **设施**: 办公桌、电脑、椅子
- **用途**: 角色可以在此区域工作和交流

#### 会议区
- **位置**: 场景左侧
- **设施**: 会议桌、白板
- **用途**: 适合多人讨论和会议

#### 休息区
- **位置**: 场景右上方
- **设施**: 沙发、茶水间
- **用途**: 角色休息和非正式交流

#### 展示区
- **位置**: 场景右侧
- **特色**: 大型 Datawhale Logo、成就墙
- **用途**: 展示组织文化和成就

### 导航提示

- **墙壁**: 深灰色，角色无法穿过
- **家具**: 棕色，会阻挡角色移动
- **地板**: 浅灰色，角色可以自由行走
- **品牌元素**: 蓝色 Datawhale Logo 分布在各个区域

## 👥 多人互动

### 在线玩家
- **标识**: 角色头顶显示绿色在线标识
- **行为**: 由真实玩家控制，可以实时对话
- **互动**: 可以进行复杂的对话和协作

### 离线角色（NPC）
- **标识**: 角色头顶显示灰色离线标识
- **行为**: 作为 NPC 存在，保持最后的位置
- **互动**: 可以查看角色信息，但无法对话

### 社交功能
- **实时对话**: 与在线玩家进行文字交流
- **群组对话**: 多个角色可以同时参与对话
- **对话历史**: 查看之前的对话记录
- **表情符号**: 在对话中使用表情符号

## ⚙️ 设置和选项

### 游戏设置
- **音量控制**: 调整背景音乐和音效音量
- **画质设置**: 根据设备性能调整画质
- **全屏模式**: 切换全屏和窗口模式

### 控制设置
- **键位绑定**: 自定义键盘控制键位
- **触摸灵敏度**: 调整移动端触摸响应
- **相机设置**: 调整相机跟随速度和缩放

### 网络设置
- **服务器地址**: 连接到不同的游戏服务器
- **自动重连**: 启用/禁用断线自动重连
- **心跳间隔**: 调整网络心跳检测频率

## 🔧 故障排除

### 常见问题

#### 无法连接服务器
**症状**: 显示"连接失败"或"网络错误"
**解决方案**:
1. 检查网络连接是否正常
2. 确认服务器是否在线
3. 尝试刷新页面或重启游戏
4. 检查防火墙设置

#### 角色不显示或不移动
**症状**: 看不到角色或角色无法移动
**解决方案**:
1. 确保游戏窗口处于激活状态
2. 检查键盘是否正常工作
3. 尝试点击游戏窗口获取焦点
4. 查看控制台是否有错误信息

#### 对话功能异常
**症状**: 无法发送消息或看不到对话
**解决方案**:
1. 确认已与其他角色建立对话
2. 检查网络连接是否稳定
3. 尝试重新开始对话
4. 确认对方角色是否在线

#### 游戏卡顿或性能问题
**症状**: 游戏运行不流畅，帧率低
**解决方案**:
1. 关闭其他占用资源的程序
2. 降低游戏画质设置
3. 确保设备满足最低系统要求
4. 更新显卡驱动程序

### 错误代码

#### 网络错误
- **E001**: 连接超时 - 检查网络连接
- **E002**: 服务器拒绝连接 - 服务器可能维护中
- **E003**: 认证失败 - 重新登录游戏

#### 游戏错误
- **G001**: 角色创建失败 - 检查角色名称是否有效
- **G002**: 数据加载失败 - 清除浏览器缓存
- **G003**: 场景加载失败 - 重新启动游戏

## 📱 移动端使用

### 触摸控制
- **移动**: 使用屏幕左下角的虚拟摇杆
- **交互**: 点击屏幕右下角的交互按钮
- **对话**: 点击屏幕上的对话气泡

### 界面适配
- **自动缩放**: 界面会根据屏幕尺寸自动调整
- **触摸友好**: 按钮和控件针对触摸操作优化
- **横屏模式**: 建议使用横屏模式获得最佳体验

### 性能优化
- **后台运行**: 切换到其他应用时游戏会暂停
- **电池优化**: 游戏会根据电池状态调整性能
- **网络优化**: 在移动网络下会减少数据传输

## 🎨 个性化

### 角色外观
- **名称显示**: 角色头顶会显示玩家设置的名称
- **状态标识**: 不同颜色表示在线/离线状态
- **动画效果**: 角色移动时会播放行走动画

### 界面主题
- **Datawhale 主题**: 使用 Datawhale 品牌色彩
- **简洁设计**: 界面简洁明了，易于使用
- **响应式布局**: 适应不同屏幕尺寸

## 🔒 隐私和安全

### 数据保护
- **本地存储**: 游戏设置保存在本地设备
- **服务器数据**: 角色数据安全存储在服务器
- **隐私保护**: 不收集个人敏感信息

### 安全措施
- **输入验证**: 防止恶意输入和攻击
- **连接加密**: 网络通信使用安全协议
- **数据备份**: 定期备份游戏数据

## 📞 技术支持

### 获取帮助
- **在线文档**: 查看完整的技术文档
- **社区论坛**: 与其他玩家交流经验
- **问题反馈**: 通过 GitHub Issues 报告问题

### 联系方式
- **技术支持**: 通过项目 GitHub 页面
- **功能建议**: 欢迎提出改进建议
- **Bug 报告**: 详细描述问题和重现步骤

## 🔄 更新和版本

### 自动更新
- **网页版**: 自动获取最新版本
- **桌面版**: 启动时检查更新

### 版本历史
- **v1.0.0**: 初始版本，包含核心功能
- **后续版本**: 持续改进和新功能添加

### 新功能预告
- **AI 对话**: 与 AI 角色进行智能对话
- **更多场景**: 扩展更多游戏场景
- **社交功能**: 好友系统和私聊功能

## 🎯 游戏技巧

### 新手建议
1. **熟悉环境**: 先在办公室各个区域走动，熟悉布局
2. **主动交流**: 尝试与其他角色对话，建立联系
3. **观察学习**: 观看其他玩家的行为，学习游戏玩法
4. **耐心等待**: 如果没有其他在线玩家，可以与离线角色互动

### 高级技巧
1. **战略位置**: 选择合适的位置进行对话和交流
2. **群组对话**: 组织多人对话，提高互动效果
3. **时间管理**: 合理安排在线时间，与不同时区的玩家交流
4. **社区建设**: 帮助新玩家，建立友好的游戏社区

## 📚 附录

### 键盘快捷键
- **W/↑**: 向上移动
- **S/↓**: 向下移动
- **A/←**: 向左移动
- **D/→**: 向右移动
- **E**: 交互
- **ESC**: 菜单/退出
- **Enter**: 发送消息
- **Tab**: 切换焦点

### 术语表
- **NPC**: 非玩家角色，指离线玩家的角色
- **在线角色**: 当前由真实玩家控制的角色
- **离线角色**: 玩家离线时作为 NPC 存在的角色
- **对话气泡**: 显示在角色头顶的对话内容
- **世界状态**: 游戏世界中所有角色和对象的当前状态

### 技术规格
- **游戏引擎**: Godot 4.5.1
- **网络协议**: WebSocket
- **数据格式**: JSON
- **支持平台**: Windows, macOS, Linux, Web
- **最大玩家数**: 50 人同时在线

---

**祝您游戏愉快！** 🎮

如有任何问题或建议，欢迎通过项目 GitHub 页面联系我们。