poi-plugin-kancolle-chs 1.2.1 → 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.2.1",
+  "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.2.1'
+let pkgVersion = '1.3.8'
 try {
   const pkg = require('../package.json')
   if (pkg && pkg.version) pkgVersion = pkg.version
@@ -70,9 +70,10 @@ 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,           // 优美中文字体魔改 (A-OTF-UDShinGoPro*.hack.woff2)
+  enableFontHack: true,           // 默认中文字体替换(思源黑体)
   enableImageHack: true,          // 界面贴图与图标魔改 (.hack.png / .hack.jpg)
 
   // --- 4. 自定义字体优先适配 ---
@@ -82,14 +83,17 @@ export const DEFAULT_CONFIG = {
   customFontPath: '',             // 本地字体文件绝对路径 (.woff2 / .ttf / .otf)
 
   // --- 5. 官方资源与更新管理 ---
-  autoCheckUpdate: true,          // 插件启动时是否在后台自动检查更新
+  autoCheckUpdate: true,                  // 插件启动时是否在后台自动检查更新
+  autoCheckResourceUpdate: true,          // 启动 POI 时自动检查本地汉化资源更新并在面板提示
+  downloadMirror: 'direct',               // 资源下载加速镜像，默认 'direct' (GitHub 官方直连)
 
   // --- 6. 游戏运行帧率上限调节 ---
   fpsLimit: 60,                   // 游戏帧率上限 (默认 60，可选 60, 120, 165, 240)
 
-  // --- 7. 界面自适应与布局排版模式 ---
+  // --- 7. 综合设置与界面布局模式 ---
   layoutDensity: 'auto',          // 'auto'(自适应), 'compact'(紧凑模式), 'spacious'(宽屏模式)
   panelMaxWidth: '100%',          // 面板最大宽度: '100%', '880px', '1080px'
+  noticeAutoCloseSeconds: 20,     // 提示与通知默认自动向上折叠关闭时间 (秒，0 为不自动关闭)
 
   // --- 8. 其他魔改功能 (独立路径优先加载第三方魔改资源) ---
   enableCustomHack: false,        // 是否启用其他第三方魔改功能
@@ -116,7 +120,18 @@ export const PRESET_LAYOUT_DENSITY = [
 
 // 界面最大宽度预设
 export const PRESET_MAX_WIDTH = [
-  { label: '100% 铺满', value: '100%' },
+  { label: '500px 窄屏', value: '500px' },
   { label: '880px 适中', value: '880px' },
-  { label: '1080px 宽屏', value: '1080px' },
+  { label: '1200px 宽屏', value: '1200px' },
+  { label: '1600px 超宽', value: '1600px' },
+  { label: '100% 铺满', value: '100%' },
+]
+
+// 提示自动折叠关闭时间预设
+export const PRESET_NOTICE_AUTOCLOSE = [
+  { label: '5秒 极速', value: 5 },
+  { label: '10秒 适中', value: 10 },
+  { label: '20秒 默认', value: 20 },
+  { label: '30秒 宽裕', value: 30 },
+  { label: '从不自动折叠', value: 0 },
 ]

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-manager.es

@@ -16,10 +16,61 @@ class ResourceManager {
   }
 
   /**
-   * 获取系统中所有可能存在的 POI 缓存目录路径 (包括用户自定义缓存路径、默认 MyCache 与 Downloads 等)
+   * 判断指定路径是否位于用户系统的 Downloads (下载) 目录中
+   */
+  isDownloadsPath(targetPath) {
+    if (!targetPath || typeof targetPath !== 'string') return false
+    try {
+      const home = process.env.HOME || process.env.USERPROFILE || ''
+      if (!home) return false
+      const downloads = path.resolve(path.join(home, 'Downloads')).toLowerCase()
+      const resolved = path.resolve(targetPath.trim()).toLowerCase()
+      return resolved === downloads || resolved.startsWith(downloads + path.sep)
+    } catch (_) {
+      return false
+    }
+  }
+
+  /**
+   * 自动清理可能错误创建在 Downloads 目录下的 KanColle 临时挂载点
+   */
+  cleanSpuriousDownloadsKanColle() {
+    try {
+      const home = process.env.HOME || process.env.USERPROFILE || ''
+      if (!home) return
+      const dlKc = path.join(home, 'Downloads', 'KanColle')
+      if (fs.existsSync(dlKc)) {
+        const cleanRec = (dir) => {
+          if (!fs.existsSync(dir)) return
+          const items = fs.readdirSync(dir)
+          for (const item of items) {
+            const full = path.join(dir, item)
+            try {
+              const st = fs.lstatSync(full)
+              if (st.isSymbolicLink()) {
+                fs.unlinkSync(full)
+              } else if (st.isDirectory()) {
+                cleanRec(full)
+                fs.rmdirSync(full)
+              } else {
+                fs.unlinkSync(full)
+              }
+            } catch (_) {}
+          }
+        }
+        cleanRec(dlKc)
+        if (fs.existsSync(dlKc)) fs.rmdirSync(dlKc)
+        console.log('[KancolleCHS] 已安全清理 Downloads 目录下的 KanColle 临时挂载点')
+      }
+    } catch (_e) {}
+  }
+
+  /**
+   * 获取系统中所有可能存在的 POI 缓存目录路径 (包括用户自定义缓存路径、默认 MyCache 等，严格排除 Downloads)
    */
   getAllPoiCacheDirs() {
     const dirs = new Set()
+    this.cleanSpuriousDownloadsKanColle()
 
     // 1. 若运行于 POI 渲染进程，优先从 POI 配置读取
     try {
@@ -35,7 +86,9 @@ class ResourceManager {
           } catch (_) {}
         }
         if (p && typeof p === 'string' && p.trim() && p !== 'null' && p !== 'undefined' && fs.existsSync(p)) {
-          dirs.add(path.resolve(p))
+          if (!this.isDownloadsPath(p)) {
+            dirs.add(path.resolve(p))
+          }
         }
 
         // 检查 POI 全局默认缓存路径 (POI 源码: global.DEFAULT_CACHE_PATH)
@@ -43,7 +96,9 @@ class ResourceManager {
           try {
             const defaultCacheGlobal = window.remote.getGlobal('DEFAULT_CACHE_PATH')
             if (defaultCacheGlobal && typeof defaultCacheGlobal === 'string' && fs.existsSync(defaultCacheGlobal)) {
-              dirs.add(path.resolve(defaultCacheGlobal))
+              if (!this.isDownloadsPath(defaultCacheGlobal)) {
+                dirs.add(path.resolve(defaultCacheGlobal))
+              }
             }
           } catch (_) {}
           try {
@@ -75,7 +130,9 @@ class ResourceManager {
                 let cleaned = line.replace(/^\s*path:\s*/, '').trim()
                 cleaned = cleaned.replace(/^['"]|['"]$/g, '').replace(/\\\\/g, '\\').trim()
                 if (cleaned && cleaned !== 'null' && cleaned !== 'undefined' && fs.existsSync(cleaned)) {
-                  dirs.add(path.resolve(cleaned))
+                  if (!this.isDownloadsPath(cleaned)) {
+                    dirs.add(path.resolve(cleaned))
+                  }
                 }
                 break
               } else if (!line.startsWith(' ') && !line.startsWith('\t')) {
@@ -91,7 +148,10 @@ class ResourceManager {
       if (fs.existsSync(cacheDir)) dirs.add(path.resolve(cacheDir))
     }
 
-    const list = Array.from(dirs).filter((d) => typeof d === 'string' && d.trim() && d !== 'null' && d !== 'undefined')
+    const list = Array.from(dirs)
+      .filter((d) => typeof d === 'string' && d.trim() && d !== 'null' && d !== 'undefined')
+      .filter((d) => !this.isDownloadsPath(d))
+
     if (list.length === 0) {
       if (userDataDir) {
         list.push(path.resolve(path.join(userDataDir, 'MyCache')))
@@ -105,6 +165,12 @@ class ResourceManager {
   }
 
   getPoiCacheDir() {
+    this.cleanSpuriousDownloadsKanColle()
+    const userDataDir = getPoiUserDataDir()
+    const defaultSafePath = userDataDir
+      ? path.resolve(path.join(userDataDir, 'MyCache'))
+      : path.resolve(path.join(process.env.USERPROFILE || process.env.HOME || '.', '.poi', 'MyCache'))
+
     try {
       if (typeof window !== 'undefined') {
         let val = null
@@ -118,6 +184,15 @@ class ResourceManager {
           } catch (_) {}
         }
         if (val && typeof val === 'string' && val.trim() && val !== 'null' && val !== 'undefined') {
+          if (this.isDownloadsPath(val)) {
+            console.warn('[KancolleCHS] 检测到 POI 缓存路径指向 Downloads，强制重置为 MyCache 以保护下载目录')
+            try {
+              if (window.config && typeof window.config.set === 'function') {
+                window.config.set('poi.misc.cache.path', defaultSafePath)
+              }
+            } catch (_) {}
+            return defaultSafePath
+          }
           return path.resolve(val)
         }
 
@@ -125,7 +200,9 @@ class ResourceManager {
           try {
             const defaultCacheGlobal = window.remote.getGlobal('DEFAULT_CACHE_PATH')
             if (defaultCacheGlobal && typeof defaultCacheGlobal === 'string' && defaultCacheGlobal.trim()) {
-              return path.resolve(defaultCacheGlobal)
+              if (!this.isDownloadsPath(defaultCacheGlobal)) {
+                return path.resolve(defaultCacheGlobal)
+              }
             }
           } catch (_) {}
           try {
@@ -139,19 +216,13 @@ class ResourceManager {
     } catch (_e) {}
 
     const allDirs = this.getAllPoiCacheDirs()
-    if (allDirs.length > 0 && typeof allDirs[0] === 'string' && allDirs[0].trim()) {
-      return path.resolve(allDirs[0])
+    for (const d of allDirs) {
+      if (d && typeof d === 'string' && d.trim() && !this.isDownloadsPath(d)) {
+        return path.resolve(d)
+      }
     }
 
-    const userDataDir = getPoiUserDataDir()
-    if (userDataDir) {
-      return path.resolve(path.join(userDataDir, 'MyCache'))
-    }
-    const home = process.env.HOME || process.env.USERPROFILE || ''
-    if (home) {
-      return path.resolve(path.join(home, '.poi', 'MyCache'))
-    }
-    return path.resolve('.')
+    return defaultSafePath
   }
 
   /**