模組: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