poi-plugin-senka-ledger 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,72 @@
-# Temporary Holding Version
+# 战果手账 · Senka Ledger
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+面向 **poi 12.0.1** 的独立本地插件。按事件保存战果增量，可查看往月、每日和每小时的记录。界面目前使用简体中文。
+
+## 界面预览
+
+下图均使用模拟数据。
+
+![月度日历](https://raw.githubusercontent.com/asparagusThief/poi-plugin-senka-ledger/main/docs/month.png)
+
+![每日时段与明细](https://raw.githubusercontent.com/asparagusThief/poi-plugin-senka-ledger/main/docs/day.png)
+
+## 统计方式
+
+- **本地确认**：出击结算的 `api_get_exp × 7 / 10000`，以及直接观测到的 EO、成功领取的常设季常战果任务奖励。
+- **未定位增量**：总提督经验增长超过本场奖励的部分，记录「上次观测 → 本次观测」区间。可能来自其他客户端、插件关闭或漏包；无法仅凭差额判定具体原因。
+- **不把发现时间当获得时间**：未定位记录只含经验产生的普通战果，不进入登录当天、登录小时或每日色块。本月内区间单列；跨月区间在相关月份显示区间总额，不分摊，也不能跨月相加。
+- **首次使用**：总经验只建立基准，不把账号终身经验折算为本月战果。如果首次观测就是出击结算，可以记录该场明确给出的奖励。
+- **EO**：直接响应中的 `api_get_exmap_rate` / `api_get_eo_rate` 按响应时刻记账，只在顶部汇总，不进入日历、小时色块或逐笔明细。不再根据地图完成状态推断未在本地记录的 EO，旧版日志中的此类记录也不展示。
+- **任务**：仅在 poi 的成功领取响应后记账，支持任务 ID `854, 888, 893, 872, 284, 845, 903`。按日本时间 3/6/9/12 月 1 日 05:00 重置去重周期。其他战果任务尚未支持；其他客户端领取的任务奖励无法从经验差恢复。
+
+例如：昨天 22:00 总经验为 100000，今天 01:00 本地出击后总经验为 110000，本场经验为 1000。今天 01 时的色块只增加 **0.70**；剩余 **6.30** 作为昨天 22:00 到今天 01:00 的未定位增量单列。
+
+这里显示的是按自然日、自然月分组的**活动战果增量估算**，不是官方排名总战果。月末普通战果与 EO 截止、任务顺延、年内继承及官方排名四舍五入等规则不在此汇总中推算。月末截止后的本地活动仍保留，可回看其实际获得时间。
+
+## 查看与导出
+
+1. 启用插件后进入母港，等待实时账号数据建立基准。插件不会采用 poi 上一次运行缓存的账号或经验。
+2. 选择账号、月份和日本／中国时区。默认日本时间，原始日志统一保存 UTC 毫秒。
+3. 默认显示月度日历，每个日期色块直接显示当日普通战果；点击日期进入二级界面，查看 24 个小时的色块与数值。点击小时可筛选普通战果明细，「返回月览」回到日历。
+4. 月度和每日页面的顶部显示总战果、普通战果、EO 战果与任务战果。EO 和任务不出现在逐笔明细中；未在本地记录的增量只显示经验差额的区间、发现时间与数值。
+5. 「导出本月 CSV」顶部保留月度汇总，下方只有普通战果明细与涉及该月的经验未定位区间；「备份全部 JSON」包含该账号完整原始日志，与旧版数据兼容。
+
+历史从插件开始记录后积累，保留全部月份。游戏不提供往月逐场历史，因此无法自动恢复安装前的每场出击或其他客户端的准确刷取时刻。本地记录的时刻为 poi 接收到响应的时刻，系统时钟需要准确。
+
+## 安装
+
+无需编译或额外运行依赖，使用 poi 自带的 React。安装独立包，不会替换原战果计算插件，可同时运行。
+
+npm 包名：`poi-plugin-senka-ledger`。在 poi 的插件管理中按此包名安装。也可从 [GitHub Releases](https://github.com/asparagusThief/poi-plugin-senka-ledger/releases) 下载本地插件包。
+
+在本目录运行：
+
+```powershell
+& .\scripts\install-local.ps1
+```
+
+自定义 poi 数据目录可传 `-PoiDataDirectory '你的路径'`。安装脚本在目标已存在时停止，不覆盖任何现有插件。重启 poi，在插件设置中启用「战果手账 / Senka Ledger」，然后重新进入母港。
+
+也可使用 `dist/poi-plugin-senka-ledger-0.1.2.tgz` 通过 poi 的本地插件安装功能安装。在源码目录执行 `npm run pack:local` 后会生成此文件。
+
+## 数据与备份
+
+数据位于 poi 的 `APPDATA_PATH/senka-ledger/<账号ID>.jsonl`，Windows 通常是 `%APPDATA%\poi\senka-ledger\`。每个账号独立日志，逐笔追加并同步到磁盘；重启时重放日志，不按月份覆盖或清零。保存少量必要数值与标签，不保存 API token、完整响应、密码或游戏操作。
+
+停用、更新或卸载插件前建议备份整个 `senka-ledger` 数据文件夹。手动恢复时，关闭所有 poi 实例后将原始 `<账号ID>.jsonl` 放回数据目录。导出 JSON 的 `journal` 字段保存同一份原始日志文本，可原样恢复到相应账号文件；目前没有界面导入功能。
+
+同一数据目录只允许一个写入实例。异常退出留下的锁在确认进程不存在后自动恢复；若锁中的进程号已被其他进程复用，需要在关闭全部 poi 后手动移走 `.writer-lock`。日志存在损坏或未写完的末行时，只加载损坏前的有效数据并暂停该账号写入，保留文件供恢复，界面显示异常。
+
+## 开发验证
+
+需要 Node.js 20 或更新版本：
+
+```powershell
+npm.cmd run check
+npm.cmd test
+npm.cmd run pack:local
+```
+
+测试覆盖跨日、跨月、跨年、重连、首次基准、联合舰队、未知增量、本场奖励缺失、重复响应、EO 对账、任务周期、时区分组、多账号、重启恢复与日志损坏。提供模拟数据预览生成器 `scripts/preview.js`；预览数据不写入真实账号文件。
+
+参考核对：[poi 12.0.1](https://github.com/poooi/poi/releases/tag/v12.0.1)、[现有战果计算插件](https://www.npmjs.com/package/poi-plugin-senka-calc)（5.6.2）。本插件为独立实现，未修改或覆盖现有插件。

package/i18n/zh-CN.json

@@ -0,0 +1 @@
+{"Senka Ledger":"战果手账","Daily and hourly records with separate bonus totals":"每日与每小时战果记录"}

package/i18n/zh-TW.json

@@ -0,0 +1 @@
+{"Senka Ledger":"戰果手帳","Daily and hourly records with separate bonus totals":"每日與每小時戰果紀錄"}

package/index.js

@@ -0,0 +1,73 @@
+'use strict'
+
+const React = require('react')
+const fs = require('fs')
+const path = require('path')
+const { Journal } = require('./src/storage')
+const { createAdapter, decode } = require('./src/adapter')
+const { createPanel } = require('./src/panel')
+const { toCSV } = require('./src/export')
+let journal = null
+let adapter = createAdapter()
+let error = null
+let directory = ''
+let loaded = false
+const subscribers = new Set()
+const snapshot = () => ({ account: adapter.account, accounts: [...new Set([...(journal ? journal.list() : []), ...(adapter.account ? [adapter.account] : [])])], error, directory })
+const emit = () => { const value = snapshot(); for (const callback of subscribers) callback(value) }
+function onResponse(event) {
+  try {
+    const previousAccount = adapter.account
+    const result = decode(adapter, event.detail)
+    if (result) for (const input of result.records) journal.append(result.account, input)
+    if (result?.records.length || adapter.account !== previousAccount) emit()
+  } catch (e) { error = e.message; emit() }
+}
+exports.pluginDidLoad = function pluginDidLoad() {
+  if (loaded) return
+  const { APPDATA_PATH, isMain } = require('views/env')
+  if (isMain === false) return
+  loaded = true
+  directory = path.join(APPDATA_PATH, 'senka-ledger')
+  try {
+    journal = new Journal(directory)
+    window.addEventListener('game.response', onResponse)
+    window.addEventListener('beforeunload', exports.pluginWillUnload)
+  } catch (e) { error = e.message }
+  emit()
+}
+exports.pluginWillUnload = function pluginWillUnload() {
+  window.removeEventListener('game.response', onResponse)
+  window.removeEventListener('beforeunload', exports.pluginWillUnload)
+  if (journal) journal.close()
+  journal = null
+  adapter = createAdapter()
+  error = null
+  loaded = false
+}
+const service = {
+  snapshot,
+  subscribe(callback) {
+    subscribers.add(callback)
+    exports.pluginDidLoad()
+    callback(snapshot())
+    return () => subscribers.delete(callback)
+  },
+  entry(account) {
+    if (!journal || !account) return null
+    try { return journal.load(account) } catch (e) { return { error: e.message } }
+  },
+  export(account, month, zone, type) {
+    if (!journal) throw new Error('存储尚未初始化')
+    const entry = journal.load(account)
+    const data = type === 'json' ? JSON.stringify({ format: 'poi-senka-ledger', version: 1, account, journal: fs.readFileSync(entry.file, 'utf8') }, null, 2) : toCSV(entry.state, month, zone)
+    const blob = new Blob([data], { type: type === 'json' ? 'application/json;charset=utf-8' : 'text/csv;charset=utf-8' })
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `senka-${account}-${type === 'json' ? 'all' : month}.${type}`
+    a.click()
+    setTimeout(() => URL.revokeObjectURL(url), 10000)
+  }
+}
+exports.reactClass = createPanel(React, service)

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "poi-plugin-senka-ledger",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "description": "按事件记录战果，保留往月明细并分离来源不明的增量",
+  "main": "index.js",
+  "license": "MIT",
+  "author": "asparagusThief",
+  "homepage": "https://github.com/asparagusThief/poi-plugin-senka-ledger#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asparagusThief/poi-plugin-senka-ledger.git"
+  },
+  "bugs": {
+    "url": "https://github.com/asparagusThief/poi-plugin-senka-ledger/issues"
+  },
+  "keywords": ["poi", "poi-plugin", "kancolle", "senka", "战果"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": ["index.js", "src", "i18n", "README.md", "LICENSE"],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "check": "node scripts/check.js",
+    "pack:local": "node scripts/pack.js"
+  },
+  "poiPlugin": {
+    "name": "Senka Ledger",
+    "id": "senka-ledger",
+    "description": "Daily and hourly records with separate bonus totals",
+    "i18nDir": "i18n",
+    "icon": "fa/line-chart",
+    "earliestCompatibleMain": "12.0.1",
+    "priority": 98
+  }
+}

package/src/adapter.js

@@ -0,0 +1,69 @@
+'use strict'
+
+const { EO, QUESTS } = require('./ledger')
+const { parts } = require('./time')
+const number = value => {
+  if (value === null || value === undefined || value === '' || typeof value === 'boolean') return null
+  const n = Number(value)
+  return Number.isSafeInteger(n) && n >= 0 ? n : null
+}
+const BATTLES = new Set(['/kcsapi/api_req_sortie/battleresult', '/kcsapi/api_req_combined_battle/battleresult'])
+function createAdapter() {
+  return { account: null, mapId: null, node: null }
+}
+// Read only documented, relevant fields. Tokens and complete API bodies never enter the journal.
+function decode(adapter, detail) {
+  const { path, body = {}, postBody = {}, time: at } = detail || {}
+  if (!Number.isSafeInteger(at) || at < 0) return null
+  const basic = path === '/kcsapi/api_port/port' || path === '/kcsapi/api_get_member/require_info' ? body.api_basic :
+    path === '/kcsapi/api_get_member/basic' ? body : null
+  if (basic && /^\d+$/.test(String(basic.api_member_id))) {
+    const account = String(basic.api_member_id)
+    if (adapter.account !== account) { adapter.mapId = null; adapter.node = null }
+    adapter.account = account
+  }
+  if (path === '/kcsapi/api_start2/getData') {
+    adapter.account = null
+    adapter.mapId = null
+    adapter.node = null
+  }
+  if (!adapter.account) return null
+  const records = []
+  const push = data => records.push({ v: 1, at, ...data })
+  let exp = null
+  if (basic) exp = number(basic.api_experience)
+  else if (path === '/kcsapi/api_get_member/record') exp = number(body.api_experience?.[0])
+  else if (BATTLES.has(path) || ['/kcsapi/api_req_practice/battle_result', '/kcsapi/api_req_mission/result'].includes(path)) exp = number(body.api_member_exp)
+  if (path === '/kcsapi/api_req_map/start' || path === '/kcsapi/api_req_map/next') {
+    const area = number(body.api_maparea_id) ?? number(postBody.api_maparea_id)
+    const map = number(body.api_mapinfo_no) ?? number(postBody.api_mapinfo_no)
+    if (path.endsWith('/start')) adapter.mapId = area !== null && map !== null ? area * 10 + map : null
+    else if (area !== null && map !== null) adapter.mapId = area * 10 + map
+    adapter.node = number(body.api_no)
+  }
+  const mapLabel = adapter.mapId === null ? '海域未知' : `${Math.floor(adapter.mapId / 10)}-${adapter.mapId % 10}`
+  if (exp !== null) push({ type: 'experience', exp,
+    gain: BATTLES.has(path) ? number(body.api_get_exp) : null,
+    label: BATTLES.has(path) ? `${mapLabel}${adapter.node === null ? '' : ` 节点 ${adapter.node}`} · ${body.api_win_rank || '?'} 胜败` : '总经验观测' })
+  const eoAmount = number(body.api_get_exmap_rate) || number(body.api_get_eo_rate)
+  if (eoAmount && (BATTLES.has(path) || path === '/kcsapi/api_req_map/next' || path === '/kcsapi/api_req_map/start')) {
+    const id = adapter.mapId !== null && Object.hasOwn(EO, adapter.mapId) ? adapter.mapId : null
+    push({ type: 'bonus', kind: 'eo', amount: eoAmount, mapId: id, questId: null,
+      key: id === null ? `eo-response:${at}:${eoAmount}` : `eo:${parts(at).month}:${id}`,
+      label: `${mapLabel} · EO 奖励` })
+  }
+  // Only a successful response is accepted. A request alone does not prove a reward was claimed.
+  if (path === '/kcsapi/api_req_quest/clearitemget') {
+    const id = number(postBody.api_quest_id)
+    if (Object.hasOwn(QUESTS, id)) {
+      const [amount, label] = QUESTS[id]
+      const date = new Date(at + 9 * 3600000 - 5 * 3600000)
+      const quarter = Math.floor((date.getUTCMonth() + 10) / 3)
+      const cycleYear = date.getUTCMonth() < 2 ? date.getUTCFullYear() - 1 : date.getUTCFullYear()
+      push({ type: 'bonus', kind: 'quest', amount, questId: id, mapId: null,
+        key: `quest:${cycleYear}:${quarter % 4}:${id}`, label: `${label} · 任务 ${id}` })
+    }
+  }
+  return { account: adapter.account, records }
+}
+module.exports = { number, createAdapter, decode }

package/src/export.js

@@ -0,0 +1,20 @@
+'use strict'
+
+const { summarize } = require('./model')
+const { formatTime } = require('./time')
+// Spreadsheet applications interpret leading formula characters even inside CSV quotes.
+function cell(value) {
+  const text = String(value ?? '')
+  return '"' + (/^[=+@\-\t\r]/.test(text) ? "'" + text : text).replaceAll('"', '""') + '"'
+}
+function toCSV(state, month, zone) {
+  const stats = summarize(state, month, zone)
+  const rows = [['月份', month, '时区', zone], ['本月战果', stats.total.toFixed(4)], ['普通战果', stats.normal.toFixed(4)],
+    ['EO 战果', stats.eo.toFixed(4)], ['任务战果', stats.quest.toFixed(4)], [],
+    ['来源', '种类', '战果增量', '提督经验', '记录或发现时间', '区间起点', '区间终点', '海域', '时区']]
+  const events = [...stats.days.flatMap(d => d.events), ...stats.unknown].sort((a, b) => a.at - b.at)
+  for (const e of events) rows.push([e.source === 'local' ? '本地确认' : '未定位', e.kind, e.amount.toFixed(4), e.exp ?? '', formatTime(e.at, zone),
+    e.from === undefined ? '' : formatTime(e.from, zone), e.to === undefined ? '' : formatTime(e.to, zone), e.source === 'local' ? e.label : '', zone])
+  return '\ufeff' + rows.map(row => row.map(cell).join(',')).join('\r\n')
+}
+module.exports = { toCSV, cell }

package/src/ledger.js

@@ -0,0 +1,116 @@
+'use strict'
+
+const { parts, monthStart } = require('./time')
+const RATE = 7 / 10000
+const EO = { 15: 75, 16: 75, 25: 100, 35: 150, 45: 180, 55: 200, 56: 225, 65: 250, 75: 170 }
+const QUESTS = {
+  854: [350, 'Z作战前段'], 888: [200, '三川舰队'], 893: [300, '泊地周边'],
+  872: [400, 'Z作战后段'], 284: [80, '海上警备'], 845: [330, '西方海域'], 903: [390, '六水战']
+}
+const integer = n => Number.isSafeInteger(n) && n >= 0
+function validInput(input) {
+  if (!input || input.v !== 1 || !Number.isSafeInteger(input.at) || input.at < 0) return false
+  switch (input.type) {
+    case 'experience': return integer(input.exp) && (input.gain === null || integer(input.gain)) && typeof input.label === 'string'
+    case 'bonus': return ['eo', 'quest'].includes(input.kind) && integer(input.amount) && input.amount > 0 && typeof input.key === 'string' && typeof input.label === 'string' &&
+      (input.mapId === null || integer(input.mapId)) && (input.questId === null || integer(input.questId))
+    case 'maps': return Array.isArray(input.cleared) && input.cleared.every(n => integer(n) && Object.hasOwn(EO, n))
+    default: return false
+  }
+}
+function createLedger() {
+  return { events: [], baseline: null, eoMonths: {}, unlocatedEO: {}, ambiguousEO: {}, bonusKeys: new Set(), sequence: 0 }
+}
+function add(state, event) {
+  state.events.push({ id: ++state.sequence, ...event })
+}
+function unknown(state, input, amount, kind, from, label) {
+  add(state, { source: 'unknown', kind, amount, at: input.at, from, to: input.at, label })
+}
+function apply(state, input) {
+  if (!validInput(input)) throw new Error('Invalid ledger record')
+  const { at } = input
+  if (input.type === 'experience') {
+    const old = state.baseline
+    // Ignore stale observations: they must never move the cumulative baseline backwards.
+    if (old && at < old.at) return
+    const localGain = input.gain
+    if (!old) {
+      if (localGain !== null && localGain <= input.exp && localGain > 0) {
+        add(state, { source: 'local', kind: 'normal', amount: localGain * RATE, exp: localGain, at, label: input.label })
+      }
+      add(state, { source: 'baseline', kind: 'baseline', amount: 0, at, label: '首次观测：此前普通战果未收录' })
+    } else {
+      const delta = input.exp - old.exp
+      if (delta < 0) {
+        add(state, { source: 'warning', kind: 'warning', amount: 0, at, label: '总经验回退：已忽略异常观测并保留原基准' })
+        return
+      } else if (localGain !== null && localGain > delta) {
+        // Duplicate/overlapping results or inconsistent API values are not safe to attribute.
+        if (delta > 0) unknown(state, input, delta * RATE, 'normal', old.at, '经验与本场奖励不一致，无法定位')
+      } else {
+        const known = localGain || 0
+        if (delta > known) unknown(state, input, (delta - known) * RATE, 'normal', old.at, '未在本地记录的经验增量（可能来自其他客户端）')
+        if (known > 0) add(state, { source: 'local', kind: 'normal', amount: known * RATE, exp: known, at, label: input.label })
+      }
+    }
+    state.baseline = { exp: input.exp, at }
+  } else if (input.type === 'bonus') {
+    if (state.bonusKeys.has(input.key)) return
+    state.bonusKeys.add(input.key)
+    const month = parts(at).month
+    if (input.kind === 'eo' && input.mapId !== null) {
+      const seen = state.eoMonths[month] ||= {}
+      // A map snapshot may have arrived before this response. Upgrade the existing
+      // inferred event instead of counting the same EO reward twice.
+      const prior = seen[input.mapId]
+      if (prior) {
+        const event = state.events.find(e => e.id === prior)
+        if (event && event.source === 'unknown' && event.amount === input.amount) {
+          Object.assign(event, { source: 'local', at, label: input.label })
+          delete event.from
+          delete event.to
+        }
+        return
+      }
+      add(state, { source: 'local', kind: 'eo', amount: input.amount, at, label: input.label })
+      seen[input.mapId] = state.sequence
+    } else {
+      if (input.kind === 'eo') {
+        (state.ambiguousEO[month] ||= new Set()).add(input.amount)
+        for (const event of state.events) {
+          if (event.kind === 'eo' && event.source === 'unknown' && event.amount === input.amount && parts(event.at).month === month) {
+            event.label = `EO ${input.amount} 战果奖励，同额海域无法区分，完成时间未记录`
+          }
+        }
+        const prior = state.events.find(e => e.kind === 'eo' && e.source === 'unknown' && e.amount === input.amount && parts(e.at).month === month)
+        if (prior) {
+          Object.assign(prior, { source: 'local', at, label: input.label })
+          delete prior.from
+          delete prior.to
+          return
+        }
+      }
+      add(state, { source: 'local', kind: input.kind, amount: input.amount, at, label: input.label })
+      if (input.kind === 'eo') (state.unlocatedEO[month] ||= []).push({ amount: input.amount, id: state.sequence })
+    }
+  } else if (input.type === 'maps') {
+    const month = parts(at).month
+    const seen = state.eoMonths[month] ||= {}
+    for (const id of input.cleared) {
+      if (seen[id]) continue
+      // Starting the plugin in an ongoing sortie can leave the map identity
+      // unknown. Consume that direct reward before inferring any extra EO.
+      const credits = state.unlocatedEO[month] ||= []
+      const matching = credits.findIndex(credit => credit.amount === EO[id])
+      if (matching >= 0) {
+        seen[id] = credits.splice(matching, 1)[0].id
+        continue
+      }
+      const label = state.ambiguousEO[month]?.has(EO[id]) ? `EO ${EO[id]} 战果奖励，同额海域无法区分，完成时间未记录` : `EO ${Math.floor(id / 10)}-${id % 10} 已完成，完成时间未记录`
+      unknown(state, input, EO[id], 'eo', monthStart(at), label)
+      seen[id] = state.sequence
+    }
+  }
+}
+module.exports = { RATE, EO, QUESTS, validInput, createLedger, apply }

package/src/model.js

@@ -0,0 +1,50 @@
+'use strict'
+
+const { parts, monthBounds } = require('./time')
+function months(state, zone) {
+  const result = new Set()
+  for (const e of state.events) {
+    if (e.source === 'unknown' && e.kind !== 'normal') continue
+    result.add(parts(e.at, zone).month)
+    if (e.source === 'unknown') {
+      let cursor = e.from
+      while (parts(cursor, zone).month < parts(e.to, zone).month) {
+        result.add(parts(cursor, zone).month)
+        cursor = monthBounds(parts(cursor, zone).month, zone)[1]
+      }
+    }
+  }
+  return [...result].sort().reverse()
+}
+function summarize(state, month, zone = 'Asia/Tokyo', minutes = 60) {
+  const [start, end] = monthBounds(month, zone)
+  const count = Math.round((end - start) / 86400000)
+  const columns = 1440 / minutes
+  const days = Array.from({ length: count }, (_, i) => ({ day: `${month}-${String(i + 1).padStart(2, '0')}`, total: 0, normal: 0, eo: 0, quest: 0, slots: Array(columns).fill(0), events: [] }))
+  const unknown = []
+  let total = 0, normal = 0, eo = 0, quest = 0
+  for (const e of state.events) {
+    if (e.source === 'unknown') {
+      if (e.kind === 'normal' && e.from < end && e.to >= start) unknown.push({ ...e, withinMonth: e.from >= start && e.to < end })
+      continue
+    }
+    if (e.source !== 'local' || e.at < start || e.at >= end) continue
+    const p = parts(e.at, zone)
+    const day = days[Number(p.day.slice(-2)) - 1]
+    if (e.kind === 'normal') {
+      const minute = new Date(e.at + (zone === 'Asia/Shanghai' ? 8 : 9) * 3600000).getUTCMinutes()
+      day.slots[Math.floor((p.hour * 60 + minute) / minutes)] += e.amount
+      day.events.push(e)
+    }
+    day.total += e.amount
+    day[e.kind] += e.amount
+    total += e.amount
+    if (e.kind === 'normal') normal += e.amount
+    if (e.kind === 'eo') eo += e.amount
+    if (e.kind === 'quest') quest += e.amount
+  }
+  return { days, total, normal, eo, quest, unknown,
+    unknownWithinMonth: unknown.filter(e => e.withinMonth).reduce((s, e) => s + e.amount, 0),
+    unknownAcrossMonths: unknown.filter(e => !e.withinMonth).reduce((s, e) => s + e.amount, 0) }
+}
+module.exports = { months, summarize }

package/src/panel.js

@@ -0,0 +1,97 @@
+'use strict'
+
+const { parts, formatTime, monthBounds, DAY } = require('./time')
+const { months, summarize } = require('./model')
+const { createLedger } = require('./ledger')
+const style = `
+.sl{font:13px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei",sans-serif;padding:18px;min-width:280px;--sl-line:rgba(140,155,170,.28);color:inherit;container-type:inline-size}
+.sl *{box-sizing:border-box}.sl h2{font-size:22px;margin:0;font-weight:650}.sl h3{font-size:15px;margin:0;font-weight:600}.sl p{margin:6px 0}.sl .muted{opacity:.7}.sl .top,.sl .controls,.sl .navigation{display:flex;gap:10px;align-items:center;flex-wrap:wrap}.sl .top{justify-content:space-between}.sl .tag{color:#168777;background:rgba(40,178,153,.12);padding:3px 8px;border-radius:5px}.sl .controls{margin:16px 0}.sl select,.sl button{font:inherit;color:inherit;background:transparent;border:1px solid var(--sl-line);border-radius:5px;padding:5px 9px}.sl select option{color:#172d3b;background:#f6f9fb}.sl button{cursor:pointer}.sl button:disabled{opacity:.4;cursor:default}.sl button:focus-visible,.sl select:focus-visible{outline:2px solid #16a18a;outline-offset:2px}
+.sl .cards{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px}.sl .card{border:1px solid var(--sl-line);border-radius:8px;padding:12px;min-width:0}.sl .value{font-size:clamp(18px,4cqi,28px);font-variant-numeric:tabular-nums;font-weight:650;overflow-wrap:anywhere}.sl .accent{color:#159985}.sl .amber{color:#c68d26}.sl .error{border:1px solid #d56b6b;padding:10px;white-space:pre-wrap}.sl .scroll{overflow:auto;max-width:100%}.sl table{border-collapse:collapse;width:100%;font-variant-numeric:tabular-nums}.sl th,.sl td{text-align:left;padding:7px 9px;border-bottom:1px solid var(--sl-line);white-space:nowrap}.sl th{font-size:12px;opacity:.75;font-weight:500}.sl .section{margin-top:24px}.sl .section-head{margin-bottom:12px}.sl .calendar{display:grid;grid-template-columns:repeat(7,minmax(0,1fr));gap:7px;min-width:0}.sl .weekday{text-align:center;opacity:.65;padding:3px 0 7px}.sl .tile{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:8px;border:1px solid transparent;border-radius:8px;min-width:0;min-height:84px;gap:6px;text-align:center;transition:box-shadow .12s}.sl .tile:hover{box-shadow:inset 0 0 0 2px rgba(22,130,111,.5)}.sl .tile[aria-pressed="true"]{outline:2px solid #c68d26;outline-offset:1px}.sl .tile-label{font-size:18px;font-weight:600;line-height:1.3;white-space:nowrap}.sl .tile-value{font-size:clamp(10px,2.8cqi,23px);font-weight:650;line-height:1.3;font-variant-numeric:tabular-nums;overflow-wrap:anywhere}.sl .hours{display:grid;grid-template-columns:repeat(6,minmax(0,1fr));gap:8px}.sl .hours .tile{min-height:84px}.sl .legend{display:flex;align-items:center;gap:4px;justify-content:flex-end;margin-top:10px;font-size:11px;opacity:.75}.sl .swatch{display:inline-block;width:14px;height:12px;border-radius:2px}.sl .empty{padding:20px 12px;text-align:center;opacity:.65}.sl .foot{font-size:11px;opacity:.5;text-align:right;margin-top:20px}
+@container(max-width:520px){.sl .calendar{gap:4px}.sl .calendar .tile{padding:4px}.sl .cards{grid-template-columns:repeat(2,minmax(0,1fr))}.sl .hours{grid-template-columns:repeat(4,minmax(0,1fr))}.sl .tile{padding:6px}.sl .hours .tile-value{font-size:18px}}
+`
+const colors = ['rgba(130,150,160,.13)', '#c4e9d8', '#81cdb2', '#36aa8f', '#087e70']
+const fmt = n => n.toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 2 })
+const tileNumber = n => n.toLocaleString('zh-CN', { useGrouping: false, minimumFractionDigits: 2, maximumFractionDigits: 2 })
+function tileStyle(value, max) {
+  const level = value <= 0 ? 0 : Math.min(4, 1 + Math.floor(value / (max || 1) * 3))
+  return { background: colors[level], color: level === 4 ? '#fff' : level ? '#173e36' : 'inherit' }
+}
+function createPanel(React, service) {
+  const h = React.createElement
+  return function SenkaLedgerPanel() {
+    const [snapshot, setSnapshot] = React.useState(service.snapshot())
+    const [zone, setZone] = React.useState('Asia/Tokyo')
+    const [month, setMonth] = React.useState(parts(Date.now()).month)
+    const [day, setDay] = React.useState(null)
+    const [viewAccount, setViewAccount] = React.useState('')
+    const [slot, setSlot] = React.useState(null)
+    const [exportError, setExportError] = React.useState('')
+    React.useEffect(() => service.subscribe(setSnapshot), [])
+    const account = viewAccount || snapshot.account || snapshot.accounts[0] || ''
+    const entry = service.entry(account)
+    const state = entry?.state || createLedger()
+    const allMonths = [...new Set([parts(Date.now(), zone).month, month, ...months(state, zone)])].sort().reverse()
+    const stats = summarize(state, month, zone)
+    const selected = stats.days.find(d => d.day === day) || null
+    const totals = selected || stats
+    const prefix = selected ? '当日' : '本月'
+    const maxDay = Math.max(0, ...stats.days.map(d => d.normal))
+    const maxHour = selected ? Math.max(0, ...selected.slots) : 0
+    const timeline = selected ? selected.events.filter(e => slot === null || parts(e.at, zone).hour === slot).slice().sort((a, b) => b.at - a.at || b.id - a.id) : []
+    const [start] = monthBounds(month, zone)
+    const selectedStart = selected ? start + (Number(selected.day.slice(-2)) - 1) * DAY : null
+    const unknown = stats.unknown.filter(e => !selected || (e.from < selectedStart + DAY && e.to >= selectedStart)).slice().sort((a, b) => b.at - a.at)
+    const offset = (new Date(month + '-01T00:00:00Z').getUTCDay() + 6) % 7
+    const card = (label, value, accent = false) => h('div', { className: 'card', 'data-summary': label }, h('div', { className: 'muted' }, label), h('div', { className: `value${accent ? ' accent' : ''}` }, fmt(value)))
+    const th = labels => h('thead', null, h('tr', null, ...labels.map(s => h('th', { key: s }, s))))
+    const back = () => { setDay(null); setSlot(null) }
+    const openDay = value => { setDay(value); setSlot(null) }
+    const download = type => {
+      try { service.export(account, month, zone, type); setExportError('') } catch (error) { setExportError(error.message) }
+    }
+    const legend = h('div', { className: 'legend', 'aria-hidden': true }, '少 ', ...colors.map(c => h('span', { key: c, className: 'swatch', style: { background: c } })), ' 多')
+    return h('main', { className: 'sl', 'data-view': selected ? 'day' : 'month' }, h('style', null, style),
+      h('div', { className: 'top' }, h('h2', null, '战果手账'), h('span', { className: 'tag' }, snapshot.error || entry?.error ? '存储异常' : snapshot.account ? '记录中' : '等待游戏数据')),
+      (snapshot.error || entry?.error || exportError) && h('p', { role: 'alert', className: 'error' }, snapshot.error || entry?.error || exportError),
+      h('div', { className: 'controls' },
+        h('label', null, '账号 ', h('select', { 'aria-label': '账号', value: account, onChange: e => { setViewAccount(e.target.value); back() } },
+          !account && h('option', { value: '' }, '等待游戏数据'), ...snapshot.accounts.map(id => h('option', { key: id, value: id }, id + (id === snapshot.account ? ' · 当前' : ''))))),
+        h('label', null, '月份 ', h('select', { 'aria-label': '月份', value: month, onChange: e => { setMonth(e.target.value); back() } }, ...allMonths.map(m => h('option', { key: m }, m)))),
+        h('label', null, '时间 ', h('select', { 'aria-label': '时区', value: zone, onChange: e => { setZone(e.target.value); setSlot(null) } }, h('option', { value: 'Asia/Tokyo' }, '日本 UTC+9'), h('option', { value: 'Asia/Shanghai' }, '中国 UTC+8'))),
+        h('button', { disabled: !account, onClick: () => download('csv') }, '导出本月 CSV'),
+        h('button', { disabled: !account, onClick: () => download('json') }, '备份全部 JSON')),
+      selected && h('div', { className: 'top section-head navigation' },
+        h('button', { onClick: back, 'aria-label': '返回月览' }, '← 返回月览'), h('h3', null, selected.day),
+        h('div', { className: 'navigation' },
+          h('button', { disabled: selected === stats.days[0], onClick: () => openDay(stats.days[stats.days.indexOf(selected) - 1].day) }, '前一天'),
+          h('button', { disabled: selected === stats.days[stats.days.length - 1], onClick: () => openDay(stats.days[stats.days.indexOf(selected) + 1].day) }, '后一天'))),
+      h('div', { className: 'cards' }, card(`${prefix}战果`, totals.total, true), card('普通战果', totals.normal), card('EO 战果', totals.eo), card('任务战果', totals.quest)),
+      !selected ? h('section', { className: 'section', 'aria-label': '月度战果' },
+        h('h3', { className: 'section-head' }, `${month} · 每日普通战果`),
+        h('div', { className: 'scroll' }, h('div', { className: 'calendar', 'aria-label': '每日战果' },
+          ...['一', '二', '三', '四', '五', '六', '日'].map(s => h('div', { key: s, className: 'weekday' }, s)),
+          ...Array.from({ length: offset }, (_, i) => h('div', { key: `blank-${i}`, 'aria-hidden': true })),
+          ...stats.days.map(d => h('button', { key: d.day, className: 'tile', 'data-day': d.day,
+            'aria-label': `${d.day} 普通战果 ${tileNumber(d.normal)}`, style: tileStyle(d.normal, maxDay), onClick: () => openDay(d.day) },
+            h('span', { className: 'tile-label' }, Number(d.day.slice(-2))), h('span', { className: 'tile-value' }, tileNumber(d.normal)))))), legend) :
+        h('section', { className: 'section', 'aria-label': '当日战果' },
+          h('h3', { className: 'section-head' }, '每小时普通战果'),
+          h('div', { className: 'hours', 'aria-label': '每小时战果' }, ...selected.slots.map((value, hour) => h('button', { key: hour, className: 'tile', 'data-hour': hour,
+            'aria-label': `${selected.day} ${hour}时 普通战果 ${tileNumber(value)}`, 'aria-pressed': slot === hour,
+            style: tileStyle(value, maxHour), onClick: () => setSlot(slot === hour ? null : hour) },
+            h('span', { className: 'tile-label' }, `${String(hour).padStart(2, '0')}:00`), h('span', { className: 'tile-value' }, tileNumber(value))))), legend,
+          h('div', { className: 'top section section-head' }, h('h3', null, slot === null ? '当日明细' : `${String(slot).padStart(2, '0')}:00–${String(slot + 1).padStart(2, '0')}:00 · 明细`),
+            slot !== null && h('button', { onClick: () => setSlot(null) }, '查看全天')),
+          h('div', { className: 'scroll' }, h('table', { 'aria-label': '普通战果明细' }, th(['记录时间', '提督经验', '战果', '海域']),
+            h('tbody', null, ...timeline.slice(0, 300).map(e => h('tr', { key: e.id }, h('td', null, formatTime(e.at, zone).slice(11)), h('td', null, e.exp.toLocaleString()), h('td', null, fmt(e.amount)), h('td', null, e.label))),
+              !timeline.length && h('tr', null, h('td', { colSpan: 4, className: 'empty' }, '暂无记录'))))),
+          timeline.length > 300 && h('p', { className: 'muted' }, `共 ${timeline.length} 笔 · 显示最新 300 笔`)),
+      h('section', { className: 'section' }, h('h3', { className: 'section-head' }, '未在本地记录的增量'),
+        h('div', { className: 'scroll' }, h('table', { 'aria-label': '未在本地记录的增量' }, th(['可能发生区间', '发现于', '战果']), h('tbody', null,
+          ...unknown.slice(0, 200).map(e => h('tr', { key: e.id }, h('td', null, `${formatTime(e.from, zone)} → ${formatTime(e.to, zone)}`), h('td', null, formatTime(e.at, zone)), h('td', { className: 'amber' }, fmt(e.amount)))),
+          !unknown.length && h('tr', null, h('td', { colSpan: 3, className: 'empty' }, '暂无记录'))))),
+        unknown.length > 200 && h('p', { className: 'muted' }, `共 ${unknown.length} 笔 · 显示最新 200 笔`)),
+      h('div', { className: 'foot' }, 'v0.1.2'))
+  }
+}
+module.exports = { createPanel }

package/src/storage.js

@@ -0,0 +1,76 @@
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const { createLedger, apply, validInput } = require('./ledger')
+
+class Journal {
+  constructor(directory) {
+    this.directory = directory
+    fs.mkdirSync(directory, { recursive: true })
+    this.accounts = new Map()
+    this.lockPath = path.join(directory, '.writer-lock')
+    // An advisory, process-scoped lock prevents two poi main windows from writing.
+    try { this.lock = fs.openSync(this.lockPath, 'wx'); fs.writeFileSync(this.lock, String(process.pid)) }
+    catch (error) {
+      if (error.code !== 'EEXIST') throw error
+      const pid = Number(fs.readFileSync(this.lockPath, 'utf8'))
+      if (!Number.isSafeInteger(pid) || pid <= 0) throw new Error('存储锁无效，请检查 .writer-lock')
+      try { process.kill(pid, 0) } catch (probe) {
+        if (probe.code === 'ESRCH') {
+          fs.unlinkSync(this.lockPath)
+          this.lock = fs.openSync(this.lockPath, 'wx')
+          fs.writeFileSync(this.lock, String(process.pid))
+        } else throw probe
+      }
+      if (this.lock === undefined) throw new Error('另一个 poi 实例正在记录战果，请关闭另一实例')
+    }
+  }
+  list() {
+    return fs.readdirSync(this.directory).filter(n => /^\d+\.jsonl$/.test(n)).map(n => n.slice(0, -6)).sort()
+  }
+  load(account) {
+    if (!/^\d+$/.test(account)) throw new Error('Invalid account')
+    if (this.accounts.has(account)) return this.accounts.get(account)
+    const entry = { state: createLedger(), file: path.join(this.directory, account + '.jsonl'), error: null }
+    let contents = ''
+    try { contents = fs.readFileSync(entry.file, 'utf8') } catch (error) { if (error.code !== 'ENOENT') throw error }
+    const lines = contents.split('\n')
+    for (let i = 0; i < lines.length; i++) {
+      if (i === lines.length - 1 && lines[i] === '') break
+      try {
+        if (i === lines.length - 1) throw new Error('末行写入未完成')
+        const input = JSON.parse(lines[i])
+        if (!validInput(input)) throw new Error('格式不兼容')
+        apply(entry.state, input)
+      } catch (error) {
+        entry.error = `记录第 ${i + 1} 行异常：${error.message}。已保留原文件并暂停写入。`
+        break
+      }
+    }
+    this.accounts.set(account, entry)
+    return entry
+  }
+  append(account, input) {
+    if (!validInput(input)) throw new Error('Invalid ledger record')
+    const entry = this.load(account)
+    if (entry.error) throw new Error(entry.error)
+    const fd = fs.openSync(entry.file, 'a')
+    try {
+      fs.writeFileSync(fd, JSON.stringify(input) + '\n', 'utf8')
+      fs.fsyncSync(fd)
+    } catch (error) {
+      entry.error = `保存失败，已暂停写入：${error.message}`
+      throw error
+    } finally { fs.closeSync(fd) }
+    apply(entry.state, input)
+  }
+  close() {
+    if (this.lock !== undefined) {
+      fs.closeSync(this.lock)
+      this.lock = undefined
+      fs.unlinkSync(this.lockPath)
+    }
+  }
+}
+module.exports = { Journal }

package/src/time.js

@@ -0,0 +1,24 @@
+'use strict'
+
+const HOUR = 3600000
+const DAY = 24 * HOUR
+const OFFSETS = { 'Asia/Tokyo': 9, 'Asia/Shanghai': 8 }
+function parts(at, zone = 'Asia/Tokyo') {
+  if (!Number.isFinite(at) || !Object.hasOwn(OFFSETS, zone)) throw new Error('Invalid time or timezone')
+  const date = new Date(at + OFFSETS[zone] * HOUR)
+  return { day: date.toISOString().slice(0, 10), month: date.toISOString().slice(0, 7), hour: date.getUTCHours() }
+}
+function formatTime(at, zone = 'Asia/Tokyo') {
+  return new Date(at + OFFSETS[zone] * HOUR).toISOString().slice(0, 19).replace('T', ' ')
+}
+function monthStart(at) {
+  return Date.parse(parts(at).month + '-01T00:00:00+09:00')
+}
+function monthBounds(month, zone = 'Asia/Tokyo') {
+  if (!/^\d{4}-(0[1-9]|1[0-2])$/.test(month)) throw new Error('Invalid month')
+  const start = Date.parse(month + '-01T00:00:00Z') - OFFSETS[zone] * HOUR
+  const date = new Date(start + OFFSETS[zone] * HOUR)
+  date.setUTCMonth(date.getUTCMonth() + 1)
+  return [start, date.getTime() - OFFSETS[zone] * HOUR]
+}
+module.exports = { HOUR, DAY, parts, formatTime, monthStart, monthBounds }