metin2-client/docs/AVA2-WIKI-IMPLEMENTATION.md

AVA2 功能迁移：百科首批

日期：2026-10-15。对应 AVA2-FEATURE-MIGRATION-PLAN.md 的阶段 0 部分基础与阶段 1 查询子批；不是七项功能全部完成。

已实现

• 小地图旁“百科”入口，物品/怪物分类，中文/ID 搜索、分页及详情；仅创建当前页按钮。
• 按真实模板范围解析 ID，不把范围展开成虚构变体。
• 升级目标和材料可点击跳转、返回；展示数据库基础费用/概率，并提醒以实际精炼窗口为准。
• 点击生物学家材料图标打开百科；详情显示研究阶段、材料数量和既有研究商店兑换信息。
• 640×360 至普通桌面横屏布局，原移动技能布局保持不变。中文详情使用统一代码页转换，错误资源给出提示。
• UTF-8 版本化目录与输入/生成器/中文名称表哈希，数据字段及大小校验。静态资料能力声明不假装实时掉落、宝箱或模型预览可用。
• 新 wiki pack 纳入中文资源构建和 Android 增量更新。

当前目录：5756 个物品模板、763 个怪物/矿石模板、407 条升级配方。

ITEM_NONE 中包含研究任务石，因此不能一概视为无效物品。目录存在不等于已配置获取途径；怪物面板仅展示基础模板值，不冒充最终战斗属性。

服务端与资源

203 本次只执行公开表导出与只读 SELECT，没有部署、重启、数据库迁移或改动玩家数据。 metin2-server 新增 tools/wiki/export_public_tables.py 和 tests/wiki/test_export.py，可重复导出公开配置和升级配方；凭据留在操作系统现有 MySQL 配置，不进入资料包。 客户端工具见 tools/wiki/README.md。原 AVA2 及 ava2-client 未修改。

验证证据

证据目录：build/wiki-source/（忽略目录，不入库）。

• catalogue 合同测试 7/7：中文搜索、范围 ID、分页、升级/怪物字段、非法数据、清单哈希与可重复生成。
• 服务端导出工具 2/2：仅读公开输入、只读查询、禁止复用输出目录、失败清理与非法数据库名拒绝。
• wiki-integration-r2.log：中文客户端完整离线登录/界面/商店/战斗回归通过，并实际鼠标点击百科与生物学家材料入口。
• wiki-touch-final.log：触控模式完整回归通过；额外验证 640×360 排版、缺失资料提示及标准库导入兼容。
• english-regression.log：原英文资源完整离线回归通过。
• mac-render-final.log / wiki-final.png：macOS 原生实际渲染与截图。
• android-build-final.log：Android 编译产物；仅编译，尚未在手机安装或验证。

待完成

阶段 0 的服务端能力握手、查询扩展协议与统一功能收纳入口仍待后续接入；当前只打开静态目录能力，不发送新查询消息。 阶段 1 的 Vulkan 离屏模型预览未实现；需独立相机、资源生命周期及实际渲染回归。 阶段 2 的服务端真实掉落查询、阶段 3 宝箱奖励预览及其余属性/副本/洗练/日历/战令尚未实现。 当前 UI 属 AVA2 功能方向的触屏适配，不宣称像素级复刻其全部百科布局或功能。 203 联机及 Android 真机验收未做，不能把本机触控模式测试写成真机验证。