v0.5.0
v0.5.0 主要新增手机／平板冒险工具、竖屏游戏、桌面自动战斗与自动拾取，新增保持登录与断线恢复、职业外观选择，完善随行单位、社交、仓库、摆摊、装备服务和导航，并集中修复十二条主职业线的技能逻辑与表现、邮件资产处理及 NPC 中文任务流程。
冒险工具与导航
- 手机／平板新增完整冒险工具，覆盖地图、魔物、NPC、物品与 Zeny、角色管理及全服设置，复用桌面端功能与权限。
- 移动端导航整合到冒险工具，支持自动寻路及经过传送点后继续行走；修复切图后停步、加载中取消后仍继续寻路的问题。
- 地图默认落点与 NPC 接近位置增加安全检查，减少落在传送触发区域或无法接近目标的情况；地图图鉴用紫色标记预览服务端预计落点，实际传送时重新检查。
- 更新 NPC 图鉴的中文名称、地图位置及关联导航数据，补齐研究所 NPC 资料。
- 冒险工具与后台物品图鉴新增掉落来源查询和普通魔物／MVP／Mini 筛选，区分普通掉落与 MVP 奖励；显示基础掉率及已收录地图，不把掉率相加或计入服务器倍率。子类筛选只展示实际存在的类型，并保留筛选偏好。
- 冒险工具转职和等级调整按目标职业范围校正等级，转职后恢复 HP／SP／AP；移动端转职使用对应平台界面。
素质成长与精炼设置
- 普通玩家加点独立读取当前职业真实上限；即使角色维护仅对管理员开放，正常加点仍可使用。修复高素质时点数消耗溢出、无法继续加点的问题。
- 四转素质正常加点的单项上限从 110 提高到 32,767，仍需消耗足够点数；冒险工具新增四转素质点维护，按职业和原有权限校验。
- 冒险工具与后台新增精炼成功率倍率及「精炼必定成功」，统一作用于 NPC、精炼窗口及武器精炼技能；默认 1 倍、必定成功关闭。材料、装备限制及装备评级规则不变。
职业技能与战斗修复
- 修复十二条主职业线中的技能效果路由、施放／命中阶段、地面坐标及状态结束清理，覆盖一转到四转的相关技能；区域主体不再跟随角色移动或按每个命中目标重复播放。
- 修复四属性漩涡的属性通知与命中顺序、魔法半径覆盖本次施法等级、魔法书容量及失败释放丢失保存法术、传送之阵未保留所选技能等级等问题。
- 修复治疗、复活、护盾、毒药、连段、召唤与演奏等技能的资源、目标和状态处理；修复熔岩喷发周期伤害重复计算，以及龙息、能量外套、电击陷阱等在高属性配置下的整数溢出。
- 修复元素精灵扣材料后创建失败、上下机甲后防御与负重残留；恢复材料选择、制造装置、武器精炼及修理的封包处理，修正大物品 ID、材料扣除和产物流程，小型熔炉列表按成品去重。
- 补齐话匣子的中文输入、隐藏陷阱留言及正确消息长度，修复触发后收包错位／断线；桌面技能右键可打开说明。
- 为探测、狙杀瞄准、风之步及部分大主教增益补充可见反馈；这些程序效果不表示已完整复刻原版音画。
十二条职业线已完成代码复查，已有实机记录仍包含局部验证和未解决项；技能处理清单收口不代表全部技能及分支通过。详见技能修复与验证范围。
自动战斗与拾取
- 桌面端新增自动战斗，支持目标种类、攻击技能和范围配置，与手机／平板共用运行逻辑。
- 新增自动拾取，支持范围、物品类别与排除清单设置；排除物品可按编号或名称搜索、分页选择及批量管理。
- 自动战斗增加无目标时随机传送，协调战斗、拾取与传送顺序，避免拾取过程被打断。
- 修复随机传送错误使用固定落点的问题，区分随机传送与地图默认落点。
- 统一战斗与拾取设置入口和控件，自动保存配置；手动操作、切图及断线时正确暂停或清理状态。
手机与平板
- 支持竖屏游戏，并可在游戏内切换横竖屏；优化状态条、聊天入口、小地图及物品获取提示的位置。
- 手机竖屏默认拉远镜头，切回横屏恢复对应距离；镜头控制改为独立浮窗，修复镜头旋转后摇杆方向与画面不一致的问题。
- 手机竖屏采用上下布局，平板横竖屏保留左右内容分栏，窄窗口让工具栏和操作组换行；覆盖冒险工具、素质、技能、快捷键和装备服务等界面。
- 素质加点增加预分配流程，支持「+1」「+10」「MAX」、清空和统一确认，按实际点数消耗校验并显示服务端结果。
- 技能与快捷键统一格子尺寸和双列候选列表；快捷键支持翻页、显示绑定技能等级，并增加技能阶段与物品类型筛选。
- 优化输入框、键盘避让、表单草稿和滚动位置；精简入口，移除独立导航及装备套装菜单。
- 修复背包及同类列表滚动到底部、选择底部选项后回弹或跳动；图鉴、职业、技能、任务及邮件选择保留滚动位置，统一冒险工具分隔线两侧留白和底栏对齐。
- 长 toast 自动换行，获得物品提示显示在菜单上方；快捷键使用物品及穿戴装备复用背包校验和失败反馈，避免操作失败无提示。
- 缺少室内小地图图片时显示地形格；前台游戏增加屏幕常亮支持，切到后台释放，返回前台重新请求。
画面、声音与桌面交互
- 移动端背景音乐改用音频输出增益控制，修复 iOS 媒体音量设置不生效；声音开关与音量即时应用并保存。
- 修复恢复默认时渲染比例、画布与游戏光标不同步，锐化／饱和度为零时被默认值覆盖，以及调色板精灵忽略像素清晰设置的问题；需刷新生效的选项明确提示。
- 修复手柄死区小数截断、设置重开不同步及关闭后按键捕获残留，补齐标准全屏退出。
- 桌面窗口统一层级、定位和关闭交互；恢复仓库分类／搜索窗口及手推车转移，修复取出物品时本地数量重复扣减，并同步各窗口排序。
- 修复死亡玩家过早从实体索引移除，导致旁观者无法处理复活、离开视野后残留尸体的问题。
保持登录与断线恢复
- 手机、平板和桌面统一提供“保持登录”，HTTP 与 HTTPS 均支持；勾选后保留 30 天，重新打开游戏直接进入选角，不保存密码。
- 未勾选时仅在当前页面保留会话；游戏中意外断线后，返回前台自动认证并进入原角色，同地图恢复镜头，角色位置与状态以服务端为准。
- 修复切换账号时聊天界面尚未初始化导致卡在连接服务器的问题，并清理旧账号消息。
- 返回选角保留登录，主动退出撤销会话；密码修改、封禁或会话过期后需重新认证。不重放交易等操作，自动登录不踢掉已有在线角色。
聊天与 NPC 对话
- 移动端聊天分类决定发送频道，“全部”“系统”“战斗”仅用于阅读；私聊按对象保留当前页面内的会话、未读和草稿，并校验长中文角色名，不作为重新登录后的持久历史。
- 平板横竖屏和手机横屏采用分类、私聊对象与消息三列，仅手机竖屏将对象列表放在内容下方；支持新建和删除对象，发送失败在会话内提示。表情发送成功后立即收起聊天窗口，普通文字发送不关闭。
- 移动端新增游戏画面聊天预览，支持消息分类与显示行数设置，并增加原生表情选择。
- 桌面、手机和平板统一表情使用失败提示，明确说明未满足技能条件等原因；恢复桌面表情发送，玩家与宠物表情使用不因失败点击延长的 500ms 间隔。
- 修复 NPC 翻页时旧对白或立绘残留、图片异步加载错位的问题；仅隐藏与窗口标题确认同名的页首姓名标签。
- 修复碳酸水自动售货机等长中文 NPC 名称被截断后显示乱码的问题。
NPC 完整名称传输需要客户端与服务端配套更新，PACKETVER 保持 20211103。
物品与装备服务
- 背包增加物品插画、已插卡片和附魔说明，修复图片比例与装备详情显示。
- 优化商店数量输入、清单合计，以及仓库、手推车、交易、摆摊、材料和装备服务的布局与操作反馈。
- 修复精炼对话结束后服务窗口未打开的问题；附魔提交前重新检查装备、材料和 Zeny，等待结果期间阻止重复操作，避免结果显示到错误装备。
- 修复不可评级装备提交后一直等待、评级成功率与祝福加成显示错误，以及精炼失败但装备保留时误报损毁的问题。
- 统一精炼材料名称和说明，装备服务数据从当前 Renewal 数据库生成；补齐中文制作材料说明。
职业外观与骑乘
- 新增同职业线的旧阶段外观选择，覆盖十二条主职业线、十三个分支共 39 个选项；仅改变外观，真实职业、技能、属性和装备资格保持不变。
- 人物服装与对应坐骑外观绑定；没有对应骑狼或机甲形态时暂时显示真实职业完整形态，解除后恢复所选外观。
- 保存选择并同步给附近玩家与选角页；转职、性别变化及登录时重新校验资格，主体资源加载失败时本地恢复默认显示。
- 冒险工具集中提供手推车、坐骑、猎鹰、战狼和鹰的可用操作，沿用职业、技能、费用和权限限制。
宠物、生命体与佣兵
- 手机／平板选中自己的随行单位即可使用查看、喂食、表演、返回、攻击模式等对应快捷操作；信息菜单统一状态、技能与自动喂食控件。
- 宠物及生命体支持重复改名，统一名称字节校验和等待回包期间的防重复提交。
- 宠物进化规则改为从当前服务端生成，补齐配方和多分支选择；旧确认框、进化窗不会再作用于后来召唤的单位。
- 修复佣兵增量状态、攻击奖励与购买卷轴失败仍扣费，修复生命体被动加成、地面技能施放距离及艾莉诺后续连段目标。
- 修复攻击模式保存、零值状态同步和其他玩家宠物饰品更新污染自身窗口等问题。
社交、仓库与摆摊
- 好友详情可查询在线好友等级和地图；选中其他玩家可直接私聊、查看公开装备、申请好友或交易。
- 移动端仓库支持选择背包或手推车作为存取容器；未租用手推车时禁用对应选项。
- 修复玩家收购交易仍使用旧物品 ID 宽度导致等待不成交；对方关店后立即关闭失效商品列表。
- 修复队员升级／转职后等级与职业不更新、中文队名乱码。
- 摆摊支持分类与子类筛选，数量、单价、摊位名及收购预算使用适配软键盘的输入流程；点击自己的摊位牌子可重新管理。
邮件、交易与输入校验
- 移动端交易使用物品列表、我方、对方三列，手机竖屏改为三行；支持分类、子类和搜索，通过弹窗设置金额，双方金额显示在标题右侧。锁定后用两列核对窗口确认成交，物品不可交易或对方容量不足时明确提示。
- 邮件切换立即显示读取状态并复用背包快照，减少卡顿；标题与附件统一为黄色标题栏，寄件人和金额显示在右侧，标题和寄件人搜索不区分大小写。
- 写信标签位于输入框上方，内容与附件拆为上下等高的独立滚动区域，回包后保留滚动位置；附件移除按钮采用紧凑尺寸。
- 邮件在扣除物品、Zeny 与邮费前检查标题和完整费用，修复空标题扣除资产却未投递，以及大额金额计算溢出可能绕过扣款的问题；扣款失败不投递。
- 批量领取附件时计入尚未到账的同种物品数量，避免叠加超限导致附件丢失；超限附件留在原邮件中。
- 修改收件人后必须重新确认，忽略旧查询结果；建角名称、邮件及社交文本按 UTF-8 字节限制校验，超限明确拒绝，不静默截断中文。
- 聊天内容改为文本与受控链接渲染，修复公开聊天、私聊和物品链接内容被当作 HTML 执行的问题。
- 后台邮件发放不可堆叠装备及独立编号物品时按件拆分，每封最多 5 件；宠物蛋每次限 1 个，超量拒绝并提示分批。
- 修复已孵化宠物蛋交易被拒绝后一直等待，以及点数商店商品条目解析错位、越界或断线的问题。
中文内容与任务修复
- 补齐十二条主职业线原生 NPC 转职与正常重登验证，修复考试怪物名称、进度条提前结束、大主教试炼启动及十字军考试出口等问题。
- 集中补齐 NPC 对白、菜单、任务标题、物品及魔物名称的漏译与错译，修正不合理断句、中文输入答案及跨脚本名称引用。
- NPC 审读覆盖原启用清单 837 个文件，涉及城镇、职业、主线、副本、战场、公会和神器任务。
- 修复材料误扣或重复扣除、奖励遗漏、错误任务目标、任务状态、计时及入口恢复等问题，包括通信芯片交付、群狼日常入口、幻影露安达入口、朱佩洛斯材料扣除等流程。
- 同步相关客户端翻译源，并完成 The Sign 公告图片中文化；资源安装情况仍需在最终发布包中统一核验。
自定义与部署
- 增加
CUSTOM_DIR持久化定制流程，支持新增／按路径覆盖 NPC、原生数据库扩展和客户端资源覆盖；后台可刷新物品、魔物和静态 NPC 目录，备份／恢复包含定制文件。资源更新或删除无需重建镜像，游戏与目录分别重载／刷新。 - 更新后台 NPC 名称、地图位置和精炼物品翻译，修复空 NPC 快照处理。
- 修复服务端容器重连时的服务名解析，以及 Admin 镜像缺少默认脚本导入快照导致初始化失败的问题；跨机器资源归档补齐完整运行目录。
- Gateway 支持配置监听地址；macOS 原生部署隔离开发数据库，并由系统 launchd 管理 OpenResty 及后台静态入口。
保持登录需要客户端、Gateway、login-server、web-server 及会话数据库结构配套更新；部署工具会先执行会话表与撤销触发器升级，失败时停止后续启动。PACKETVER 保持 20211103。
旧部署升级需使用新版整包中的镜像、工具与 Compose 配置，不能只替换镜像；初始化 CUSTOM_DIR，保留数据、定制文件及密钥，并完成后台迁移和目录初始化／刷新。后台掉落来源索引迁移会补建已有魔物资料。
职业外观和好友详情新增配套封包，客户端与服务端需一起更新。四转素质上限及精炼设置属于本版规则变化，升级时核对已有自定义数据库与战斗配置，保留默认值或按实际玩法调整。
离线安装
- 文件：happyro-v0.5.0.zip
- 本机构建路径：
artifacts/deployment/happyro-v0.5.0.zip - 首次空库初始化为测试账号
happyro/happyro创建“罗安”（99/50 男剑士、10,000 Zeny），预配装备、药水、波利蛋、技能和六个快捷栏；已有数据库不补建或覆盖角色。
2026-10-22 重建的离线包包含 linux/amd64、linux/arm64 镜像及运行资源。Gateway（含完整 --all PWA）、Server、Go API（含 Admin 前端）和 Database 四组镜像均已全量无缓存构建，资源、镜像归档与完整 ZIP 均通过校验。
已从该 ZIP 独立解压，在 Mac 上完成 arm64 原生容器与 amd64 仿真容器的空库安装：七个常驻服务健康、api-init 退出 0、Gateway 启动页含「进入游戏」及查看器入口；两种架构均完成登录选角、进入地图、冒险工具、保持登录及后台操作验证。arm64 另通过重启持久化、自定义资源与 NPC、备份恢复及已有库重新部署验证。原生 x86 主机、手机真机、完整 HTTPS 会话矩阵、从 v0.3.2 保留数据升级与回退未在本轮执行。
完整 ZIP 的 SHA-256：
text
853cfa22cd45f6a506208c690d6399931cf2a22dcae08f590ab864464cf8eeb8Docker Hub
以下为 2026-10-21 的镜像发布记录，不作为 2026-10-22 重建离线包的远程发布凭据。该次四组镜像均已发布 v0.5.0，并将 latest 更新为相同内容。远程完整 index SHA-256 与当时本地 OCI 归档逐字节一致，且均含 linux/amd64 与 linux/arm64：
text
kugarocks/happyro-gateway:v0.5.0
kugarocks/happyro-server:v0.5.0
kugarocks/happyro-admin:v0.5.0
kugarocks/happyro-database:v0.5.0镜像不包含 kRO 运行资源，完整安装需配套运行资源包。
已知限制与待验收项
- 最新交易、邮件、列表滚动和提示优化已完成构建及部分本机操作／截图联调，仍需在最终离线包上执行横竖屏、真机输入和资产一致性回归；文档截图不代表完整验收。
- 保持登录与原角色恢复已通过浏览器视口及真实服务联调，iOS／Android 系统后台冻结和页面回收仍待真机验收；页面被回收后按重新打开处理，持久会话进入选角。
- 移动端自动拾取设置仍有用户反馈待复验，现有模拟未复现的问题不能视为已解决。
- 技能审查仍保留说明与实现差异、部分旧技能功能及音画缺口；不能将代码复查或已处理数量视为全技能通过，具体见技能待办。
- NPC 文件审读覆盖不代表所有玩法已通关；部分多人、战斗、长计时和完整长链任务仍待验收，旧公会接力在途角色状态需在升级前明确处理方式。
- 屏幕常亮依赖浏览器支持及 HTTPS 等安全上下文，系统省电策略可能拒绝；尚未完成真实手机等待熄屏验收。
- 职业外观已完成桌面矩阵与移动模拟验收，真实 iPhone／iPad 仍待验证；随行功能已完成部分双端分支复验，完整技能效果、中断矩阵及真机流程仍有待办。
- v0.3.2 已列出的 Safari HTTP WebSocket 登录、部分低频窗口、真实消耗场景及人工听音验收，尚无本轮完整闭环结论。
- 自动战斗仍不支持全地图巡逻。原生 x86 主机、真机操作及从 v0.3.2 升级与回退需补齐验收记录。