v0.6.0

本版升级自动战斗，新增自身增益维持与 HP／SP 自动恢复，完善经典初心者流程、地图加载恢复、多端冒险工具和后台账号管理，并集中校准 NPC、魔物与地图名称。以下按当前生产功能与配置说明变化；安装文件、校验摘要和镜像交付信息以资源下载为准。

交付与本机验收

当前完整包 happyro-v0.6.0.zip（提取码：e5ni）为 4,254,547,071 字节（约 3.96 GiB），包含 Gateway、Server、API、Admin、Database 的 amd64／arm64 镜像及运行资源。使用包内配套的 README、Compose 和工具。

ZIP SHA-256：

cadc6cca75398d01dbb94150b93d50692d04f2775af8acc8fcfcd9dee8a273db

以下 Docker Hub 摘要、验收范围和构建提交均属于 2026-10-26 较早的四镜像批次，不代表当前下载包已完成相同验收或推送。当前包的源码来源以包内 release-manifest.json 为准。

该历史批次 Docker Hub 的 kugarocks/happyro-{gateway,server,api,database} 均提供 v0.6.0 和 latest，完整索引与两个架构的子摘要核对一致：

镜像	完整 index 摘要
gateway	sha256:f334bf78a4282c9369cd9af6445ea86e37d766c160c335a269e7b3deb0e55d63
server	sha256:47bdf8b41367b39fbd47efdc29b64613bb8b23ed676ec5874c84309a2ee595f7
api	sha256:08fa568404c7d73e4b3159de5f349a09dfd050a4c41ab35721d1a3cd5da6929e
database	sha256:a3e970a91dde9503614bfb47988046706076909c90bdf45bc67d0eda70d9e53e

本机完成两架构启动、游戏登录进图、冒险工具、保持登录、后台目录与设置、手机／平板触屏视口检查；arm64 完成自定义资源、重启持久化、精确备份恢复及 v0.5.0 备份恢复升级。升级必须保留原密钥，避免旧服务间账号与新密码不一致。

amd64 在 OrbStack 仿真运行；触屏视口不代表真机。未覆盖真实 iOS／Android 后台行为、完整 HTTPS／代理 Host／PIN／会话到期矩阵、v0.3.2 存档升级及旧版镜像回退。详细证据在构建工作区 work/release-v060-20261026/。

构建源码提交（发布记录更新在构建之后）：

• .：d92ff15b41a5b13f002634f885f2531f05d6b9fe
• repos/happyro-client：f65430934fa68390e9e2399ddad5e5638e86dfb7
• repos/happyro-gateway：82489065b18196596f4d90a91998466c25efcc13
• repos/happyro-server：baa454605a5e49a6725b1f8906ce0d39a6882ed9
• repos/happyro-admin：757d545707567aa87b210c71c8d8cd6e11fd7317
• repos/happyro-api：040310353cf2dc412f6e36745705f631b199b2e4

经典初心者与修炼场

• 支持 HAPPYRO_NEW_PLAYER_START=classic|ship，默认 classic；新建人类角色出生和初始保存点为 new_1-1,53,107，杜兰流程独立。已有角色位置不迁移，角色登录及传送入场默认面向正南。
• 恢复经典教学、职业手册、任务和问卷；修复取消仍传送、更换手册卸掉普通装备、任务登记与清理、奖励容量检查及旧离场交通位置。
• 审校经典新手及九个一转职业的 NPC 名称、对白、材料和任务说明，修复转职后职业等级显示被外观重建覆盖的问题。
• 修炼场 20 张平行地图在关闭分流时按四个实际区域展示；补齐 NPC 导航关联，五个出生分流使用木制公告牌。
• 补齐训练地图、假人外观及对应目录资源；按官方映射识别共享场景，完善小地图与中文名称。
• 女武神转生对话补充受限初心者装备卸下后出售、携带及出售所得 Zeny 存入银行的说明，明确零负重和零携带 Zeny 等准备要求。

NPC 名称与任务文字

• 完整复审沉船学院、杜兰出生和后续转职文本，修正任务口令、导航、材料与限时指引；学院忍者教学可直接完成，领奖按实际奖励检查容量，背包满时保留已取得的奖励资格。
• 审计当前加载的 Renewal 脚本，统一 NPC 头顶名称、对白标题和跨章节译名，同步任务、提示、卡片说明及图鉴导航。保留脚本内部标识，修正显示名参与剧情比较与复制 NPC 固定标题的问题。
• 独立扫描 RO321 与 DVG 的 NPC 名称，按地图、坐标及形象核验后更新 3,759 个显示名称；保留内部标识，同步对白标题、客户端导航和后台目录，同坐标优先选择可交互 NPC。原文、决策、变更与保留项分别记录。
• 名称词表收敛为单一来源；有歧义的截断名称等待完整封包，目录不再收录块注释里的 NPC。

说明链接与参考阅读器

• NPC 对话中的 NAVI 保存最后选择的导航目标，提示结束对话后可传送；正常结束后显示黄色独立「打开地图／取消」按钮，不中断任务对话。背包、任务等外部说明中的坐标链接打开地图标点，魔物链接打开图鉴；只查看后关闭恢复来源、选中项和滚动位置，开始寻路或发出传送请求后释放来源。冒险工具内部链接切换页签，可切回来源页。
• TIPBOX、ITEM 与 ITEMLINK 共用参考阅读器，支持帮助分页、图片、物品说明和历史返回。桌面采用冒险工具样式，手机和平板适配标题栏、安全区域与阅读留白。
• 冒险工具、任务、物品、装备、NPC、技能和成就共用安全标签渲染，支持受限颜色、字号、粗体、斜体与 HTTP(S) 链接；INFO 内部目标不作为正文显示，无效引用保留文字。
• 坐标传送保留到达确认，不再提示普通成功 toast；对话未结束、地图未就绪和无安全落点等仍有明确失败反馈。修复背包／技能未选中时滚动回弹、关闭导航返回背包时抖动，以及来源窗口恢复、输入冻结和迟到回调问题。

物品与技能名称

• 对照来源审校物品与技能名称，同步客户端、服务端、NPC 奖励／口令、物品说明和图鉴引用；修复脚本、拍卖及稀有物品公告等 UTF-8 名称截断和缓冲区问题。名称修订不等于调整战斗数值或奖励内容。

魔物名称与任务目标

• 按 RO321、DVG 和同 ID 第三方中文来源修正 96 个魔物名称，补齐客户端遗漏的 110 个已有名称；同步服务端备用名、魔物型佣兵、刷怪标签、任务与图鉴。未确认名称、剧情专名及战斗数值保留。
• 核对魔物导航、公告板和狩猎目标，深入复查两份任务表的 249 条记录、523 个字段；任务进度按 ID 与当前默认封包短名恢复完整中文，保留通用种族／地图条件。

地图与资源

• [client/server] 地图显示采用城市简称和明确的方位、编号、楼层／模式；地图搜索仅匹配当前显示名称，统一冒险工具、导航、NPC 位置及传送菜单。
• 地图关键资源加载失败时尝试上次成功位置，再失败返回普隆德拉；30 秒加载超时提供重试和返城。隔离旧加载与迟到图片，安全点仍失败时停止循环。
• 修复声望图片异步加载产生 undefined 请求，桌面随机加载图限定为当前官方八张资源。
• 补齐宠物教学小波利共用的 2398 外观缩略图，以及另外 114 种 NPC 外观缩略图，后者覆盖 427 个 NPC 实例；同步 API 目录和客户端图集。这些是目录预览资源，不等同于全部场景模型、贴图和音效都已补齐。
• 修复女武神大厅等天空地图云层误用地面纹理、出现贴图漂移的问题。

自动战斗与恢复

• 战斗设置新增「自动恢复」Tab，桌面、手机和平板共用 HP／SP 独立开关、「低于／恢复至」比例和道具优先顺序；仅使用已选即时恢复道具，支持库存更新、失败退避、冷却及回执超时隔离，恢复与战斗独立调度。默认 HP 低于 50% 恢复至 80%，SP 低于 20% 恢复至 50%，四项均支持环境变量；加减按钮跳至相邻 5% 刻度。恢复道具和排除物品的选择弹窗统一每页 10 项，平板单独优化控件和行距。

• 技能保持单列表；勾选已支持的七项自身增益后，自动战斗在状态缺失时补充，已有状态跳过。连续补两个增益后让出攻击机会，同技能至少间隔 10 秒；不维护队长或队友状态。选择普通攻击保留增益选择。

• 拆分技能规则表、纯评分器与施法恢复状态机，资料生成与运行期复用同一份特殊规则，便于独立扩展与测试。

• 等待技能执行回包后再择技，结合目标、落点和请求生命周期隔离迟到结果；修复链电、属性漩涡及深渊之焰的父子回执关联。明确的施法中断让出执行机会，歧义结果通过有界超时恢复。

• 增加技能能力、条件和落点模块：支持 34 项审核过的自身范围攻击，接近有效范围后施放；陷阱避开禁放区域和占位。预检可观察的 AP、HP、武器、材料、状态及信仰阶段，服务器继续最终裁决。交互、友方领域、玩家限定和需要专门场地／连招策略的技能保留手动。

• 减益和陷阱施放后让出攻击，同目标同技能限制频率；连续两次确认执行却未对当前目标造成正伤害时尝试普攻。修正链电属性、漩涡动态属性及五组种族增伤规则；补齐石化术免疫、华丽金属等目标限制，光耀之堂只针对不死或恶魔目标。

• 自动战斗从已选可用技能中优先选择属性、种族或体型克制技能，排除已知无效目标；同等适用时随机，均不可用时普攻。增加失败技能暂避、无确认超时普攻及长读条保护，避免反复卡在单一技能。

• 默认服务端同步与客户端搜怪范围为 14 格，活动范围为 30 格；地图服在登录、换图和运行配置变化时下发实际上限。客户端同步限制设置与执行，未取得范围时等待，断线清除旧连接上限。

• 战斗设置实时刷新可确认的武器、弹药、状态及目标条件，无法可靠判断时不猜测错误；修复武器／防具类型、盾牌槽、双持、骑乘和球数条件。临时技能自动增删，保留选择、滚动和焦点；服务端同步目标标记与归属。

• 手机／平板停止战斗按钮使用黄色，自动瞬移等待期间保持运行状态，点击停止可取消恢复；技能卡片固定两行，不可用原因置于等级右侧。

桌面与移动端交互

• 手机／平板右下工具栏拆为「动作／取消」「战斗设置」「自动战斗／停止战斗」，直接展开自身动作，取消选择与战斗开关独立，快捷栏分页保持原样。展开动作会停止自动战斗，自身和各类随行动作按钮统一尺寸，并与下方战斗工具栏等高；动作区去掉外框和背景，展开时隐藏战斗提示，收起后恢复。

• 桌面右下角提供自动战斗、自动拾取和设置常驻按钮，独立启停并显示状态；设置窗口集中维护参数。战斗与拾取开启时使用浅黄色，关闭时灰色且为 70% 不透明度。

• 桌面冒险工具通过亮色圆角弹窗输入物品数量与 Zeny。两者分别保留草稿，关闭冒险工具后重置为数量 1、Zeny 空值。

• Zeny 按钮使用「-100万」「-10万」「+10万」「+100万」；空值按 0 参与加减，空值或 0 不能发放，确认期间阻止重复提交。

• 手机竖屏快捷键筛选固定在列表底部；任务入口移至左上角并默认选中首项；状态在右侧分列显示原始图标，点击在图标旁显示桌面同款说明，不跳转弹窗。

• 手机和平板默认镜头拉近；自动战斗默认开启无目标随机瞬移，无目标等待和最短瞬移间隔均为 2 秒。

• 修复目标消失引起的空引用和封包回调异常导致的后续消息丢失，自动战斗可继续寻找目标。

• 状态图标共用桌面倒计时遮罩和彩色说明；手机竖屏按实际可用高度换列，横屏在角色信息右侧换行，说明显示在下方。统一小地图与操作区右侧间距，修正拾取提示避让。

• 任务和状态详情统一标题样式；状态详情显示剩余时间，列表按即将到期优先排序。

• 自动战斗攻击目标展示当前地图全部配置魔物，以两列排列，不依赖周围可见魔物。

• 冒险工具地图预览下方增加魔物表格，提供详情链接、等级、HP、属性与基础／职业经验，缺失数值显示“-”。地图区域滚动外层，NPC 列表滚到边缘后交给外层；有魔物时提供「地图魔物 ↓」入口。平板竖屏单独优化高度，NPC 标题移除数量，魔物名称对齐表头。物品图鉴掉落表格各字段统一左对齐。

• 桌面常驻表情、坐下／站起和骑乘／下骑入口；移动端从「动作」展开，所有端均取消点击自身角色打开动作的交互。骑乘条件不足使用会消失的 toast；手机、平板和桌面的提示位置分别适配，平板状态图标调整为 40px。

• 移动端登录、选服及角色选择提示复用注册弹窗的亮色样式，游戏内保持暗色。死亡时提供返回保存点和符合条件时的道具复活，等待救援后可从独立操作按钮重新打开。

• 战斗信息仅显示文本；传送阵、玩家、摊位、宠物、佣兵、生命体和死亡返回等操作使用框外黄色按钮，按钮出现时隐藏战斗信息。佣兵与生命体主动／被动统一黄色，以文字区分。

转职与装备同步

• 转职、技能授予／移除及装备脚本改变双持权限后，重新验证并同步装备部位，无需重新登录；非法普通／影子左手装备及切换配置会清理，合法盾牌、右手和现行 GM 权限保留。
• 转职在移除临时资格、更新技能树和骑乘等状态后校验穿戴与切换配置，再存档。完整背包和切换快照替换旧模型，预览不污染实际穿戴，过期图片回调不能恢复旧标记。

后台账号与设置

• 头像菜单支持自助修改后台密码；唯一部署开关 ADMIN_PASSWORD_CHANGE_ENABLED 默认 true，演示环境设为 false 可隐藏入口并拒绝改密，后台不能覆盖。改密验证当前密码、限制尝试频率、记录审计并使旧会话失效，CLI 维护不受限制。

• 账号可设为游戏管理员 GM（99）或普通玩家（0），使用独立 players.gm 权限。设置作用于全账号，完整退出游戏并重新登录后生效，不改变后台管理员身份。

• GM 保存校验旧权限组、服务器账号与删除状态，并记录审计；管理库迁移为 administrator 添加对应权限。

• 用户账号通过带编辑图标的「操作」菜单管理，敏感操作分隔，批量入口显示选中数量。GM 弹窗显示账号摘要、身份选项和重登提示。

• 游戏角色保留直接打开「角色属性」的六个 Tab 弹窗，便于连续调整；按钮使用统一描边和编辑图标。

• 游戏设置页移除底部嵌入的历史列表，从页头、保存提示或独立菜单进入修改记录。

• 游戏设置只提交实际改动项，保留其他管理员对无关字段的更新；未改动时不发布，保存及回读期间暂时锁定编辑。

• 游戏设置自动核对中断请求与地图服实际状态，确认成功或恢复持久化配置后解除等待；无法确认或发现外部文件修改时保留记录，不重发旧写请求，不承诺所有异常无条件回滚。

配置与维护

• 客户端默认设置由 schema 统一定义，Gateway 动态提供运行配置；已保存的个人设置优先。脚本文字最低对比度可配置，默认 4.5。

• 增加地图视野、行走上限、导航、召怪和工具权限环境变量；默认同步范围为 14 格。非空环境覆盖项不能在后台保存，冲突时整批拒绝。

• 数据库存储与 API 输出统一时间语义，API 使用带时区时间；显示时区通过 APP_TIMEZONE 配置，默认 Asia/Shanghai，不转换既有历史数据。

• ADMIN_CSRF_ORIGIN_CHECK_ENABLED 默认 false，关闭后台 Origin 与 Sec-Fetch-Site 来源限制，仍强制校验会话 CSRF Token；设为 true 后实际来源必须匹配 APP_URL。

• 离线资源复制、清单和最终 ZIP 过滤任意层级的 ._* 与 .DS_Store，保留业务文件和原始资源；历史包不回写。

• 修复物品请求在死亡、交易等状态被拒绝后缺少回执，导致客户端背包格持续锁定的问题。

• 修复 Gateway 构建时 NAVI 校验缺少服务端头文件的问题。

• 修复离线初始化时资料基线的读取权限；构建前校验跨仓库导航清单，过期清单拒绝打包，避免运行资源与源码不一致。

• HappyRO 不提供旧版本兼容或历史数据兼容迁移；本版使用配套的当前程序、资源和配置。

验证范围

经典主线、九职业转职与重登、训练场入口、地图故障恢复及部分移动视口交互已有本机真实服务验证。后台 GM、权限边界、来源校验和交互完成相应自动化及浏览器验证；数据库集成检查使用隔离实例。

本次转职装备修复完成自动化检查，服务端变更需重新构建部署并重启后生效；未将代码测试视为真实角色验收。后台改密已完成隔离数据库及浏览器验证。自动战斗技能修复完成 2,167 项客户端测试，以及挑衅、怒爆、信仰前置、留言陷阱排除、链电、火箭和冰箭的本机真实回包验证；完整逐技能实机覆盖、复杂连招及全部四转增益不在此次验证范围。

10 月 26 日另完成技能条件、导航标签及范围同步专项修复与验证，详情见当日日志。不同批次的测试数不合并为最终离线包验收数，旧截图与旧构建证据也不能替代本次交付验证。

浏览器移动视口不代表真实手机／平板验收；历史构建和本机源码测试不代表新离线包已完成双架构、升级回退、HTTPS 或真机全流程验收。职业外观、技能、随行功能的具体缺口继续按各专题维护。服务端托管自动战斗和离线挂机仍是设计议题，不列入本版功能。

完整变更见 10 月 24 日、10 月 25 日和 10 月 26 日日期日志，部署流程见发布手册。