模块:ItemCommon/doc

概述

ItemCommon 提供物品域共享的查找、身份回退与配方域构建能力，供各子域模块复用。

常用函数

• loadItemIdentityData：读取 数据:Item/item_name_index.json 与 数据:Item/item_mapping.json。
• findItemRecord：按中文名、英文名或 ID 查找物品身份记录。
• resolveItemId：返回统一物品 ID。
• resolveItemName：返回统一中文名。
• resolveItemNameEn：返回统一英文名。
• sortItemKeys：按物品类型、系列、等级/稀有度对物品键进行稳定排序。
• sortRecordsByItemKey：按记录中的物品键复用同一套排序规则，适合商店、配方等列表域。
• buildRecipeDomain：为子域模块挂接 getField / processRecipeList / productionRecipeList / machineList。
• getField：会统一处理部分显示映射与“0 视为空值”规则，例如宠物类型、摆放类型、可食用布尔值、发射类型等。

排序规则

• 先按物品类型聚合，再按系列分组。
• 同一系列内优先按等级或稀有度从低到高排列。
• 如果基础款没有 Lv1 后缀，会按同系列最低档处理，便于把 简易制造台 / 标准制造台 / 精良制造台 这类条目排在一起。

数据来源

• 数据:Item/item_name_index.json
• 数据:Item/item_mapping.json