poi-plugin-kancolle-chs 1.3.0 → 1.3.8

package/index.es

@@ -31,13 +31,7 @@ export const pluginDidLoad = async () => {
         await mainPatcher.buildAndDeploy()
       }
 
-      // 4. 若开启了启动自动检查更新，后台静默检查
-      if (configManager.get('autoCheckUpdate', true)) {
-        import('./src/core/git-manager').then(({ gitManager }) => {
-          gitManager.checkForUpdates().catch(() => {})
-        }).catch(() => {})
-      }
-
+      // 4. 若开启了启动自动检查更新，由 MainPanel 在渲染时自动检测并在有更新时弹窗提醒
       console.log('[砍口垒汉化计划PLUS] 插件加载完毕，原生汉化模式已生效！')
     } else {
       console.log('[砍口垒汉化计划PLUS] 插件当前处于停用状态，确保环境纯净官方原版...')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-kancolle-chs",
-  "version": "1.3.0",
+  "version": "1.3.8",
   "description": "砍口垒汉化计划PLUS POI 原生独立插件：提供全界面文本替换、正则动态替换、KCSAPI 响应合流、中文字体与贴图魔改、自定义字体适配与官方资源更新",
   "main": "index.es",
   "files": [
@@ -9,6 +9,11 @@
     "assets/",
     "generated/"
   ],
+  "scripts": {
+    "pub": "node scripts/publish-to-npm.js",
+    "publish-plugin": "node scripts/publish-to-npm.js",
+    "pub:dry": "node scripts/publish-to-npm.js --dry-run"
+  },
   "author": {
     "name": "泉浅漪",
     "link": "https://github.com/asaico",

package/src/config.es

@@ -93,6 +93,9 @@ class ConfigManager {
 
       if (saved && typeof saved === 'object') {
         this.config = { ...DEFAULT_CONFIG, ...saved }
+        if (saved.autoCheckResourceUpdate === undefined && saved.autoCheckUpdate !== undefined) {
+          this.config.autoCheckResourceUpdate = saved.autoCheckUpdate
+        }
       } else {
         // 若首次启动且无配置，尝试全平台推荐路径初始化
         for (const candidate of RECOMMENDED_SOURCE_PATHS) {

package/src/constants.es

@@ -15,7 +15,7 @@ export const OFFICIAL_REPO_GIT = 'https://github.com/asaico/Kancolle_to_CHS.git'
 export const OFFICIAL_REPO_RELEASES = 'https://github.com/asaico/Kancolle_to_CHS/releases'
 
 // 插件版本与 npm 元信息
-let pkgVersion = '1.3.0'
+let pkgVersion = '1.3.8'
 try {
   const pkg = require('../package.json')
   if (pkg && pkg.version) pkgVersion = pkg.version
@@ -70,6 +70,7 @@ export const DEFAULT_CONFIG = {
   enableApiMapInfo: true,         // 出击海区与作战行动说明 (start2.api_mst_mapinfo.json)
   enableApiPictureBook: true,     // 舰船与装备图鉴介绍 (picture_book.ship / slotitem)
   enableApiFlavor: true,          // 海域进点气象与深海台词 (battle.api_flavor_info.json)
+  enableApiItem: true,            // 消耗道具与商城道具汉化 (useitem / payitem.json)
 
   // --- 3. 静态魔改资产细分开关 ---
   enableFontHack: true,           // 默认中文字体替换(思源黑体)
@@ -82,8 +83,9 @@ export const DEFAULT_CONFIG = {
   customFontPath: '',             // 本地字体文件绝对路径 (.woff2 / .ttf / .otf)
 
   // --- 5. 官方资源与更新管理 ---
-  autoCheckUpdate: true,          // 插件启动时是否在后台自动检查更新
-  downloadMirror: 'direct',       // 资源下载加速镜像，默认 'direct' (GitHub 官方直连)
+  autoCheckUpdate: true,                  // 插件启动时是否在后台自动检查更新
+  autoCheckResourceUpdate: true,          // 启动 POI 时自动检查本地汉化资源更新并在面板提示
+  downloadMirror: 'direct',               // 资源下载加速镜像，默认 'direct' (GitHub 官方直连)
 
   // --- 6. 游戏运行帧率上限调节 ---
   fpsLimit: 60,                   // 游戏帧率上限 (默认 60，可选 60, 120, 165, 240)

package/src/core/api-merger.es

@@ -11,6 +11,7 @@ export function generateApiPatcherScript(apiData, options = {}) {
     enableApiMapInfo = true,
     enableApiPictureBook = true,
     enableApiFlavor = true,
+    enableApiItem = true,
   } = options
 
   // 若所有 API 模块均未启用，则不注入 XHR 拦截代码
@@ -21,7 +22,8 @@ export function generateApiPatcherScript(apiData, options = {}) {
     enableApiFurniture ||
     enableApiMapInfo ||
     enableApiPictureBook ||
-    enableApiFlavor
+    enableApiFlavor ||
+    enableApiItem
 
   if (!anyApiEnabled) {
     return ''
@@ -33,6 +35,10 @@ export function generateApiPatcherScript(apiData, options = {}) {
     furniture = {},
     mapinfo = {},
     slotitem = {},
+    slotitemEquiptype = {},
+    stype = {},
+    useitem = {},
+    payitem = {},
     pictureBookShip = {},
     pictureBookSlot = {},
     questlist = {},
@@ -45,6 +51,10 @@ export function generateApiPatcherScript(apiData, options = {}) {
   const activeFurniture = enableApiFurniture ? furniture : {}
   const activeMapInfo = enableApiMapInfo ? mapinfo : {}
   const activeSlot = enableApiShip ? slotitem : {}
+  const activeEquiptype = enableApiShip ? slotitemEquiptype : {}
+  const activeStype = enableApiShip ? stype : {}
+  const activeUseitem = enableApiItem ? useitem : {}
+  const activePayitem = enableApiItem ? payitem : {}
   const activePBShip = enableApiPictureBook ? pictureBookShip : {}
   const activePBSlot = enableApiPictureBook ? pictureBookSlot : {}
   const activeQuest = enableApiQuest ? questlist : {}
@@ -61,6 +71,7 @@ export function generateApiPatcherScript(apiData, options = {}) {
     enableApiMapInfo: ${enableApiMapInfo ? 'true' : 'false'},
     enableApiPictureBook: ${enableApiPictureBook ? 'true' : 'false'},
     enableApiFlavor: ${enableApiFlavor ? 'true' : 'false'},
+    enableApiItem: ${enableApiItem ? 'true' : 'false'},
   }, window.__kanchs_api_options || {});
 
   window.__kanchs_api_data = Object.assign({
@@ -69,6 +80,10 @@ export function generateApiPatcherScript(apiData, options = {}) {
     furniture: ${JSON.stringify(activeFurniture)},
     mapinfo: ${JSON.stringify(activeMapInfo)},
     slotitem: ${JSON.stringify(activeSlot)},
+    slotitemEquiptype: ${JSON.stringify(activeEquiptype)},
+    stype: ${JSON.stringify(activeStype)},
+    useitem: ${JSON.stringify(activeUseitem)},
+    payitem: ${JSON.stringify(activePayitem)},
     pictureBookShip: ${JSON.stringify(activePBShip)},
     pictureBookSlot: ${JSON.stringify(activePBSlot)},
     questlist: ${JSON.stringify(activeQuest)},
@@ -198,6 +213,105 @@ export function generateApiPatcherScript(apiData, options = {}) {
       }
     }
 
+    // 6. 装备类型分类母表 (start2.api_mst_slotitem_equiptype.json)
+    if (getOpt('enableApiShip') && Array.isArray(data.api_mst_slotitem_equiptype)) {
+      const EQUIPTYPE_DATA = getData('slotitemEquiptype');
+      for (let i = 0; i < data.api_mst_slotitem_equiptype.length; i++) {
+        const eq = data.api_mst_slotitem_equiptype[i];
+        if (!eq || eq.api_id === undefined) continue;
+        const patch = EQUIPTYPE_DATA[eq.api_id] || EQUIPTYPE_DATA[String(eq.api_id)];
+        if (patch && patch.api_name) {
+          const origName = eq.api_name;
+          eq.api_name = patch.api_name;
+          if (typeof window !== 'undefined' && window.__kanchs_dynamic_dict && origName) {
+            window.__kanchs_dynamic_dict[origName] = patch.api_name;
+          }
+          modified = true;
+        }
+      }
+    }
+
+    // 7. 基础舰种母表 (start2.api_mst_stype.json)
+    if (getOpt('enableApiShip') && Array.isArray(data.api_mst_stype)) {
+      const STYPE_DATA = getData('stype');
+      for (let i = 0; i < data.api_mst_stype.length; i++) {
+        const st = data.api_mst_stype[i];
+        if (!st || st.api_id === undefined) continue;
+        const patch = STYPE_DATA[st.api_id] || STYPE_DATA[String(st.api_id)];
+        if (patch && patch.api_name) {
+          const origName = st.api_name;
+          st.api_name = patch.api_name;
+          if (typeof window !== 'undefined' && window.__kanchs_dynamic_dict && origName) {
+            window.__kanchs_dynamic_dict[origName] = patch.api_name;
+          }
+          modified = true;
+        }
+      }
+    }
+
+    // 8. 消耗道具母表 (start2.api_mst_useitem.json)
+    if (getOpt('enableApiItem') && Array.isArray(data.api_mst_useitem)) {
+      const USEITEM_DATA = getData('useitem');
+      for (let i = 0; i < data.api_mst_useitem.length; i++) {
+        const u = data.api_mst_useitem[i];
+        if (!u || u.api_id === undefined) continue;
+        const patch = USEITEM_DATA[u.api_id] || USEITEM_DATA[String(u.api_id)];
+        if (patch) {
+          if (patch.api_name) {
+            const origName = u.api_name;
+            u.api_name = patch.api_name;
+            if (typeof window !== 'undefined' && window.__kanchs_dynamic_dict && origName) {
+              window.__kanchs_dynamic_dict[origName] = patch.api_name;
+            }
+          }
+          if (patch.api_description) {
+            u.api_description = patch.api_description;
+            if (Array.isArray(patch.api_description)) {
+              for (let dIdx = 0; dIdx < patch.api_description.length; dIdx++) {
+                const line = patch.api_description[dIdx];
+                if (typeof line === 'string' && line.trim()) {
+                  registerBrVariants(line, line);
+                }
+              }
+            } else if (typeof patch.api_description === 'string') {
+              registerBrVariants(patch.api_description, patch.api_description);
+            }
+          }
+          modified = true;
+        }
+      }
+    }
+
+    // 9. 商城与点券道具母表 (start2.api_mst_payitem.json)
+    if (getOpt('enableApiItem') && Array.isArray(data.api_mst_payitem)) {
+      const PAYITEM_DATA = getData('payitem');
+      for (let i = 0; i < data.api_mst_payitem.length; i++) {
+        const p = data.api_mst_payitem[i];
+        if (!p || p.api_id === undefined) continue;
+        const patch = PAYITEM_DATA[p.api_id] || PAYITEM_DATA[String(p.api_id)];
+        if (patch) {
+          if (patch.api_name) {
+            const origName = p.api_name;
+            p.api_name = patch.api_name;
+            if (typeof window !== 'undefined' && window.__kanchs_dynamic_dict && origName) {
+              window.__kanchs_dynamic_dict[origName] = patch.api_name;
+            }
+          }
+          if (patch.api_description) {
+            const origDesc = p.api_description;
+            p.api_description = patch.api_description;
+            registerBrVariants(origDesc, patch.api_description);
+          }
+          if (patch.api_shop_description) {
+            const origShop = p.api_shop_description;
+            p.api_shop_description = patch.api_shop_description;
+            registerBrVariants(origShop, patch.api_shop_description);
+          }
+          modified = true;
+        }
+      }
+    }
+
     return modified;
   }
 
@@ -298,19 +412,102 @@ export function generateApiPatcherScript(apiData, options = {}) {
   }
 
   function patchFlavor(data) {
-    if (!getOpt('enableApiFlavor') || !data || !Array.isArray(data.api_flavor_info)) return false;
+    if (!getOpt('enableApiFlavor') || !data || typeof data !== 'object') return false;
     let modified = false;
     const FLAVOR_DATA = getData('flavorInfo');
+    const SHIP_DATA = getData('ship');
+    const dynamicDict = window.__kanchs_dynamic_dict || {};
+
+    // 1. 处理战斗台词与深海入场 (api_flavor_info 数组或单个对象)
+    if (data.api_flavor_info) {
+      const list = Array.isArray(data.api_flavor_info) ? data.api_flavor_info : [data.api_flavor_info];
+      for (let i = 0; i < list.length; i++) {
+        const f = list[i];
+        if (!f || typeof f !== 'object') continue;
+
+        // 尝试通过 api_voice_id 或 api_boss_ship_id 匹配汉化补丁
+        let patch = null;
+        if (f.api_voice_id !== undefined && f.api_voice_id !== null) {
+          patch = FLAVOR_DATA[f.api_voice_id] || FLAVOR_DATA[String(f.api_voice_id)];
+        }
+        if (!patch && f.api_boss_ship_id !== undefined && f.api_boss_ship_id !== null) {
+          patch = FLAVOR_DATA['ship_' + f.api_boss_ship_id] || FLAVOR_DATA[f.api_boss_ship_id];
+        }
 
-    for (let i = 0; i < data.api_flavor_info.length; i++) {
-      const f = data.api_flavor_info[i];
-      if (!f || f.api_voice_id === undefined) continue;
-      const patch = FLAVOR_DATA[f.api_voice_id];
-      if (patch) {
-        if (patch.api_message) f.api_message = patch.api_message;
-        if (patch.api_class_name) f.api_class_name = patch.api_class_name;
-        if (patch.api_ship_name) f.api_ship_name = patch.api_ship_name;
-        modified = true;
+        const origMsg = f.api_message || '';
+        const origShip = f.api_ship_name || '';
+        const origClass = f.api_class_name || '';
+
+        if (patch) {
+          if (patch.api_message) {
+            f.api_message = patch.api_message;
+            registerBrVariants(origMsg, patch.api_message);
+            modified = true;
+          }
+          if (patch.api_class_name) {
+            f.api_class_name = patch.api_class_name;
+            if (origClass) dynamicDict[origClass] = patch.api_class_name;
+            modified = true;
+          }
+          if (patch.api_ship_name) {
+            f.api_ship_name = patch.api_ship_name;
+            if (origShip) dynamicDict[origShip] = patch.api_ship_name;
+            modified = true;
+          }
+        }
+
+        // 兜底 1: 若未由 patch 提供 ship_name 或 class_name，尝试通过舰船表与动态字典补全汉化
+        if (f.api_boss_ship_id && SHIP_DATA && SHIP_DATA[f.api_boss_ship_id] && SHIP_DATA[f.api_boss_ship_id].api_name) {
+          if (!patch || !patch.api_ship_name) {
+            f.api_ship_name = SHIP_DATA[f.api_boss_ship_id].api_name;
+            if (origShip) dynamicDict[origShip] = f.api_ship_name;
+            modified = true;
+          }
+        } else if (f.api_ship_name && dynamicDict[f.api_ship_name]) {
+          f.api_ship_name = dynamicDict[f.api_ship_name];
+          modified = true;
+        }
+
+        if (f.api_class_name && dynamicDict[f.api_class_name]) {
+          f.api_class_name = dynamicDict[f.api_class_name];
+          modified = true;
+        }
+
+        // 兜底 2: 若 api_message 未被 voice_id 补丁命中，尝试字典直接替换
+        if ((!patch || !patch.api_message) && f.api_message) {
+          if (dynamicDict[f.api_message]) {
+            f.api_message = dynamicDict[f.api_message];
+            registerBrVariants(origMsg, f.api_message);
+            modified = true;
+          } else {
+            const clean = f.api_message.replace(/<br\\s*\\/?>/gi, '');
+            if (dynamicDict[clean]) {
+              f.api_message = dynamicDict[clean];
+              registerBrVariants(origMsg, f.api_message);
+              modified = true;
+            }
+          }
+        }
+      }
+    }
+
+    // 2. 处理海图进点气象/剧情提示 (api_cell_flavor 对象)
+    if (data.api_cell_flavor && typeof data.api_cell_flavor === 'object') {
+      const cf = data.api_cell_flavor;
+      if (cf.api_message) {
+        const orig = cf.api_message;
+        if (dynamicDict[orig]) {
+          cf.api_message = dynamicDict[orig];
+          registerBrVariants(orig, cf.api_message);
+          modified = true;
+        } else {
+          const clean = orig.replace(/<br\\s*\\/?>/gi, '');
+          if (dynamicDict[clean]) {
+            cf.api_message = dynamicDict[clean];
+            registerBrVariants(orig, cf.api_message);
+            modified = true;
+          }
+        }
       }
     }
 
@@ -327,7 +524,12 @@ export function generateApiPatcherScript(apiData, options = {}) {
       return url.indexOf('/api_start2/getData') !== -1 ||
              url.indexOf('/api_get_member/picture_book') !== -1 ||
              url.indexOf('/api_get_member/questlist') !== -1 ||
-             url.indexOf('/api_req_map/') !== -1;
+             url.indexOf('/api_req_map/') !== -1 ||
+             url.indexOf('/api_req_sortie/') !== -1 ||
+             url.indexOf('/api_req_combined_battle/') !== -1 ||
+             url.indexOf('/api_req_battle_midnight/') !== -1 ||
+             url.indexOf('/api_req_practice/') !== -1 ||
+             url.indexOf('battle') !== -1;
     }
 
     function handleIntercept(target) {
@@ -363,8 +565,19 @@ export function generateApiPatcherScript(apiData, options = {}) {
           modified = patchPictureBook(json.api_data, target._kanchs_body);
         } else if (url.includes('/api_get_member/questlist')) {
           modified = patchQuestlist(json.api_data);
-        } else if (url.includes('/api_req_map/')) {
-          modified = patchFlavor(json.api_data);
+        }
+
+        // 战斗、夜战、联合舰队或海图进点：检查并合流深海台词 (api_flavor_info) 与海况剧情 (api_cell_flavor)
+        if (
+          url.includes('/api_req_sortie/') ||
+          url.includes('/api_req_combined_battle/') ||
+          url.includes('/api_req_battle_midnight/') ||
+          url.includes('/api_req_practice/') ||
+          url.includes('/api_req_map/') ||
+          (json.api_data && (json.api_data.api_flavor_info || json.api_data.api_cell_flavor))
+        ) {
+          const flavorModified = patchFlavor(json.api_data);
+          modified = modified || flavorModified;
         }
 
         if (modified) {

package/src/core/main-patcher.es

@@ -255,6 +255,7 @@ class MainPatcher {
         enableApiMapInfo: configManager.get('enableApiMapInfo', true),
         enableApiPictureBook: configManager.get('enableApiPictureBook', true),
         enableApiFlavor: configManager.get('enableApiFlavor', true),
+        enableApiItem: configManager.get('enableApiItem', true),
       }
       const apiScript = generateApiPatcherScript(dataLoader.apiData, apiOptions)
       if (apiScript) {

package/src/core/resource-updater.es

@@ -9,6 +9,7 @@ import { configManager } from '../config'
 import { dataLoader } from '../loaders/data-loader'
 import { resourceManager } from './resource-manager'
 import { mainPatcher } from './main-patcher'
+import { PLUGIN_VERSION } from '../constants'
 
 const execAsync = util.promisify(exec)
 
@@ -264,7 +265,7 @@ class ResourceUpdater {
           currentUrl,
           {
             headers: {
-              'User-Agent': 'poi-plugin-kancolle-chs/1.3.0',
+              'User-Agent': `poi-plugin-kancolle-chs/${PLUGIN_VERSION}`,
               Accept: '*/*',
             },
           },
@@ -606,7 +607,7 @@ class ResourceUpdater {
           treeUrl,
           {
             headers: {
-              'User-Agent': 'poi-plugin-kancolle-chs/1.3.0',
+              'User-Agent': `poi-plugin-kancolle-chs/${PLUGIN_VERSION}`,
               Accept: 'application/vnd.github.v3+json',
             },
             timeout: 15000,

package/src/core/text-patcher.es

@@ -28,6 +28,9 @@ export function generateTextPatcherScript(textDict = {}, regexRules = [], option
   const CUSTOM_FONT_NAME = ${JSON.stringify(customFontName || 'Microsoft YaHei')};
 
   const KCT_TLS = ${JSON.stringify(activeDict)};
+  try {
+    Object.assign(window.__kanchs_dynamic_dict, KCT_TLS);
+  } catch(_) {}
   const KCT_RAW_RULES = ${JSON.stringify(activeRegex)};
   const KCT_REPLACEMENTS = [];
 

package/src/loaders/data-loader.es

@@ -15,6 +15,10 @@ class DataLoader {
       furniture: {},             // id -> { api_title, api_description }
       mapinfo: {},               // id -> { api_name, api_opetext, api_infotext }
       slotitem: {},              // id -> { api_name }
+      slotitemEquiptype: {},     // id -> { api_id, api_name }
+      stype: {},                 // id -> { api_id, api_name }
+      useitem: {},               // id -> { api_id, api_name, api_description }
+      payitem: {},               // id -> { api_id, api_name, api_description, api_shop_description }
       pictureBookShip: {},       // index_no -> { api_name, api_info, api_sinfo }
       pictureBookSlot: {},       // index_no -> { api_name, api_info }
       questlist: {},             // no -> { api_title, api_detail }
@@ -33,6 +37,10 @@ class DataLoader {
       furnitureCount: 0,
       mapCount: 0,
       questCount: 0,
+      slotitemEquiptypeCount: 0,
+      stypeCount: 0,
+      useitemCount: 0,
+      payitemCount: 0,
       pictureBookShipCount: 0,
       pictureBookSlotCount: 0,
       flavorCount: 0,
@@ -69,7 +77,7 @@ class DataLoader {
       this.stats.isLoaded = true
       this.stats.lastLoadedTime = new Date().toLocaleString()
       console.log(
-        `[KancolleCHS] 汉化数据加载成功! 文本: ${this.stats.textCount} 条, 正则: ${this.stats.regexCount} 条, 任务: ${this.stats.questCount} 条, 舰船: ${this.stats.shipCount} 条`
+        `[KancolleCHS] 汉化数据加载成功! 文本: ${this.stats.textCount} 条, 正则: ${this.stats.regexCount} 条, 任务: ${this.stats.questCount} 条, 舰船: ${this.stats.shipCount} 条, 舰种: ${this.stats.stypeCount || 0} 条, 装备分类: ${this.stats.slotitemEquiptypeCount || 0} 条, 道具: ${this.stats.useitemCount || 0} 条, 商城: ${this.stats.payitemCount || 0} 条, 进点/深海台词: ${this.stats.flavorCount} 条`
       )
       return true
     } catch (e) {
@@ -157,6 +165,10 @@ class DataLoader {
       furniture: {},
       mapinfo: {},
       slotitem: {},
+      slotitemEquiptype: {},
+      stype: {},
+      useitem: {},
+      payitem: {},
       pictureBookShip: {},
       pictureBookSlot: {},
       questlist: {},
@@ -164,10 +176,22 @@ class DataLoader {
     }
 
     const readFileSafe = async (fileName) => {
-      const p = path.join(apiDir, fileName)
-      if (!fs.existsSync(p)) return null
-      const txt = await fs.readFile(p, 'utf8')
-      return safeParseJson(txt, null)
+      const candidates = [
+        path.join(apiDir, fileName),
+        path.join(sourceDir, 'text', fileName),
+        path.join(sourceDir, 'text', 'text', fileName),
+        path.join(sourceDir, 'api', fileName),
+      ]
+      for (const p of candidates) {
+        if (fs.existsSync(p)) {
+          try {
+            const txt = await fs.readFile(p, 'utf8')
+            const parsed = safeParseJson(txt, null)
+            if (parsed) return parsed
+          } catch (_) {}
+        }
+      }
+      return null
     }
 
     // 1. 舰船与入手台词 (start2.api_mst_ship.json)
@@ -312,6 +336,73 @@ class DataLoader {
       }
     }
 
+    // 5.1 装备类型分类母表 (start2.api_mst_slotitem_equiptype.json)
+    const equiptypeList = await readFileSafe('start2.api_mst_slotitem_equiptype.json')
+    if (Array.isArray(equiptypeList)) {
+      for (const item of equiptypeList) {
+        if (item && item.api_id !== undefined) {
+          const entry = {
+            api_id: item.api_id,
+            api_name: item.api_name,
+          }
+          this.apiData.slotitemEquiptype[item.api_id] = entry
+          this.apiData.slotitemEquiptype[String(item.api_id)] = entry
+        }
+      }
+    }
+    this.stats.slotitemEquiptypeCount = Object.keys(this.apiData.slotitemEquiptype).filter((k) => !isNaN(k)).length
+
+    // 5.2 基础舰种母表 (start2.api_mst_stype.json)
+    const stypeList = await readFileSafe('start2.api_mst_stype.json')
+    if (Array.isArray(stypeList)) {
+      for (const item of stypeList) {
+        if (item && item.api_id !== undefined) {
+          const entry = {
+            api_id: item.api_id,
+            api_name: item.api_name,
+          }
+          this.apiData.stype[item.api_id] = entry
+          this.apiData.stype[String(item.api_id)] = entry
+        }
+      }
+    }
+    this.stats.stypeCount = Object.keys(this.apiData.stype).filter((k) => !isNaN(k)).length
+
+    // 5.3 消耗道具母表 (start2.api_mst_useitem.json)
+    const useitemList = await readFileSafe('start2.api_mst_useitem.json')
+    if (Array.isArray(useitemList)) {
+      for (const item of useitemList) {
+        if (item && item.api_id !== undefined) {
+          const entry = {
+            api_id: item.api_id,
+            api_name: item.api_name,
+            api_description: item.api_description,
+          }
+          this.apiData.useitem[item.api_id] = entry
+          this.apiData.useitem[String(item.api_id)] = entry
+        }
+      }
+    }
+    this.stats.useitemCount = Object.keys(this.apiData.useitem).filter((k) => !isNaN(k)).length
+
+    // 5.4 商城与点券道具母表 (start2.api_mst_payitem.json)
+    const payitemList = await readFileSafe('start2.api_mst_payitem.json')
+    if (Array.isArray(payitemList)) {
+      for (const item of payitemList) {
+        if (item && item.api_id !== undefined) {
+          const entry = {
+            api_id: item.api_id,
+            api_name: item.api_name,
+            api_description: item.api_description,
+            api_shop_description: item.api_shop_description,
+          }
+          this.apiData.payitem[item.api_id] = entry
+          this.apiData.payitem[String(item.api_id)] = entry
+        }
+      }
+    }
+    this.stats.payitemCount = Object.keys(this.apiData.payitem).filter((k) => !isNaN(k)).length
+
     // 6. 任务数据 (questlist.json)
     let questList = await readFileSafe('questlist.json')
     if (!questList) {
@@ -372,19 +463,44 @@ class DataLoader {
     this.stats.pictureBookSlotCount = Object.keys(this.apiData.pictureBookSlot).length
 
     // 9. 进点台词与海况 (battle.api_flavor_info.json)
-    const flavorList = await readFileSafe('battle.api_flavor_info.json')
+    let flavorList = await readFileSafe('battle.api_flavor_info.json')
+    if (!flavorList) {
+      const altPaths = [
+        path.join(sourceDir, 'text', 'battle.api_flavor_info.json'),
+        path.join(sourceDir, 'text', 'text', 'battle.api_flavor_info.json'),
+        path.join(sourceDir, 'api', 'battle.api_flavor_info.json'),
+      ]
+      for (const ap of altPaths) {
+        if (fs.existsSync(ap)) {
+          const txt = await fs.readFile(ap, 'utf8')
+          flavorList = safeParseJson(txt, null)
+          if (flavorList) break
+        }
+      }
+    }
     if (Array.isArray(flavorList)) {
       for (const item of flavorList) {
-        if (item && item.api_voice_id !== undefined) {
-          this.apiData.flavorInfo[item.api_voice_id] = {
-            api_message: item.api_message,
-            api_class_name: item.api_class_name,
-            api_ship_name: item.api_ship_name,
-          }
+        if (!item) continue
+        const entry = {
+          api_voice_id: item.api_voice_id,
+          api_message: item.api_message,
+          api_class_name: item.api_class_name,
+          api_ship_name: item.api_ship_name,
+          api_boss_ship_id: item.api_boss_ship_id,
+        }
+        if (item.api_voice_id !== undefined && item.api_voice_id !== null) {
+          this.apiData.flavorInfo[item.api_voice_id] = entry
+          this.apiData.flavorInfo[String(item.api_voice_id)] = entry
+        }
+        if (item.api_boss_ship_id !== undefined && item.api_boss_ship_id !== null) {
+          this.apiData.flavorInfo[`ship_${item.api_boss_ship_id}`] = entry
+        }
+        if (item.api_message_ja && item.api_message) {
+          this.textDict[item.api_message_ja] = item.api_message
         }
       }
     }
-    this.stats.flavorCount = Object.keys(this.apiData.flavorInfo).length
+    this.stats.flavorCount = Object.keys(this.apiData.flavorInfo).filter((k) => !String(k).startsWith('ship_')).length
   }
 }
 

package/src/views/MainPanel.es

@@ -91,6 +91,7 @@ export class MainPanel extends Component {
       toggleMode: 'restart', // 切换执行模式: 'restart'=清缓存并自动重启游戏, 'reload'=清缓存并刷新页面, 'none'=仅启停(不清缓存不刷新)
       showUnconfiguredAlert: false, // 启用汉化时资源包未配置提示弹窗
       showRestartConfirm: false, // 重启 POI 客户端二次确认弹窗
+      showResourceUpdateAlert: false, // 启动或检查检测到本地汉化资源有更新提醒弹窗
       logs: [],
     }
   }
@@ -120,10 +121,14 @@ export class MainPanel extends Component {
       }).catch(() => {})
     }
 
-    // 自动在后台静默检查官方汉化包变动 (轻量免 Git 校验)
-    if (this.state.config.autoCheckUpdate && !this.hasAutoCheckedUpdates) {
+    // 启动时自动检查本地汉化资源更新 (支持弹窗提醒)
+    const shouldCheckResource = this.state.config.autoCheckResourceUpdate !== undefined
+      ? this.state.config.autoCheckResourceUpdate
+      : this.state.config.autoCheckUpdate
+
+    if (shouldCheckResource && !this.hasAutoCheckedUpdates) {
       this.hasAutoCheckedUpdates = true
-      this.handleCheckIncrementalUpdates().catch(() => {})
+      this.handleCheckIncrementalUpdates({ isAutoStartup: true }).catch(() => {})
     }
 
     // 自动在后台静默检查插件本体版本更新
@@ -314,7 +319,7 @@ export class MainPanel extends Component {
 
       // 1. 重新读取数据
       await dataLoader.loadAll(sourceDir)
-      this.addLog(`汉化字典载入完成: 文本 ${dataLoader.stats.textCount} 条, 正则 ${dataLoader.stats.regexCount} 条, 任务 ${dataLoader.stats.questCount} 条`)
+      this.addLog(`汉化字典载入完成: 文本 ${dataLoader.stats.textCount} 条, 正则 ${dataLoader.stats.regexCount} 条, 任务 ${dataLoader.stats.questCount} 条, 进点/深海台词 ${dataLoader.stats.flavorCount || 0} 条`)
 
       // 2. 细分子模块挂载静态贴图与中文字体
       await resourceManager.mountResources()
@@ -691,6 +696,7 @@ export class MainPanel extends Component {
             enableApiMapInfo: Boolean(cfg.enableApiMapInfo),
             enableApiPictureBook: Boolean(cfg.enableApiPictureBook),
             enableApiFlavor: Boolean(cfg.enableApiFlavor),
+            enableApiItem: Boolean(cfg.enableApiItem !== false),
           }
           const js = `
             (function() {
@@ -815,7 +821,8 @@ export class MainPanel extends Component {
     }
 
     // 3. 若总开关处于开启状态，且修改了文本或API拦截，自动重新编译部署 main.hack.js
-    if (this.state.config.enabled && key !== 'enableFontHack' && key !== 'enableImageHack') {
+    const nonPatcherKeys = ['enableFontHack', 'enableImageHack', 'autoCheckUpdate', 'autoCheckResourceUpdate', 'downloadMirror', 'noticeAutoCloseSeconds']
+    if (this.state.config.enabled && !nonPatcherKeys.includes(key)) {
       await mainPatcher.buildAndDeploy()
       this.setState({ mainPatcherStatus: { ...mainPatcher.status } })
     }
@@ -835,6 +842,7 @@ export class MainPanel extends Component {
       enableApiMapInfo: true,
       enableApiPictureBook: true,
       enableApiFlavor: true,
+      enableApiItem: true,
       enableFontHack: true,
       enableImageHack: true,
     }
@@ -860,6 +868,7 @@ export class MainPanel extends Component {
       enableApiMapInfo: false,
       enableApiPictureBook: false,
       enableApiFlavor: false,
+      enableApiItem: false,
       enableFontHack: false,
       enableImageHack: false,
     }
@@ -885,6 +894,7 @@ export class MainPanel extends Component {
       enableApiMapInfo: true,
       enableApiPictureBook: true,
       enableApiFlavor: true,
+      enableApiItem: true,
       enableFontHack: true,
       enableImageHack: true,
     }
@@ -1266,17 +1276,22 @@ export class MainPanel extends Component {
   }
 
   /**
-   * 轻量化检查远端变动文件 (基于 Git Blob 哈希比对，免 Git 环境)
+   * 轻量化检查远端变动文件 (基于 Git Blob 哈希比对，免 Git 环境，支持启动自检与弹窗提醒)
    */
-  handleCheckIncrementalUpdates = async () => {
+  handleCheckIncrementalUpdates = async (options = {}) => {
+    const isAutoStartup = Boolean(options && options.isAutoStartup)
     const sourceDir = configManager.resolveSourcePath()
     if (!sourceDir) {
-      this.setState({ statusMessage: '尚未配置汉化资源包路径，请先指定或下载资源包', statusIntent: Intent.WARNING })
+      if (!isAutoStartup) {
+        this.setState({ statusMessage: '尚未配置汉化资源包路径，请先指定或下载资源包', statusIntent: Intent.WARNING })
+      }
       return
     }
 
-    this.setState({ isProcessing: true, statusMessage: '正在比对远端文件变动...', statusIntent: Intent.PRIMARY })
-    this.addLog('正在通过文件哈希比对 GitHub 远端变动文件...')
+    if (!isAutoStartup) {
+      this.setState({ isProcessing: true, statusMessage: '正在比对远端文件变动...', statusIntent: Intent.PRIMARY })
+    }
+    this.addLog(isAutoStartup ? '启动自检：正在通过文件哈希比对汉化资源远端更新...' : '正在通过文件哈希比对 GitHub 远端变动文件...')
 
     try {
       const res = await resourceUpdater.checkIncrementalUpdates({
@@ -1285,16 +1300,18 @@ export class MainPanel extends Component {
         onLog: (msg) => this.addLog(msg),
       })
 
-      if (res.hasUpdate) {
+      if (res.hasUpdate && res.changedFiles && res.changedFiles.length > 0) {
         this.setState({
           resourceUpdaterStatus: {
             ...this.state.resourceUpdaterStatus,
             hasIncrementalUpdate: true,
             changedFiles: res.changedFiles,
           },
-          statusMessage: `发现 ${res.changedFiles.length} 个文件有变动！可点击【轻量更新】自动下载替换`,
-          statusIntent: Intent.WARNING,
+          showResourceUpdateAlert: false,
+          statusMessage: `检测到 ${res.changedFiles.length} 个文件与远端有差异`,
+          statusIntent: Intent.NONE,
         })
+        this.addLog(`检测到 ${res.changedFiles.length} 个汉化资源文件与远端有差异（已记录，不弹窗打扰）`)
       } else {
         this.setState({
           resourceUpdaterStatus: {
@@ -1302,18 +1319,25 @@ export class MainPanel extends Component {
             hasIncrementalUpdate: false,
             changedFiles: [],
           },
-          statusMessage: '当前所有汉化文件均为最新，无变动！',
-          statusIntent: Intent.SUCCESS,
+          statusMessage: isAutoStartup ? '' : '当前所有汉化文件均为最新，无变动！',
+          statusIntent: isAutoStartup ? Intent.NONE : Intent.SUCCESS,
         })
+        if (isAutoStartup) {
+          this.addLog('启动自检完成：本地汉化资源已是最新版本，无变动文件')
+        }
       }
     } catch (e) {
-      this.setState({
-        statusMessage: `检查变动失败: ${e.message}`,
-        statusIntent: Intent.DANGER,
-      })
-      this.addLog(`检查变动失败: ${e.message}`)
+      if (!isAutoStartup) {
+        this.setState({
+          statusMessage: `检查变动失败: ${e.message}`,
+          statusIntent: Intent.DANGER,
+        })
+      }
+      this.addLog(`检查汉化资源变动失败: ${e.message}`)
     } finally {
-      this.setState({ isProcessing: false })
+      if (!isAutoStartup) {
+        this.setState({ isProcessing: false })
+      }
     }
   }
 
@@ -1676,6 +1700,7 @@ export class MainPanel extends Component {
       selectedMirror,
       showTimeoutAlert,
       showRestartConfirm,
+      showResourceUpdateAlert,
       logs,
     } = this.state
 
@@ -2360,13 +2385,17 @@ export class MainPanel extends Component {
                     marginTop: '8px',
                   }}
                 >
-                  {resourceUpdaterStatus.changedFiles.map((file, idx) => (
-                    <div key={idx} style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '2px 0' }}>
-                      <span style={{ color: '#3dcc68', fontWeight: 'bold', minWidth: '40px' }}>[变动]</span>
-                      <span style={{ color: '#888', minWidth: '56px' }}>[{file.category || '文件'}]</span>
-                      <span style={{ color: '#eee', wordBreak: 'break-all' }}>{file.path}</span>
-                    </div>
-                  ))}
+                  {resourceUpdaterStatus.changedFiles.map((file, idx) => {
+                    const filePath = typeof file === 'object' && file ? (file.path || '') : String(file || '');
+                    const fileCategory = typeof file === 'object' && file && file.category ? file.category : '文件';
+                    return (
+                      <div key={idx} style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '2px 0' }}>
+                        <span style={{ color: '#3dcc68', fontWeight: 'bold', minWidth: '40px' }}>[变动]</span>
+                        <span style={{ color: '#888', minWidth: '56px' }}>[{fileCategory}]</span>
+                        <span style={{ color: '#eee', wordBreak: 'break-all' }}>{filePath}</span>
+                      </div>
+                    );
+                  })}
                 </div>
               </div>
             )}
@@ -2398,9 +2427,9 @@ export class MainPanel extends Component {
 
               <div style={{ marginTop: '8px' }}>
                 <Switch
-                  label="启动 POI 时自动在后台静默检查官方汉化包更新"
-                  checked={config.autoCheckUpdate}
-                  onChange={() => this.handleToggleOption('autoCheckUpdate')}
+                  label="启动 POI 时自动检查本地汉化资源更新并在面板提示"
+                  checked={config.autoCheckResourceUpdate !== undefined ? config.autoCheckResourceUpdate : config.autoCheckUpdate}
+                  onChange={() => this.handleToggleOption('autoCheckResourceUpdate')}
                 />
               </div>
             </div>
@@ -2417,8 +2446,8 @@ export class MainPanel extends Component {
                   <Tag intent={config.enableTextDict || config.enableTextRegex ? Intent.SUCCESS : Intent.NONE} minimal round small>
                     文字: {config.enableTextDict || config.enableTextRegex ? '开' : '关'}
                   </Tag>
-                  <Tag intent={config.enableApiQuest || config.enableApiShip || config.enableApiMission || config.enableApiFurniture || config.enableApiMapInfo || config.enableApiPictureBook || config.enableApiFlavor ? Intent.SUCCESS : Intent.NONE} minimal round small>
-                    数据: {config.enableApiQuest || config.enableApiShip || config.enableApiMission || config.enableApiFurniture || config.enableApiMapInfo || config.enableApiPictureBook || config.enableApiFlavor ? '开' : '关'}
+                  <Tag intent={config.enableApiQuest || config.enableApiShip || config.enableApiMission || config.enableApiFurniture || config.enableApiMapInfo || config.enableApiPictureBook || config.enableApiFlavor || config.enableApiItem ? Intent.SUCCESS : Intent.NONE} minimal round small>
+                    数据: {config.enableApiQuest || config.enableApiShip || config.enableApiMission || config.enableApiFurniture || config.enableApiMapInfo || config.enableApiPictureBook || config.enableApiFlavor || config.enableApiItem ? '开' : '关'}
                   </Tag>
                   <Tag intent={config.enableImageHack || config.enableFontHack || config.enableCustomFont ? Intent.SUCCESS : Intent.NONE} minimal round small>
                     静态与字体: {config.enableImageHack || config.enableFontHack || config.enableCustomFont ? '开' : '关'}
@@ -2479,7 +2508,7 @@ export class MainPanel extends Component {
                   onChange={() => this.handleToggleOption('enableApiQuest')}
                 />
                 <Switch
-                  label="舰娘名称与入手台词、装备"
+                  label="舰娘/舰种/装备与分类汉化"
                   checked={config.enableApiShip}
                   onChange={() => this.handleToggleOption('enableApiShip')}
                 />
@@ -2508,6 +2537,11 @@ export class MainPanel extends Component {
                   checked={config.enableApiFlavor}
                   onChange={() => this.handleToggleOption('enableApiFlavor')}
                 />
+                <Switch
+                  label="消耗品与道具商城汉化"
+                  checked={config.enableApiItem}
+                  onChange={() => this.handleToggleOption('enableApiItem')}
+                />
               </div>
             </div>