创建新工程

USER_MANUAL.md

@@ -0,0 +1,324 @@
+# 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 页面联系我们。