TOS 开发周记 05：从登录走向同一个房间

本文根据 2025-11-03 至 2025-11-09 的 Git 提交整理，是一篇待审核的历史开发周记。

先让玩家有身份

此前地图里的玩家只是客户端对象。这一周后端加入认证模块，并扩展 User 与 Fortress 数据；客户端同步增加登录流程，让玩家身份开始贯穿开始菜单、API 请求和游戏场景。后端还提供了按坐标查询 Region 的接口，登录与进入世界所需的用户、堡垒和所在区域数据逐渐连了起来。

同一阶段，后端把原有 Zone 命名统一为 Region。这个重命名波及实体、数据库初始化、地图、地块、怪物和堡垒路由，说明 Region 已经成为多条业务链路共享的概念。提交说明里的 regon 拼写也被原样保留在附录中，但正文统一使用 Region。

接上 Colyseus

客户端引入 Godot Colyseus 插件并建立 colyseus_client.gd，后端则扩展 MapRoom，并加入用于房间与匹配流程的测试页面和代码。到周末，客户端已经能显示房间信息，后端也修正了加入房间和在线人数统计相关逻辑。

这一周还没有完整的多人玩法，但网络层的职责开始清楚：常规账号、地图与堡垒数据通过 HTTP API 获取，房间里的实时状态交给 Colyseus。客户端最后把连接地址收敛为统一入口，减少不同模块各自拼接地址的情况。

社交与角色也开始成形

后端同时加入好友、队伍相关实体和路由，并补充 Swagger 描述；堡垒也有了独立路由。这里多数工作集中在服务端结构，客户端尚未在本周提供对应的完整好友与队伍界面，因此更适合把它看作后续社交功能的数据与接口准备。

客户端另一边加入玩家行走动画，并把 Player 场景从主场景中拆出。配合此前已经拆开的细节模式，main.gd 的职责继续缩小。TOS 到这一周第一次同时具备了“谁在玩”“进入哪个房间”“地图上显示哪个角色”这几个基础问题的实现线索。

提交记录

日期	仓库	提交	原始说明
2025-11-03	后端	068d35d	feat: add /map/region/by-point
2025-11-03	后端	7539c1f	feat: add auth module
2025-11-03	后端	9b7689f	feat: update user, add fortress
2025-11-04	后端	2917c01	feat: add region id
2025-11-04	后端	54e8c0d	feat: add team
2025-11-04	后端	88816cf	feat: add swagger
2025-11-04	客户端	20dcc05	feat: add login
2025-11-04	客户端	6c0592d	tidy: move detai logic to detail_mode.gd
2025-11-04	客户端	7b65392	feat: add addon
2025-11-04	客户端	bf15c93	fix
2025-11-05	客户端	465a7e8	tidy: clean code
2025-11-05	客户端	c1069d0	feat: add player animation
2025-11-06	后端	1a007b3	doc: update readme
2025-11-06	后端	397c50f	refactor: unify names to regon
2025-11-06	后端	5da0cc3	fix: fix vibe coding with friends
2025-11-06	后端	7cbaea8	feat: add fortress router
2025-11-06	后端	d1b7cc6	fix:swagger
2025-11-06	客户端	13d380c	feat: add addon
2025-11-06	客户端	a1371dc	feat: use dev api host
2025-11-06	客户端	d2ec1f4	feat: add colyseus
2025-11-07	后端	5fc5ff7	test: add test
2025-11-08	后端	32daa27	fix: fix join and user counts
2025-11-08	客户端	a83a51f	fix: show room info
2025-11-08	客户端	b388277	tidy: clean code
2025-11-09	客户端	46826c1	tmp
2025-11-09	客户端	690723d	feat: spit off player
2025-11-09	客户端	a80b950	feat: use unified url