2026-10-26

新增

• [client] 新增 TIPBOX 与物品引用共用参考阅读器，支持帮助跳转、分页、图片、物品说明和历史返回；有效 ITEM、ITEMLINK 与技能物品编号可查看只读详情，无效引用保留文字。

优化

• [client] NPC NAVI 按可传送坐标或有效魔物结果开放，不要求目标 NPC 实体、名称或入口匹配。点击提示“已加入导航，结束对话后可传送。”；正常结束后显示黄色独立“打开地图 / 取消”按钮，不改变 NPC 封包流程。桌面入口位于原两行操作按钮上方，左右对齐，半透明背景且悬停样式不变。
• [client] 任务、物品、装备比较、技能与冒险工具说明中的 NAVI 打开普通地图标点或魔物图鉴；关闭恢复来源、选择和滚动位置，开始寻路或发送传送请求后释放来源。不可用目标仅保留文案，交易等服务端操作窗口及其帮助引用继续限制导航。
• [client] 战斗信息仅显示文本；传送阵、玩家、摊位、宠物、佣兵、生命体及死亡返回等上下文操作使用框外黄色按钮，出现操作时隐藏战斗信息；传送阵显示“进入传送阵 / 取消”，佣兵和生命体主动／被动统一黄色。
• [client] 坐标传送成功不再弹 toast，保留真实到达确认以及失败、超时提示。
• [client] TIPBOX 桌面使用冒险工具浅色主题与游戏鼠标，手机和平板适配安全区域及菜单密度；返回和关闭统一在标题右侧，手机紧凑布局、平板 40px 按钮与 16px 字号，阅读区上下固定留白。触屏点击不残留焦点边框，键盘焦点提示保留。
• [client] 自动战斗默认搜怪范围为 40 格、活动范围为 50 格，保留已保存设置；手机和平板“停止战斗”使用黄色，技能卡片复用技能菜单尺寸并固定两行，不可用原因放在等级右侧；桌面“全部魔物”与“普通攻击”按钮统一 32px 高度。

修复

• [server] 死亡、交易、聊天室及禁止使用物品状态拒绝物品请求时补发失败回执，避免客户端持续锁住对应背包格；提前校验索引，覆盖拒绝、恢复及非法索引回归测试。
• [root] Gateway 构建阶段补入 NAVI 校验依赖的服务端头文件，并验证独立阶段的 COPY 输入足以完成校验，修复干净构建缺失文件失败。
• [client/server] 默认同步与搜怪范围调整为 14 格、活动范围 30 格；服务端推送实际范围，客户端限制步进、保存与执行，旧超限偏好按实际上限生效，断线清除旧上限；同步部署模板和文档。
• [client/server] 战斗设置动态增删临时技能并保留选择、滚动与焦点；服务端沿现有状态封包同步目标标记与归属，客户端仅对明确不符的目标提示。基础 SP、缺失字段及无法确认的条件不再推测为不可用。修复过程与验证单独记录在技能条件修复目录。
• [client] 主线职业审计修正巅峰模式、能量外套与猎狼前置、零消耗工具持有、Zeny／酸化材料减免和已知目标免疫过滤；巅峰减益模式沿用减益预算，魔物资料区分真实 Boss class。
• [client] 修正武器／防具类型颠倒、实际盾牌装备槽与双持类型判断，解决装备长矛后重登仍误报武器不符；战斗设置每 200 毫秒仅更新技能条件文字并保留勾选和滚动。同步修正骑龙、姿态、额外弹药与球消耗条件，接入独立灵魂球数量，弹药索引去重避免重复计数。
• [root] 修正任务 11363 的 NAVI 开头、任务 8772 的 ITEM 开头、帮助 18 的放大镜物品编号及帮助 67 的图片路径；官方源不变，运行资源从已编译并通过语义校验的翻译源生成。
• [client] 冒险工具、任务、物品、装备、NPC、技能、成就及移动端各类说明共享安全标签渲染，支持受限 FONT 颜色与相对字号、HTTP(S) 新标签页链接和可用帮助／物品引用。剔除内部 INFO 与危险属性，保留普通尖括号文字，修复跨行颜色、跨链接颜色、排版交叉闭合和残缺引用吞掉后续链接。
• [client] 修复背包与技能无选中项时列表滚动回弹，以及从 NAVI 地图返回背包时列表抖动；隐藏面板暂停刷新，恢复权限和数据后再显示并还原滚动。减少宠物、商店与材料无变化重绘，保留聊天联系人刷新位置。
• [client] 修复桌面来源窗口导航后隐藏残留、旧来源被替换后错误恢复、隐藏来源阻止帮助再次导航、重复打开地图丢失返回入口，以及 NPC 导航接替物品导航后遗留隐藏窗口；异步结果不能打开已取消或被阻止的来源。
• [client] 输入冻结改为按窗口所有者获取和释放，修复嵌套帮助、来源关闭／替换与重连交错时卡住或提前解冻；帮助键盘操作不穿透 NPC，修饰键松开及时同步，图片失败可重试且迟到图片不破坏阅读位置。
• [client] 补齐任务、装备、冒险工具、技能和成就的文字对比度与链接样式，修复成就详情换行滚动、交易说明缓存及只读装备帮助导航被误禁用。
• [client] 修复手机和平板无魔物时范围设置与技能首行边框不齐，以及自动瞬移等待恢复时“停止战斗”按钮闪回“自动战斗”；等待期间点击停止可取消恢复。
• [server] 活动 NPC 对话、地图尚未就绪和附近没有安全落点分别明确拒绝导航传送；加载期间导航请求进入专门拒绝处理，避免静默丢包等待超时。保留服务端权限、地图限制、冷却与安全落点兜底。
• [api] 补齐活动对话、无安全落点和地图未就绪的导航失败中文提示。

部署与维护

• [root] 发布命令按 offline、resources 和 stage 分组，统一 create --rebuild 与按版本推送；分阶段构建共用受管理目录、锁和状态，补充只读产物状态与显式完整性校验。验收新增批次列表和实时服务状态，健康等待参数明确为 --health-timeout，帮助与参数定义统一生成，不保留旧命令别名。
• [root] 跨机器构建资源包统一为 release.py resources create，移除独立 Shell 打包脚本；生成逐文件清单和归档摘要，校验打包前后资源一致性，支持 --rebuild 预检后清理并重新生成，按版本独立登记并通过 resources clean 清理，不与 runtimes 部署拆分包混用。
• [root] 验收 clean --execute 先停止环境、确认网络已移除，再删除整个批次及其数据库、报告、日志和截图，清理后允许复用批次名；默认仅预览，stop 继续保留数据，原始离线包与共享镜像不受影响。
• [root] 验收容器使用可读的 happyro-test 批次前缀，保留哈希隔离与已登记项目身份；发布、部署和验收工具统一彩色阶段、耗时、日志路径及每 10 秒等待提示，支持 --no-color，失败和中断不报告成功。
• [root] 离线发布入口支持一键打包、同版本清理重建、独立拆分包和版本范围清理；拆分包附带 README 与完整性报告，使用进程锁阻止并发覆盖，默认不推送 Docker Hub，仅显式指定 --push 或 push 子命令时发布。
• [root] 允许从包含未提交改动的当前工作区构建，记录六个构建仓库的 HEAD、工作区状态与源码指纹；构建期间源码变化时停止组包。
• [root] 增加离线包独立运行、基础验收、停止与清理工具，隔离容器、网络和端口；基础验收检查服务健康、HTTP 入口及罗安登录进入游戏和移动，清理测试安装后保留报告与截图。
• [root] 按职责整理 tools：发布独立到 release，离线部署仅携带标准库工具，本机服务配置归 operations；来源采集与运行资源生成分离，跨应用验收集中管理。统一固定依赖、CLI 清单和自动测试入口，合并资源安装器、浏览器控制器及三角色技能会话，删除重复和固定旧环境的临时脚本。
• [client] NAVI 审查工具拆分为语法、地形与决策模块，更新发布清单中的工具路径和来源指纹；2,410 项目标决策逐项相同。
• [api] 将镜像内自定义目录生成器及其 Python 测试移入 API 仓库，Docker 构建从所属仓库复制，目录生成规则不变。
• [root] 将代理网络动态地址池与 Admin 固定地址分离，修复 API 先启动导致后台地址冲突；容器测试复用发布模板并验证启动、API 重建及代理来源 IP，备份命令补停独立 Admin。
• [root] 为独立 Admin／API 设置专用代理网络，仅信任 Admin 固定地址，恢复后台登录限流和审计的来源 IP；补齐镜像拆分、服务数量与端口监听说明。
• [root/admin/api] 后台前端拆为独立非 root Nginx 镜像，与 Go API 通过同源代理协作；API 不再提供 HTML，离线构建、校验、Compose 和发布统一使用 Gateway、Server、API、Admin、Database 五类双架构镜像，后台端口保持不变。
• [root/api] 优化离线镜像层：Gateway 安装依赖时清理 npm 缓存，复制前端与源码时直接设置所有权；服务端复制时设置执行权限；API 在独立阶段整理资料权限后一次性复制，避免最终镜像重复存储文件，保留基础镜像、双架构和全部资源。
• [root] 增加 NAVI 与 TIPBOX 审查／生成工具；客户端刷新、镜像构建和 Gateway Docker 构建先核对跨仓库导航清单，过期清单停止构建。新增独立说明标签文档目录，记录最终交互、数据口径与验证边界。
• [root] 默认配置模板与客户端配置说明同步搜怪 40 格、活动 50 格，避免部署文档与客户端默认值不一致。

验证与待办

• [root] 完成两轮五类镜像无缓存双架构构建，完整包与拆分包校验、同版本重建及清理通过；arm64 离线安装与罗安登录移动实测通过。工具测试、CLI 契约与文档构建通过；Docker Hub 推送仅覆盖受控测试，未执行远程发布，未复验 amd64 运行或完整游戏功能。
• [root/client/server] 实测后统一修复完成 225 项相关自动化测试，三端真实技能列表增删、桌面焦点移除、龙骑士标记与审判者三击烙印正负例通过；完整 PWA 与 map-server 构建并更新本机（mvokfa6v）。活动标记目标离开再进入视野未完成实机验证，单独保留验证边界。
• [root/client] 固定 mvo7nxvf 完成 12 条主线、13 棵树的 349 个常规自动候选实机请求：214 项有成功／落地证据、125 项仅确认拒绝、10 项未确认终结回执；另验证猎人魂临时技能列表刷新缺口。对照实际技能选项提示与服务器结果，记录目标标记、地形和宝石豁免的预判边界，本轮未修复或更换运行版本。
• [root/client] 12 条主线职业审计覆盖 13 树、996 条职业技能记录、804 个不同技能，相关 173 项测试通过，完整构建及指定角色双手矛登录核对完成（mvo7nxvf）。最终 SP 费用、连段球数、标记归属及动态场地存在已记录的客户端预判缺口，未宣称全职业实机通过。
• [root/client] 规范化翻译及 NPC 源码统计 NAVI 7015、TIPBOX 4176、ITEM 1777、URL 112、FONT 207、B 59、I 1；INFO 为内部数据，不重复计数。1126 个静态物品 ID 均有名称，静态标签配对异常修复后为 0；7 处无效 TIPBOX 引用保留文字。统计不是已加载 NPC 数量。
• [root/client] 最终标签修复完成静态复审、资源语义和哈希校验、完整 PWA 构建及本机 Gateway 产物核对（mvo6udtc）。按用户要求未继续自动化或实机测试，历史版本测试和截图不能替代最终版本验收。
• [root] v0.6.0 四类镜像完整无缓存构建 amd64／arm64，离线 ZIP 校验、双架构本机运行、触屏视口、备份恢复及保留原密钥的 v0.5.0 备份升级通过；Docker Hub 的 v0.6.0／latest 完整 index 与双架构子摘要一致。验收边界与产物 SHA-256 见版本摘要，未声明真机及完整 HTTPS 会话矩阵通过。