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

44 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 真机验收未做,不能把本机触控模式测试写成真机验证。