2026-10-23

新增

• [admin/api] 后台增加账号 GM 设置及独立 players.gm 权限，可在普通玩家与 GM 间切换；旧组校验、账号保护与审计覆盖保存流程，完整退出重登后对全账号生效。
• [root/client/server/api] 恢复经典初心者教学、职业手册与任务；通过 HAPPYRO_NEW_PLAYER_START=ship|classic 选择新建人类角色的沉船或经典出生点，默认 classic，出生与初始复活点同步，杜兰流程保持独立。

优化

• [admin] 账号操作收拢为带编辑图标的菜单，GM 弹窗显示身份选项及重登提示；角色属性保持六个 Tab 的直接入口，游戏设置历史通过独立页面查看。
• [root] 新增 ADMIN_CSRF_ORIGIN_CHECK_ENABLED，默认 false，关闭后台 Origin 与 Sec-Fetch-Site 来源限制，仍强制校验会话 CSRF Token；Docker 模板与本机配置同步。
• [client] 桌面右下角新增自动战斗、自动拾取和设置三个常驻按钮，独立启停并显示选中状态与悬停提示；设置窗口仅保留参数，移除重复总开关，拾取保存失败明确提示。
• [client] 移除桌面自动战斗和拾取按钮的状态点，战斗图标替换为 Lucide 线框双剑，拾取图标保持原样；开启状态继续通过背景和边框表达。
• [client/gateway] 新增脚本文字最低对比度环境变量 CLIENT_SCRIPT_TEXT_MIN_CONTRAST，默认 4.5、范围 4.5–7；自动修正始终开启，无法达到目标时使用最佳黑白端点。
• [root] 为 52 项客户端环境默认值补齐原生与 Docker 模板、Compose 变量映射和启动配置透传；新增配置使用说明与部署契约检查。
• [client/gateway] 52 项客户端默认设置统一由环境变量配置，PWA 配置定义作为唯一默认值来源；保留浏览器个人设置优先级，初始化、恢复默认和镜头重置读取同一配置。Gateway 动态提供运行时配置，完整前端构建不再覆盖部署值；渲染比例直接读取图形偏好，修复首次进入时默认比例未实际生效的问题。
• [client] 手机和平板的横屏、竖屏默认镜头各拉近一档（15）；手机默认距离改为 95/170，平板改为 125/155，桌面默认值不变。
• [client] 自动战斗默认开启无目标随机瞬移，无目标等待与最短瞬移间隔均默认设为 2 秒。
• [client] 桌面冒险工具的物品与 Zeny 发放改为弹窗输入，沿用亮色风格及同类控件圆角；支持直接输入和加减调整，确认期间禁止重复提交。
• [client] 物品数量与 Zeny 金额分别保留草稿，切换物品、页签及取消弹窗不清空；关闭冒险工具后重置为物品数量 1、Zeny 空值。
• [client] Zeny 加减按钮调整为「-100万」「-10万」「+10万」「+100万」；空值按 0 参与加减，空值、0 及其他无效金额不能发放。

修复

• [client/api] 补齐经典宠物教学小波利共用的 2398 外观及另外 114 种 NPC 外观缩略图，后者覆盖 427 个实例；同步目录与客户端图集，采用已核验的离线资源。
• [client/api] 经典修炼场的 20 张平行地图按 4 个实际区域合并，默认每个区域显示一个入口；保留转职阶段、等级竞技场等用途不同的地图。
• [client/server/api] 修炼场五个出生分流的公告牌改用木制公告板，同步场景、NPC 目录及导航外观。
• [client] 手机竖屏快捷键筛选固定在列表底部；任务入口移至左上角，默认选中首个任务；移动端状态在右侧按列显示，点击查看对应说明，并修复 Canvas 图片地址缺失。
• [root] 修正经典修炼场五个公告牌的导航外观覆盖，使导航目录与服务端木制公告板一致。
• [client/server] 将经典初心者出生及初始保存点调整为 new_1-1,53,107，统一角色登录及传送入场默认面向正南，正常移动转向不受影响；不迁移已有角色位置。
• [root/client/server] 地图关键资源加载失败自动恢复到上次成功位置，再失败返回普隆德拉；30 秒加载超时提供重试和返回普隆德拉，登录坏地图也可恢复，安全点失败停止循环。隔离旧加载与迟到图片，成功初始化后才确认入场。
• [client] 九职业实机转职发现职业等级回包未同步角色实体，外观重建可能把 Job 1 显示为旧 Job 10；同步实体等级，保持转职后界面与服务端一致。
• [root/client/server/api] 补齐 115 个经典 NPC 与两名转职 NPC 的导航关联，按地图服实测修正可疑男子及 45 项旧导航外观编号；删除学院接待员误删经典任务的遗留逻辑，跨流程交谈后可正常交付波利任务。
• [root/client/api] 最终复审修正官方共享场景地图的支持标记、经典地图预览映射及 new_5-4 中文名；桌面加载图限定当前官方八张资源，声望图片异步加载不再产生 undefined 请求。
• [root/client/server/api] 逐句审校经典训练场及九职业 NPC，统一人名、职业与物品术语，润色问卷结果；修正两份任务表各 22 项说明并同步 NPC 目录。
• [server] 经典新手全分支代码审查，修复跆拳／飞艇／天津町旧出口、任务登记时序、离场任务清理、奖励容量检查及误导对白。
• [root/client/server] 移除覆盖经典教官的旧迁移 NPC 和历史进度兼容段，修正训练等级取消传送、更换手册脱掉全部装备、NPC 与职业测验英文及新手任务名称／击杀提示。
• [root/client/server/api] 训练场完整实机验收补齐 143 个官方假人外观映射和 26 个 SPR/ACT，修复错误魔物外观；个人仓库打开前关闭 NPC 对话，训练 NPC 名称及公会仓库标题统一中文，同步 NPC 目录。
• [client] 修复攻击目标消失时的空引用，隔离战斗/UI 封包回调异常，避免丢失后续半包触发误断线；目标消失后自动战斗继续寻找目标。
• [root/client/api] 安装三张训练场官方地图及缺失依赖，修复训练教官传送后缺少 tra_fild01/02/03.rsw 的问题；地图支持判断按官方 RSW 的真实地面引用生成，补齐中文名称和共享小地图。
• [client/server/admin/api/gateway] 统一 UTC 存储和带时区的 API 输出，前端显示时区通过 APP_TIMEZONE 配置，默认 Asia/Shanghai；覆盖角色与账号登录、后台业务记录、客户端期限与日期、截图及 Gateway 状态页，不迁移或兼容历史数据。
• [root] 7 个仓库明确禁止任何兼容处理；补充时区配置与数据语义文档，Docker 为 API 和 Gateway 传入同一显示时区。
• [root] 离线打包在资源复制、资源与模板清单、最终 ZIP 中过滤任意层级的 ._* 和 .DS_Store，避免 macOS 解压处理元数据后造成部署校验缺文件；保留业务文件及原始资源，既有发布包不自动回写。

部署与维护

• [root/client/server/admin/api/gateway] 按当前生产功能整理七仓库文档与 v0.5.1 版本摘要，补齐 GM、来源校验和修改记录说明；合并经典新手与随行阶段报告，清理过时模板和工作流状态标签，保留历史交付、资源来源与有效验收边界。
• [server/api] 新增 10 项导航、召怪和工具权限环境变量，严格范围校验，支持 Docker / Linux / macOS 部署透传；非空覆盖项在后台提交前拒绝，地图服整批冲突校验，保留原默认值并更新配置文档。
• [server] 新增 HAPPYRO_AREA_SIZE、HAPPYRO_MAX_WALK_PATH 环境变量，严格校验并在 battle 配置导入后应用；默认视野从 14 调整为 18，行走上限保持 17。同步 Docker、Linux 原生和 macOS 启动配置入口。
• [root] 将训练场修复、验收和资源说明集中到 docs/development/trainning-ground/ 专题，单列问题修复文档，收录补丁 ZIP、72 个原始资源、两个官方 LUB 及关键验收证据。

验证与待办

• [client/server/api] 78 项客户端相关测试及 API catalog 测试通过；本机验证训练场去重、公告牌实际精灵加载、单物品筛选底部定位、首个任务默认选中，以及 13 个状态的手机横竖屏多列显示。移动布局使用 Chromium 手机模拟，尚未经真实手机验收。
• [server] 核对当前 Renewal 配置及角色创建代码：初始自由素质点为 48，属于现有正常默认值；审查已启用 NPC 的 899 种可解析外观资源，除明确隐藏/传送点外均可读取对应精灵动作或模型。
• [root/client/server] 地图恢复通过真实教官缺图、坏地图重登、原位置失败返城、30 秒超时交互、迟到下载隔离与安全点停止循环验收；客户端 1,917 项测试通过，卡普拉旁 148,87 落点及无渲染循环退出已实测。
• [root/client/server] 默认出生切换为经典修炼场；char-server 重建与本机配置生效，新角色出生及保存点均为 new_1-1,53,111。提交前客户端全量 1,867 项通过，相关资源与文档已纳入仓库。
• [root/client/server] 九个一转职业全部通过无头原生 NPC 转职、奖励及重登验证；普通账号的等级技能与材料准备单列，跆拳升一级任务使用真实打怪完成，不直接修改职业或任务进度。职业等级显示修复相关 11 项测试通过，完整 PWA 重建及新角色转职／重登回归通过。
• [root/client/server/api] 最终整体复审客户端 1,865 项、资源生成器 13 项通过；无头逐张渲染 20 张经典地图，检查 176 个 NPC 实时可用性，复验三场教官入口与管理员退出、九职业资格不足分支及 22 项运行任务译文。
• [root/client/server/api] 翻译审查覆盖 10 个脚本、2,277 行对白／菜单；两份任务 LUB 语义校验和安装哈希通过，NPC 目录及完整 PWA 更新，无头抽查五名 NPC 的中文称呼与代表性对白通过。
• [root/client/server/api] 经典新手主线、四个职业任务、六城市跳过分支、30 题测验、五档训练区、正常剑士转职／重登及死亡复活通过无头实机验收；ship/classic 两模式 UI 创建和杜兰出生回归通过，本机恢复 ship，测试账号全部离线。
• [client/gateway] 脚本文字对比度相关客户端 40 项、Gateway 运行时 7 项和部署模板 2 项测试通过；完整 PWA 构建及本机哈希核验通过。有在线角色，Gateway 新配置定义待下次重启加载。
• [root] 客户端默认值部署契约检查 2 项通过，覆盖全部变量在原生/Docker 模板与 Compose 中的同步及启动配置透传。
• [client/gateway] 环境默认值相关客户端测试 79 项、Gateway 测试 33 项、部署模板检查 2 项通过；52 个变量逐项覆盖，非默认值浏览器实测、个人设置与恢复默认、PWA 重建保持运行时响应、本机正式入口均通过。客户端全量 1857 项通过，2 项既有训练场资源数量断言不匹配另行保留记录。
• [root/client/server/api] 三场真实 NPC 入口、六侧门、重登、12 处对白、三台清扫机器人、24 组伤害和个人／公会仓库分支验收通过；独立测试会话已关闭，临时维护权限已撤销。
• [client] 镜头相关 34 项测试通过；完整 PWA 构建、Gateway 哈希核验通过，手机布局实际横竖屏切换验证距离为 95/170。
• [client] 瞬移默认值变更的 82 项相关测试通过；完整 --all PWA 构建及本机 Gateway 产物哈希核验通过。
• [client] 断线修复相关 10 个测试文件、129 项测试通过，覆盖目标缺失后继续换怪及回调抛错后的所有半包拆分位置；完整 --all PWA 构建和 Gateway 哈希核验通过，手机布局浏览器故障注入后连接与自动战斗均保持正常。
• [root/client/api] 训练场 46 个补充文件安装后哈希一致；三张地图通过无头浏览器实际渲染，未发生资源 404 或页面错误。
• [client] 发放、数量控件、确认框与窗口生命周期相关测试通过；完整 --all PWA 构建通过，并核对本机 Gateway 提供的新产物哈希。
• [root] 部署工具测试 34 项通过、5 项集成测试跳过；新增回归覆盖源资源不被修改、元数据不进入清单及 ZIP、解压后部署校验通过。