poi-plugin-kancolle-chs 1.1.0

package/index.es

@@ -0,0 +1,60 @@
+import { MainPanel } from './src/views/MainPanel'
+import { configManager } from './src/config'
+import { dataLoader } from './src/loaders/data-loader'
+import { mainPatcher } from './src/core/main-patcher'
+import { resourceManager } from './src/core/resource-manager'
+
+// 导出插件在 POI 中展示的界面组件
+export const reactClass = MainPanel
+
+// 是否在 POI 标签栏显示控制台
+export const show = true
+
+// 窗口模式（false 为嵌入在 POI 主窗口 Tab 中）
+export const windowMode = false
+
+// 插件被启用时的生命周期钩子
+export const pluginDidLoad = async () => {
+  console.log('[砍口垒汉化计划] POI 插件启动中...')
+
+  try {
+    // 检查总开关
+    if (configManager.get('enabled', true)) {
+      // 1. 全量预加载汉化字典与正则
+      await dataLoader.loadAll()
+
+      // 2. 挂载静态贴图与中文字体 (.hack 细分控制)
+      await resourceManager.mountResources()
+
+      // 3. 自动编译并部署 main.hack.js 补丁
+      if (configManager.get('autoDeployOnStart', true)) {
+        await mainPatcher.buildAndDeploy()
+      }
+
+      // 4. 若开启了启动自动检查更新，后台静默检查
+      if (configManager.get('autoCheckUpdate', true)) {
+        import('./src/core/git-manager').then(({ gitManager }) => {
+          gitManager.checkForUpdates().catch(() => {})
+        }).catch(() => {})
+      }
+
+      console.log('[砍口垒汉化计划PLUS] 插件加载完毕，原生汉化模式已生效！')
+    } else {
+      console.log('[砍口垒汉化计划PLUS] 插件当前处于停用状态')
+    }
+  } catch (e) {
+    console.error('[砍口垒汉化计划PLUS] 插件启动阶段出现异常:', e)
+  }
+}
+
+// 插件被禁用或卸载时的生命周期钩子
+export const pluginWillUnload = async () => {
+  console.log('[砍口垒汉化计划] 插件卸载中，正在清理魔改补丁与挂载点...')
+  try {
+    await mainPatcher.undeploy()
+    await resourceManager.unmountResources()
+    console.log('[砍口垒汉化计划] 插件已安全卸载，原生环境已复原')
+  } catch (e) {
+    console.warn('[砍口垒汉化计划] 清理魔改挂载点时出错:', e)
+  }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "poi-plugin-kancolle-chs",
+  "version": "1.1.0",
+  "description": "砍口垒汉化计划PLUS POI 原生独立插件：提供全界面文本替换、正则动态替换、KCSAPI 响应合流、中文字体与贴图魔改、自定义字体适配与官方资源更新",
+  "main": "index.es",
+  "files": [
+    "index.es",
+    "src/"
+  ],
+  "author": "泉浅漪",
+  "license": "MIT",
+  "keywords": [
+    "poi",
+    "kancolle",
+    "poi-plugin",
+    "kancolle-chs",
+    "localization",
+    "translation"
+  ],
+  "poiPlugin": {
+    "name": "砍口垒汉化PLUS",
+    "title": "砍口垒汉化计划PLUS",
+    "description": "原生集成《砍口垒汉化计划PLUS》，支持全界面文本翻译、任务/家具/海图/图鉴汉化、自定义字体优先适配、中文字体魔改与官方资源自动更新",
+    "icon": "fa/language",
+    "priority": 20
+  }
+}

package/src/config.es

@@ -0,0 +1,143 @@
+import path from 'path'
+import fs from 'fs-extra'
+import { DEFAULT_CONFIG, RECOMMENDED_SOURCE_PATHS } from './constants'
+
+class ConfigManager {
+  constructor() {
+    this.pluginDir = path.resolve(__dirname, '..')
+    this.configFile = path.join(this.pluginDir, 'config.json')
+    this.config = { ...DEFAULT_CONFIG }
+    this.listeners = new Set()
+    this.loadConfig()
+  }
+
+  loadConfig() {
+    try {
+      if (fs.existsSync(this.configFile)) {
+        const saved = fs.readJsonSync(this.configFile)
+        this.config = { ...DEFAULT_CONFIG, ...saved }
+      } else {
+        // 若首次启动且无配置，尝试查找推荐路径初始化
+        for (const candidate of RECOMMENDED_SOURCE_PATHS) {
+          if (fs.existsSync(candidate)) {
+            this.config.sourcePath = candidate
+            break
+          }
+        }
+        this.saveConfig()
+      }
+    } catch (e) {
+      console.error('[KancolleCHS] 加载配置文件失败:', e)
+    }
+  }
+
+  saveConfig() {
+    try {
+      fs.writeJsonSync(this.configFile, this.config, { spaces: 2 })
+    } catch (e) {
+      console.error('[KancolleCHS] 保存配置文件失败:', e)
+    }
+  }
+
+  update(newConfig) {
+    this.config = { ...this.config, ...newConfig }
+    this.saveConfig()
+    this.notify()
+  }
+
+  get(key, defaultValue = undefined) {
+    return this.config[key] !== undefined ? this.config[key] : defaultValue
+  }
+
+  set(key, value) {
+    this.config[key] = value
+    this.saveConfig()
+    this.notify()
+  }
+
+  subscribe(listener) {
+    this.listeners.add(listener)
+    return () => this.listeners.delete(listener)
+  }
+
+  notify() {
+    for (const fn of this.listeners) {
+      try {
+        fn(this.config)
+      } catch (e) {
+        console.error('[KancolleCHS] 配置更新通知失败:', e)
+      }
+    }
+  }
+
+  /**
+   * 检验指定路径是否为合法的 Kancolle_to_CHS 汉化资产目录
+   */
+  validatePath(dirPath) {
+    if (!dirPath || typeof dirPath !== 'string' || dirPath.trim() === '') {
+      return {
+        valid: false,
+        error: '路径不能为空',
+        details: {},
+      }
+    }
+
+    const resolved = path.resolve(dirPath.trim())
+    if (!fs.existsSync(resolved)) {
+      return {
+        valid: false,
+        error: '指定文件夹不存在',
+        details: {},
+      }
+    }
+
+    const details = {
+      textDict: fs.existsSync(path.join(resolved, 'text', 'text')),
+      textRegex: fs.existsSync(path.join(resolved, 'text', 'text_regex')),
+      textApi: fs.existsSync(path.join(resolved, 'text', 'api')),
+      images: fs.existsSync(path.join(resolved, 'cache', 'kcs2', 'img')),
+      fonts: fs.existsSync(path.join(resolved, 'cache', 'kcs2', 'resources', 'font')),
+    }
+
+    const missing = []
+    if (!details.textDict) missing.push('text/text (界面词条)')
+    if (!details.textRegex) missing.push('text/text_regex (正则规则)')
+    if (!details.textApi) missing.push('text/api (API补丁)')
+    if (!details.images) missing.push('cache/kcs2/img (贴图魔改)')
+    if (!details.fonts) missing.push('cache/kcs2/resources/font (中文字体)')
+
+    // 只要具备任一核心要素即视为主目录有效，但提供明细
+    const valid = details.textDict || details.textApi || details.images
+
+    return {
+      valid,
+      path: resolved,
+      details,
+      missing,
+      error: valid ? null : `未在目录下找到有效的汉化包文件: 缺少 ${missing.join(', ')}`,
+    }
+  }
+
+  /**
+   * 解析当前设定的汉化源目录 (以用户手动选择为绝对最高优先级)
+   */
+  resolveSourcePath() {
+    if (this.config.sourcePath && this.config.sourcePath.trim() !== '') {
+      const p = this.config.sourcePath.trim()
+      if (fs.existsSync(p)) {
+        return path.resolve(p)
+      }
+    }
+
+    // 次级备选：检查推荐目录
+    for (const candidate of RECOMMENDED_SOURCE_PATHS) {
+      if (fs.existsSync(candidate)) {
+        return path.resolve(candidate)
+      }
+    }
+
+    return null
+  }
+}
+
+export const configManager = new ConfigManager()

package/src/constants.es

@@ -0,0 +1,83 @@
+import path from 'path'
+export * from './ja-maps'
+
+export const API_PATHS = {
+  START2: '/kcsapi/api_start2/getData',
+  PICTURE_BOOK: '/kcsapi/api_get_member/picture_book',
+  QUESTLIST: '/kcsapi/api_get_member/questlist',
+  MAP_NEXT: '/kcsapi/api_req_map/next',
+  MAP_START: '/kcsapi/api_req_map/start',
+}
+
+// 官方汉化仓库与发布页地址
+export const OFFICIAL_REPO_URL = 'https://github.com/asaico/Kancolle_to_CHS'
+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'
+
+// 常用推荐系统字体预设
+export const PRESET_FONTS = [
+  { label: '微软雅黑 (Microsoft YaHei)', value: 'Microsoft YaHei' },
+  { label: '思源黑体 (Source Han Sans SC)', value: 'Source Han Sans SC' },
+  { label: '苹方 / 苹方简体 (PingFang SC)', value: 'PingFang SC' },
+  { label: '霞鹜文楷 (LXGW WenKai)', value: 'LXGW WenKai' },
+  { label: '更纱黑体 (Sarasa Gothic SC)', value: 'Sarasa Gothic SC' },
+  { label: '鸿蒙字体 (HarmonyOS Sans SC)', value: 'HarmonyOS Sans SC' },
+  { label: '汉仪旗黑 (HYQiHei)', value: 'HYQiHei' },
+  { label: '黑体 (SimHei)', value: 'SimHei' },
+]
+
+// 推荐备选路径（仅在用户未配置时智能查找标准目录，不包含任何私人硬编码）
+export const RECOMMENDED_SOURCE_PATHS = [
+  path.join(process.env.APPDATA || '', 'poi', 'kancolle-chs-resources'),
+  path.join(process.env.USERPROFILE || '', 'Downloads', 'Kancolle_to_CHS'),
+  path.resolve(__dirname, '..', '..', 'Kancolle_to_CHS'),
+  path.resolve(__dirname, '..', 'resources'),
+]
+
+export const DEFAULT_CONFIG = {
+  // 插件全局总开关
+  enabled: true,
+
+  // 用户手动指定的汉化包根目录（包含 text 与 cache 文件夹）
+  sourcePath: '',
+
+  // --- 1. 界面文字翻译开关 ---
+  enableTextDict: true,           // 界面精确词条匹配 (text/text/*.json)
+  enableTextRegex: true,          // 界面动态正则替换 (text/text_regex/*.json)
+
+  // --- 2. KCSAPI 响应合流细分开关 ---
+  enableApiQuest: true,           // 任务系统汉化 (questlist.json)
+  enableApiShip: true,            // 舰船名称与初始形态入手台词 (start2.api_mst_ship.json)
+  enableApiMission: true,         // 远征任务名称与详细说明 (start2.api_mst_mission.json)
+  enableApiFurniture: true,       // 家具名称与背景描述 (start2.api_mst_furniture.json)
+  enableApiMapInfo: true,         // 出击海区与作战行动说明 (start2.api_mst_mapinfo.json)
+  enableApiPictureBook: true,     // 舰船与装备图鉴介绍 (picture_book.ship / slotitem)
+  enableApiFlavor: true,          // 海域进点气象与深海台词 (battle.api_flavor_info.json)
+
+  // --- 3. 静态魔改资产细分开关 ---
+  enableFontHack: true,           // 优美中文字体魔改 (A-OTF-UDShinGoPro*.hack.woff2)
+  enableImageHack: true,          // 界面贴图与图标魔改 (.hack.png / .hack.jpg)
+
+  // --- 4. 自定义字体优先适配 ---
+  enableCustomFont: false,        // 是否启用用户自定义字体优先适配
+  customFontSource: 'system',     // 'system' (系统字体名) 或 'file' (本地字体文件)
+  customFontName: 'Microsoft YaHei', // 系统字体名称
+  customFontPath: '',             // 本地字体文件绝对路径 (.woff2 / .ttf / .otf)
+
+  // --- 5. 官方资源与更新管理 ---
+  autoCheckUpdate: true,          // 插件启动时是否在后台自动检查更新
+
+  // --- 6. 游戏运行帧率上限调节 ---
+  fpsLimit: 60,                   // 游戏帧率上限 (默认 60，可选 60, 120, 165, 240)
+
+  // 运行配置
+  autoDeployOnStart: true,        // 插件启动时自动编译部署补丁
+}
+
+// 常用帧率预设
+export const PRESET_FPS = [
+  { label: '60 FPS', value: 60, tag: '原版默认', desc: '原版默认上限，省电稳定' },
+  { label: '120 FPS', value: 120, tag: '双倍流畅', desc: '两倍丝滑，适合高刷显示器' },
+  { label: '165 FPS', value: 165, tag: '电竞高刷', desc: '电竞级刷新率，极速响应' },
+  { label: '240 FPS', value: 240, tag: '极致满血', desc: '满血超高刷，极致流畅动效' },
+]