32 lines
2.6 KiB
Markdown
32 lines
2.6 KiB
Markdown
# 百科：当前服务器模板目录
|
||
|
||
AVA2 参考：`uiwiki.py` 的分类/搜索/升级材料与关联跳转；当前实现使用原生 PORT 界面和当前服务器数据，不加载整个 AVA2 root 或改变物品格式。
|
||
|
||
服务端的 `tools/wiki/export_public_tables.py` 只读导出 `share/conf` 下四个 proto/name 文件与 `player.refine_proto` 的配方列。导出目录放入客户端忽略的 `build/wiki-source/`：
|
||
|
||
```sh
|
||
python3 tools/wiki/build_catalogue.py --source build/wiki-source
|
||
python3 tests/wiki/test_catalogue.py
|
||
```
|
||
|
||
输出 `data/wiki/catalogue.txt` 和 `manifest.json`，包含输入哈希与内容版本。名称使用当前服务器名称及已有中文表，不带角色/账号数据。ITEM_NONE 不能一概过滤：AVA2 生物学家任务石使用此类型。目录只表示模板存在，不保证获取途径。
|
||
|
||
`scripts/build_zh_locale.py` 自动把目录打为 `wiki.eix/epk`，注册在 pack/Index；Android 增量同步摘要包含目录和生成器。源资料更新后需重新生成、打包并同步两份 pack 和 Index；仅安装新 APK 无法更新静态资料。
|
||
|
||
运行时安装 `mt_features`、`mt_wiki_data`、`mt_wiki`。模块按版本/字段/长度/数值/范围校验后一次加载，仅创建当前页控件。首次点击小地图旁“百科”加载数据；支持中文/ID、分类、分页、范围 ID、升级目标/材料跳转与返回；点击生物学家材料图标打开对应详情。
|
||
|
||
`mt_features` 为标准库调用及显式 level 导入保留原生 Python 导入语义；原 packed 游戏脚本的其他四参数导入继续原路径，原始 system.py 字节不改。中文搜索通过 `player.FeatureLocaleToUTF8` 使用同一套原生代码页映射，不要求 Python CJK 扩展。
|
||
|
||
`mt_wiki.ServerCapabilities()` 区分未知/启用状态；只读能力协商、掉落/来源/宝箱和属性查询见 docs/AVA2-READONLY-FEATURES.md。模型预览仍未实现，旧服未启用时显示未支持。升级展示为配方基础值，NPC/道具修正后的实际结果以精炼窗口为准。
|
||
|
||
集成测试（本机完整资源可用时）：
|
||
|
||
```sh
|
||
cmake --build build/native --target port_login_flow_test -j8
|
||
MT_TEST_WIKI=1 MT_TEST_MOBILE=1 MT_ASSETS_STRICT=1 \
|
||
build/native/src/port/port_login_flow_test \
|
||
"$PWD/build/zh-locale/Client" "$PWD/build/release/src/host/python27.zip"
|
||
```
|
||
|
||
测试通过真实 Python 2 UI/鼠标命中验证小地图入口、中文输入、升级跳转/返回、生物学家材料入口、640×360 排版、缺失资料提示与退出，并回归原离线登录/背包/商店/战斗流程。触控模式是桌面宿主回归，不能代替 Android 真机验收。
|