poi-plugin-compass 0.1.0 → 0.1.1

package/docs/sources.md

@@ -31,9 +31,9 @@ data/kcnav-node-types-by-map.json
 
 ### 敌编成日期筛选（2026-09-11）
 
-核对 `https://tsunkit.net/nav/scripts/routing.js`：`startDate`/`endDate` 分别使用参数 `start`/`end`，格式为 `YYYY-MM-DD`；`enemies` 面板将同一组筛选参数传给节点的 `enemycomps` 接口。本插件固定本轮起止日期，仅发送这两个参数，不发送司令部等级、血条、phase、舰队或路线限制。最近一个月采用当天 UTC 日期向前一个日历月（月末截到上月末日）。
+核对 `https://tsunkit.net/nav/scripts/routing.js`：`startDate`/`endDate` 分别使用参数 `start`/`end`，格式为 `YYYY-MM-DD`；`enemies` 面板将同一组筛选参数传给节点的 `enemycomps` 接口。本插件固定本轮起止日期，仅发送这两个参数，不发送司令部等级、血条、phase、舰队或路线限制。通常节点采用当天 UTC 日期向前一个日历月（月末截到上月末日）；月度样本总数小于 100 的战斗节点另使用前一年同日到当天的窗口，并按节点保存实际使用的日期窗口。
 
-`https://tsunkit.net/lang/en/kcnav.json` 的 `panelEnemiesAirPowerHeader` 顺序为 `termAirAD / termAirAP / termAirAS / termAirASPlus`；与前端 `airpower[0..3]` 对应，分别为劣势、均势、优势、确保。`lbasAirpower` 使用相同顺序但单独显示。原始响应按日期窗口/海图/节点保存，manifest 记录请求 URL、SHA-256、每节点抓取时间和完成状态。遇到请求失败即停止，保留进度供重跑；运行时只读取本地缓存。
+`https://tsunkit.net/lang/en/kcnav.json` 的 `panelEnemiesAirPowerHeader` 顺序为 `termAirAD / termAirAP / termAirAS / termAirASPlus`；与前端 `airpower[0..3]` 对应，分别为劣势、均势、优势、确保。`lbasAirpower` 使用相同顺序但单独显示。原始响应按日期窗口/海图/节点保存，manifest 记录请求 URL、SHA-256、每节点抓取时间和完成状态。遇到请求失败即停止，保留进度供重跑；运行时只读取本地缓存。低样本节点的一年窗口补采由 `npm run cache:kcnav-enemies:long-low` 执行，默认间隔 15 秒。
 
 每个 API entry 原样保留舰船顺序、装备、阵型及编成 masterId；舰船实体用 `mainFleet[].id` / `escortFleet[].id`。界面按 `count` 降序显示，以本节点返回记录的 count 总和计算样本占比。零样本不生成百分比；四档制空缺失时显示未知；任何编成缺制空时，节点整体范围也显示未知。混合阶段和司令部等级的占比仅描述当前抓取样本。
 

package/enemies.js

@@ -44,7 +44,7 @@ function loadEnemies(mapId, node) {
     const source = manifest.nodes[`${mapId}/${node}`]
     if (!source) return { status: 'missing', window: manifest.window }
     const payload = readLocalJson(path.join(cacheRoot, source.file))
-    return { status: 'ready', window: manifest.window, source, ...summarizeEntries(payload.result.entries) }
+    return { status: 'ready', window: source.window || manifest.window, source, ...summarizeEntries(payload.result.entries) }
   } catch (error) {
     return { status: error.code === 'ENOENT' ? 'missing' : 'invalid' }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-compass",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "通常海域舰队罗盘",
   "main": "index.js",
   "repository": {
@@ -28,9 +28,10 @@
     "cache:kcwiki": "node scripts/cache-kcwiki-routes.js",
     "cache:kcnav-maps": "node scripts/cache-kcnav-maps.js",
     "cache:kcnav-enemies": "node scripts/cache-kcnav-enemies.js",
+    "cache:kcnav-enemies:long-low": "node scripts/cache-kcnav-enemies-long-low.js",
     "compress:kcnav-maps": "node scripts/compress-kcnav-maps.js --remove-png",
     "compress:kcnav-enemies": "node scripts/compact-kcnav-enemies.js",
-    "check:syntax": "node --check index.js && node --check logic.js && node --check enemies.js && node --check exporters.js && node --check scripts/cache-kcnav-enemies.js && node --check scripts/compress-kcnav-maps.js && node --check scripts/compact-kcnav-enemies.js && node --check test.js && node --check test-enemies.js && node --check test-exporters.js",
+    "check:syntax": "node --check index.js && node --check logic.js && node --check enemies.js && node --check exporters.js && node --check scripts/cache-kcnav-enemies.js && node --check scripts/cache-kcnav-enemies-long-low.js && node --check scripts/compress-kcnav-maps.js && node --check scripts/compact-kcnav-enemies.js && node --check test.js && node --check test-enemies.js && node --check test-exporters.js",
     "test": "node test.js && node test-enemies.js && node test-exporters.js && node test-ui.js && node test-overview.js"
   },
   "keywords": [
@@ -51,7 +52,7 @@
     "icon": "fa/compass",
     "priority": 20,
     "apiVer": {
-      "11.99.99": "0.1.0"
+      "11.99.99": "0.1.1"
     }
   },
   "peerDependencies": {

package/scripts/cache-kcnav-enemies-long-low.js

@@ -0,0 +1,115 @@
+'use strict'
+
+const crypto = require('crypto')
+const fs = require('fs')
+const path = require('path')
+const nodeTypes = require('../data/kcnav-node-types-by-map.json')
+const styles = require('../data/kcnav-node-types.json')
+const { enemyUrl, validateResponse } = require('./cache-kcnav-enemies')
+
+const root = path.join(__dirname, '../data/sources/kcnav/enemies')
+const manifestPath = path.join(root, 'manifest.json')
+const LOW_SAMPLE_THRESHOLD = 100
+const INTERVAL_MS = 15000
+
+function oneYearWindow(now = new Date()) {
+  const end = now.toISOString().slice(0, 10)
+  const startDate = new Date(`${end}T00:00:00Z`)
+  startDate.setUTCFullYear(startDate.getUTCFullYear() - 1)
+  return { start: startDate.toISOString().slice(0, 10), end }
+}
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, 'utf8'))
+}
+
+function sampleCount(payload) {
+  return (payload?.result?.entries || []).reduce((sum, entry) => sum + entry.count, 0)
+}
+
+function writeJson(file, value, compact = false) {
+  const content = `${JSON.stringify(value, null, compact ? 0 : 2)}\n`
+  fs.mkdirSync(path.dirname(file), { recursive: true })
+  fs.writeFileSync(`${file}.tmp`, content)
+  fs.renameSync(`${file}.tmp`, file)
+  return crypto.createHash('sha256').update(content).digest('hex')
+}
+
+function combatTargets() {
+  return Object.entries(nodeTypes).sort(([a], [b]) => a.localeCompare(b, undefined, { numeric: true }))
+    .flatMap(([mapId, nodes]) => Object.entries(nodes)
+      .filter(([, type]) => styles[type]?.hasEnemies)
+      .map(([node]) => ({ mapId, node })))
+}
+
+function currentSamples(manifest, target) {
+  const source = manifest.nodes[`${target.mapId}/${target.node}`]
+  if (!source) return 0
+  try {
+    return sampleCount(readJson(path.join(root, source.file)))
+  } catch (error) {
+    return 0
+  }
+}
+
+async function main() {
+  const manifest = readJson(manifestPath)
+  const window = oneYearWindow()
+  const targets = combatTargets().filter((target) => currentSamples(manifest, target) < LOW_SAMPLE_THRESHOLD)
+  const previousRun = manifest.longWindow
+  manifest.longWindow = {
+    start: window.start,
+    end: window.end,
+    threshold: LOW_SAMPLE_THRESHOLD,
+    intervalMs: INTERVAL_MS,
+    targetCount: targets.length,
+    complete: false,
+    lastRequestAt: previousRun?.start === window.start && previousRun?.end === window.end
+      ? previousRun.lastRequestAt : null,
+  }
+  writeJson(manifestPath, manifest)
+
+  for (const [index, target] of targets.entries()) {
+    const key = `${target.mapId}/${target.node}`
+    const existing = manifest.nodes[key]
+    const expectedFile = `${window.start}_${window.end}/${target.mapId}/${target.node}.json`
+    const existingFile = existing?.file === expectedFile ? path.join(root, existing.file) : null
+    if (existingFile && fs.existsSync(existingFile)) {
+      const hash = crypto.createHash('sha256').update(fs.readFileSync(existingFile)).digest('hex')
+      if (hash === existing.sha256) continue
+    }
+
+    const elapsed = Date.now() - Date.parse(manifest.longWindow.lastRequestAt || '1970-01-01')
+    const wait = Math.max(0, INTERVAL_MS - elapsed)
+    if (wait) await new Promise((resolve) => setTimeout(resolve, wait))
+    manifest.longWindow.lastRequestAt = new Date().toISOString()
+    writeJson(manifestPath, manifest)
+
+    const url = enemyUrl(target.mapId, target.node, window)
+    console.log(`${index + 1}/${targets.length} ${key} ${window.start}..${window.end}`)
+    const response = await fetch(url, { signal: AbortSignal.timeout(60000) })
+    if (!response.ok) throw new Error(`${key}: HTTP ${response.status}; cache retained, rerun to resume`)
+    const payload = await response.json()
+    const result = validateResponse(payload)
+    const file = expectedFile
+    const sha256 = writeJson(path.join(root, file), payload, true)
+    manifest.nodes[key] = {
+      file,
+      url,
+      sha256,
+      fetchedAt: new Date().toISOString(),
+      window,
+      entries: result.entries.length,
+      samples: sampleCount(payload),
+    }
+    writeJson(manifestPath, manifest)
+  }
+
+  manifest.longWindow.complete = true
+  manifest.longWindow.finishedAt = new Date().toISOString()
+  writeJson(manifestPath, manifest)
+  console.log(`Cached ${targets.length} low-sample enemy nodes for one year`)
+}
+
+if (require.main === module) main().catch((error) => { console.error(error.message); process.exitCode = 1 })
+module.exports = { oneYearWindow, sampleCount, combatTargets }

package/scripts/cache-kcnav-enemies.js

@@ -85,7 +85,15 @@ async function main() {
     const result = validateResponse(payload)
     const file = `${window.start}_${window.end}/${mapId}/${node}.json`
     const sha256 = writeJson(path.join(root, file), payload, true)
-    manifest.nodes[key] = { file, url, sha256, fetchedAt: new Date().toISOString(), entries: result.entries.length }
+    manifest.nodes[key] = {
+      file,
+      url,
+      sha256,
+      fetchedAt: new Date().toISOString(),
+      window,
+      entries: result.entries.length,
+      samples: result.entries.reduce((sum, entry) => sum + entry.count, 0),
+    }
     writeJson(manifestPath, manifest)
   }
   manifest.complete = true