poi-plugin-compass 0.1.0 → 0.1.2

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/index.js

@@ -496,6 +496,7 @@ class Compass extends React.Component {
         : mapIds[0],
       phaseId: phaseOptionsForMap(mapIds[0])[0]?.id || null,
       selectedNode: pluginState.currentNode || null,
+      selectedEdge: null,
       overrides: {},
       exportOpen: false,
       exportRoute: null,
@@ -535,6 +536,7 @@ class Compass extends React.Component {
       mapId,
       phaseId: phaseOptionsForMap(mapId)[0]?.id || null,
       selectedNode: null,
+      selectedEdge: null,
       overrides: {},
       exportRoute: null,
       exportEnemies: {},
@@ -582,15 +584,15 @@ class Compass extends React.Component {
   }
 
   selectPhase(phaseId) {
-    this.setState({ phaseId, selectedNode: null, overrides: {}, exportRoute: null, exportEnemies: {}, exportFormations: {}, exportError: null })
+    this.setState({ phaseId, selectedNode: null, selectedEdge: null, overrides: {}, exportRoute: null, exportEnemies: {}, exportFormations: {}, exportError: null })
   }
 
   selectNode(node) {
-    this.setState({ selectedNode: node })
+    this.setState({ selectedNode: node, selectedEdge: null })
   }
 
   selectFleet(deckId) {
-    this.setState({ deckId, selectedNode: null, overrides: {}, exportRoute: null, exportEnemies: {}, exportFormations: {}, exportError: null })
+    this.setState({ deckId, selectedNode: null, selectedEdge: null, overrides: {}, exportRoute: null, exportEnemies: {}, exportFormations: {}, exportError: null })
   }
 
   renderLosIcons(scores) {
@@ -611,15 +613,20 @@ class Compass extends React.Component {
       `制空 ${air.min === air.max ? air.min : `${air.min}～${air.max}`}`)
   }
 
-  setManualOverride(node, to) {
+  setManualOverride(node, to, edgeId = null) {
     this.setState((state) => ({
       overrides: { ...state.overrides, [node]: to },
       selectedNode: node,
+      selectedEdge: edgeId,
       exportRoute: null,
       exportError: null,
     }))
   }
 
+  selectEdge(edgeId) {
+    this.setState({ selectedEdge: edgeId })
+  }
+
   renderMap(mapDefinition, geometry, evaluation, selectedNode, currentNode, passedNodes = [], mapId = null) {
     if (!mapGeometryAvailable(mapDefinition, geometry)) {
       return h('div', { className: 'compass-empty-panel' }, 'poi 地图数据不可用')
@@ -658,6 +665,7 @@ class Compass extends React.Component {
           || []
         const manualChoice = evaluation.decisions[edge.from]?.manual
           && manualOutcomes.some((outcome) => outcome.to === edge.to)
+        const selected = this.state.selectedEdge === edge.cell
         const edgeClassNames = [
           'compass-edge',
           probability.global != null ? 'is-reachable' : '',
@@ -665,21 +673,33 @@ class Compass extends React.Component {
           probabilityTier(probability.global),
           passedEdges.has(`${edge.from}->${edge.to}`) ? 'is-passed' : '',
           manualChoice ? 'is-manual-choice' : '',
+          selected ? 'is-selected' : '',
         ].filter(Boolean).join(' ')
         const activateEdge = (event) => {
           if (event.key === 'Enter' || event.key === ' ') {
             event.preventDefault()
-            this.setManualOverride(edge.from, edge.to)
+            if (manualChoice) this.setManualOverride(edge.from, edge.to, edge.cell)
+            else this.selectEdge(edge.cell)
           }
         }
         return h('g', {
           key: `edge-${edge.cell}`,
           className: edgeClassNames,
-          role: manualChoice ? 'button' : undefined,
-          tabIndex: manualChoice ? 0 : undefined,
-          onClick: manualChoice ? () => this.setManualOverride(edge.from, edge.to) : undefined,
-          onKeyDown: manualChoice ? activateEdge : undefined,
+          role: 'button',
+          tabIndex: 0,
+          'aria-label': `边 ID ${edge.cell}：${edge.from}→${edge.to}`,
+          onClick: () => manualChoice
+            ? this.setManualOverride(edge.from, edge.to, edge.cell)
+            : this.selectEdge(edge.cell),
+          onKeyDown: activateEdge,
         },
+          h('title', null, [
+            `边 ID ${edge.cell}：${edge.from} → ${edge.to}`,
+            manualChoice ? '点击选择方向' : null,
+            probability.global != null && Number(probability.global) > 0
+              ? `局部 ${formatPercent(probability.local, probability.estimated)}`
+              : null,
+          ].filter(Boolean).join(' · ')),
           h('line', {
             x1: from.x,
             y1: from.y,
@@ -694,10 +714,12 @@ class Compass extends React.Component {
               className: 'compass-edge-label',
             }, formatPercent(probability.global, probability.estimated))
             : null,
-          probability.global != null && Number(probability.global) > 0
-            ? h('title', null, manualChoice
-              ? `能动分歧：选择 ${edge.to}`
-              : `局部 ${formatPercent(probability.local, probability.estimated)}`)
+          selected
+            ? h('text', {
+              x: (from.x + to.x) / 2,
+              y: (from.y + to.y) / 2 - 18,
+              className: 'compass-edge-id-label',
+            }, `ID ${edge.cell}`)
             : null,
         )
       }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-compass",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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.2"
     }
   },
   "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