查看“︁模块:ItemCommon/doc”︁的源代码

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

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

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

== 数据来源 ==
* [[数据:Item/item_name_index.json]]
* [[数据:Item/item_mapping.json]]

[[分类:模块文档]]