poi-plugin-sortie-exp 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yahagi contributors
+
+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

@@ -0,0 +1,43 @@
+# 出击经验记录 · poi 插件
+
+**出击经验记录**是从 Yahagi 首页的「出击经验」功能独立出来、为 poi 适配的插件。它用来查看每艘舰娘在普通出击和演习中获得了多少经验。[原项目 Yahagi](https://github.com/yamatosaki/yahagi-kancolle-browser)
+
+普通出击每场战斗结算后，插件会更新逐舰经验、占比和舰队经验合计。返港后保留上一趟记录。演习结算也计为一次出击。
+
+## 界面预览
+
+**本次出击**显示海域、舰队、已结算场数和舰队经验合计。表格列出舰娘头像、等级、获得经验和占比。
+
+![本次出击页的舰队经验合计和逐舰经验](https://raw.githubusercontent.com/yamatosaki/poi-plugin-sortie-exp/main/docs/images/sortie.png)
+
+**总累计**显示累计出击场数和全部舰船经验合计。表格列出每艘舰娘的累计经验和占比，每页最多显示 10 艘，可以翻页查看，也可以通过「自定义显示」筛选舰娘。
+
+![总累计页的出击场数和逐舰累计经验](https://raw.githubusercontent.com/yamatosaki/poi-plugin-sortie-exp/main/docs/images/totals.png)
+
+## 安装
+
+在 poi 的「设置 → 插件」中找到「直接从 npm 服务器安装」，输入 `poi-plugin-sortie-exp` 并点击「安装」。安装后打开「出击经验记录」。也可以下载 `.tgz` 安装包，在同一页面从文件安装。[GitHub Releases](https://github.com/yamatosaki/poi-plugin-sortie-exp/releases) · [poi 插件安装入口](https://github.com/poooi/poi/blob/master/i18n/setting/zh-CN.json#L917-L923)
+
+已在 Windows 上的 poi 12.0.1 验证。
+
+## 使用说明
+
+- **总累计默认关闭。** 开启后，插件统计开关开启期间结算的经验。普通出击在返港时入账，演习在结算时入账。
+- **记录按账号保存在本机。** 换号后进入母港，插件会加载该账号的上一趟记录、总累计、累计开关和显示设置。
+- **可自定义总累计显示的舰娘。** 在「自定义显示」中搜索和勾选舰娘，点击「完成」后应用。隐藏的舰娘仍会累计经验，顶部合计和占比仍按全部舰娘计算。
+- **总累计每页最多显示 10 艘。** 使用表格底部的「上一页」「下一页」翻页。确认新的显示名单或切换账号后回到第一页。
+- **自动清理已失去的舰娘。** 游戏确认解体或近代化改修素材消耗后，插件会移除对应舰娘的总累计记录和经验，并按剩余全部舰娘重新计算占比。进入母港时，也会根据完整名簿清理失效记录。
+- **清零只作用于当前账号。** 在弹窗中确认后，插件会清除总累计场数、逐舰累计经验，以及本趟尚未入账的经验。
+- **逐舰经验上限为 9,999,999。** 刚好达到上限时保留，超过时该舰的对应经验归零，从下一场战斗重新累计。
+
+## 本地开发
+
+可将项目放到 poi 的 `plugins-extra/node_modules/poi-plugin-sortie-exp` 目录，重启 poi 后加载。
+
+```powershell
+npm test
+npm pack --dry-run
+npm pack
+```
+
+项目采用 [MIT 许可证](LICENSE)。

package/index.js

@@ -0,0 +1,58 @@
+'use strict'
+
+const fs = require('node:fs')
+const path = require('node:path')
+const { createExperience } = require('./src/experience')
+const { createPoiAdapter, storagePath } = require('./src/poi-adapter')
+const { createPanel } = require('./src/panel')
+const { createShipProjection } = require('./src/poi-ship-data')
+const { store } = require(path.join(window.ROOT, 'views', 'create-store'))
+const { ShipAvatar, Gradient, ShipBasic, ShipName, ShipSubText, ShipLabel } =
+  require(path.join(window.ROOT, 'views', 'components', 'ship-parts', 'styled-components'))
+const { selectShipAvatarColor } = require(path.join(window.ROOT, 'views', 'utils', 'game-utils'))
+const { useTranslation } = require(path.join(window.ROOT, 'node_modules', 'react-i18next'))
+
+const listeners = new Set()
+const tracker = createExperience({
+  load: id => window.config.get(storagePath(id), null),
+  save: (id, value) => window.config.set(storagePath(id), value),
+  notify: () => {
+    for (const listener of listeners) listener()
+  },
+})
+const getGameSnapshot = createShipProjection(store.getState, () => tracker.getSnapshot().accountId, selectShipAvatarColor)
+
+function subscribe(listener) {
+  listeners.add(listener)
+  return () => listeners.delete(listener)
+}
+
+let adapter
+const onResponse = event => adapter?.onResponse(event.detail)
+const onGameStart = () => adapter?.reset()
+const onInterrupt = () => adapter?.interrupt()
+
+exports.pluginDidLoad = () => {
+  adapter = createPoiAdapter({ tracker, getState: store.getState, getShipSnapshot: getGameSnapshot })
+  window.addEventListener('game.response', onResponse)
+  window.addEventListener('game.start', onGameStart)
+  window.addEventListener('network.error', onInterrupt)
+  window.addEventListener('network.invalid.result', onInterrupt)
+}
+
+exports.pluginWillUnload = () => {
+  window.removeEventListener('game.response', onResponse)
+  window.removeEventListener('game.start', onGameStart)
+  window.removeEventListener('network.error', onInterrupt)
+  window.removeEventListener('network.invalid.result', onInterrupt)
+  adapter = undefined
+  tracker.handle({ type: 'account' })
+}
+
+exports.reactClass = createPanel(
+  require('react'), tracker, subscribe,
+  fs.readFileSync(path.join(__dirname, 'src', 'panel.css'), 'utf8'),
+  { ShipAvatar, Gradient, ShipBasic, ShipName, ShipSubText, ShipLabel, useTranslation,
+    subscribeGame: store.subscribe, getGameSnapshot },
+)
+exports.windowMode = false

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "poi-plugin-sortie-exp",
+  "version": "0.1.4",
+  "description": "Per-ship sortie and exercise EXP records for poi",
+  "license": "MIT",
+  "main": "index.js",
+  "keywords": ["poi-plugin", "kancolle", "experience"],
+  "files": ["index.js", "src/"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yamatosaki/poi-plugin-sortie-exp.git"
+  },
+  "homepage": "https://github.com/yamatosaki/poi-plugin-sortie-exp#readme",
+  "bugs": {
+    "url": "https://github.com/yamatosaki/poi-plugin-sortie-exp/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "poiPlugin": {
+    "name": "出击经验记录",
+    "description": "查看本次和上次出击、演习的逐舰经验，以及按开关统计的总累计。",
+    "icon": "fa/line-chart"
+  }
+}

package/src/experience.js

@@ -0,0 +1,308 @@
+'use strict'
+
+const emptyArchive = () => ({ last: null, tracking: false, totals: [], totalSorties: 0 })
+const copy = value => JSON.parse(JSON.stringify(value))
+const maxShipExp = 9_999_999
+const isExp = value => Number.isSafeInteger(value) && value >= 0
+const addShipExp = (previous, reward) => reward > maxShipExp - previous ? 0 : previous + reward
+const byExp = (a, b) => b.exp - a.exp || a.id - b.id
+const isShip = ship => ship && Number.isSafeInteger(ship.id) && ship.id > 0 &&
+  typeof ship.name === 'string' && ['main', 'escort'].includes(ship.group) &&
+  Number.isSafeInteger(ship.slot) && ship.slot >= 0 && ship.slot < 7
+const normalizeShipSelection = value => Array.isArray(value)
+  ? [...new Set(value.filter(id => Number.isSafeInteger(id) && id > 0))]
+  : null
+
+function makeRun(kind, event) {
+  const { deckId, map, node, roster } = event
+  if (!Number.isSafeInteger(deckId) || deckId < 1 || !Array.isArray(roster) ||
+      !roster.length || !roster.every(isShip) ||
+      new Set(roster.map(ship => ship.id)).size !== roster.length ||
+      new Set(roster.map(ship => `${ship.group}:${ship.slot}`)).size !== roster.length) return null
+  if (kind === 'sortie' && (!/^\d+-\d+$/.test(map) || !Number.isSafeInteger(node) || node < 1)) return null
+  return {
+    kind, deckId, map: kind === 'sortie' ? map : null, node, battles: 0,
+    incomplete: event.incomplete === true, expectsEscort: event.expectsEscort === true,
+    ships: roster.map(ship => ({ ...ship, exp: 0, retreated: false })),
+    phase: kind === 'practice' ? 'ready' : 'waiting', known: new Set(), pendingTotals: new Map(),
+  }
+}
+
+function snapshot(run) {
+  if (!run) return null
+  const { kind, deckId, map, battles, incomplete, ships } = run
+  return { kind, deckId, map, battles, incomplete, ships: ships.map(ship => ({
+    ...ship, exp: battles > 0 && !run.known.has(ship.id) ? null : ship.exp,
+  })) }
+}
+
+function decodeRewards(ships, group, raw) {
+  const fleet = ships.filter(ship => ship.group === group)
+  if (!fleet.length) return new Map()
+  if (!Array.isArray(raw) || raw[0] !== -1) return null
+  const bySlot = new Map(fleet.map(ship => [ship.slot, ship]))
+  if (fleet.some(ship => !ship.retreated && ship.slot + 1 >= raw.length)) return null
+
+  const rewards = new Map()
+  for (let index = 1; index < raw.length; index += 1) {
+    const ship = bySlot.get(index - 1)
+    const value = raw[index]
+    if (ship && !ship.retreated) {
+      if (!isExp(value)) return null
+      rewards.set(ship.id, value)
+    } else if (value !== -1 && value !== 0) return null
+  }
+  return rewards
+}
+
+function restoreArchive(raw) {
+  if (raw == null) return emptyArchive()
+  const validRow = ship => isShip(ship) && isExp(ship.exp)
+  const validLast = raw.last === null || (raw.last &&
+    ['sortie', 'practice'].includes(raw.last.kind) && isExp(raw.last.battles) &&
+    Array.isArray(raw.last.ships) && raw.last.ships.every(ship =>
+      isShip(ship) && (ship.exp === null || isExp(ship.exp))))
+  if (typeof raw.tracking !== 'boolean' || !isExp(raw.totalSorties) ||
+      !Array.isArray(raw.totals) || !raw.totals.every(validRow) || !validLast) {
+    throw new Error('Invalid sortie experience archive')
+  }
+  const restored = copy(raw)
+  if (restored.totalShipSelection !== undefined) {
+    restored.totalShipSelection = normalizeShipSelection(restored.totalShipSelection)
+  }
+  return restored
+}
+
+function createExperience({ load = () => null, save = () => {}, notify = () => {} } = {}) {
+  let archive = emptyArchive()
+  let accountId = null
+  let current = null
+  let readFailed = false
+  let dirty = false
+  let storageError = false
+  let view
+
+  function update() {
+    view = {
+      accountId,
+      accountReady: accountId !== null,
+      current: snapshot(current),
+      last: archive.last,
+      tracking: archive.tracking,
+      totals: archive.totals,
+      totalSorties: archive.totalSorties,
+      totalShipSelection: archive.totalShipSelection ?? null,
+      storageError,
+    }
+    notify(view)
+  }
+
+  function persist() {
+    if (!accountId || !dirty || readFailed) return
+    try {
+      save(accountId, copy(archive))
+      dirty = false
+      storageError = false
+    } catch (_) {
+      storageError = true
+    }
+  }
+
+  function changeAccount(id) {
+    if (id === accountId) return false
+    persist()
+    current = null
+    accountId = id
+    archive = emptyArchive()
+    dirty = false
+    readFailed = false
+    storageError = false
+    if (id) {
+      try {
+        archive = restoreArchive(load(id))
+        for (const ship of [...archive.totals, ...(archive.last?.ships ?? [])]) {
+          if (ship.exp <= maxShipExp) continue
+          ship.exp = 0
+          dirty = true
+        }
+        if (dirty) archive.totals.sort(byExp)
+      } catch (_) {
+        readFailed = true
+        storageError = true
+      }
+    }
+    return true
+  }
+
+  function reward(run, values) {
+    for (const ship of run.ships) {
+      const value = values.get(ship.id)
+      if (value === undefined) continue
+      run.known.add(ship.id)
+      ship.exp = addShipExp(ship.exp, value)
+      if (archive.tracking) {
+        // Stage each settlement so a later battle can count again after a reset.
+        const total = run.pendingTotals.get(ship.id) ?? archive.totals.find(row => row.id === ship.id)?.exp ?? 0
+        run.pendingTotals.set(ship.id, addShipExp(total, value))
+      }
+    }
+  }
+
+  function finish(shipDisplay) {
+    const totalById = new Map(archive.totals.map(ship => [ship.id, ship]))
+    for (const ship of current.ships) {
+      const observed = shipDisplay?.[ship.id]
+      if (observed && (ship.masterId === undefined || observed.masterId === ship.masterId)) {
+        Object.assign(ship, observed)
+      }
+      const value = current.pendingTotals.get(ship.id)
+      if (value === undefined) continue
+      const previous = totalById.get(ship.id)
+      totalById.set(ship.id, { ...previous, ...ship, exp: value, retreated: false })
+    }
+    archive = {
+      ...archive,
+      last: snapshot(current),
+      totals: [...totalById.values()].sort(byExp),
+      totalSorties: archive.totalSorties + Number(current.pendingTotals.size > 0),
+    }
+    current = null
+    dirty = true
+  }
+
+  function accept(event) {
+    const { type } = event
+    if (type === 'account') return changeAccount(/^\d+$/.test(event.accountId ?? '') && Number(event.accountId) > 0 ? String(event.accountId) : null)
+    if (!accountId) return false
+    if (event.accountId != null && String(event.accountId) !== accountId) return false
+    if (type === 'removeShips') {
+      if (!Array.isArray(event.ids) || !event.ids.length ||
+          !event.ids.every(id => Number.isSafeInteger(id) && id > 0)) return false
+      const removed = new Set(event.ids)
+      let pendingChanged = false
+      for (const id of removed) {
+        if (current?.pendingTotals.delete(id)) pendingChanged = true
+      }
+      const totals = archive.totals.filter(ship => !removed.has(ship.id))
+      const selection = archive.totalShipSelection?.filter(id => !removed.has(id))
+      if (totals.length === archive.totals.length &&
+          selection?.length === archive.totalShipSelection?.length) return pendingChanged
+      archive = { ...archive, totals, ...(selection !== undefined && { totalShipSelection: selection }) }
+      dirty = true
+      return true
+    }
+    if (type === 'sortie' || type === 'practice') {
+      current = makeRun(type, event)
+      return true
+    }
+    if (!current) return false
+    if (type === 'interrupt') {
+      if (current.kind === 'practice') current = null
+      else {
+        current.incomplete = true
+        current.phase = 'interrupted'
+      }
+      return true
+    }
+    if (type === 'port') {
+      if (current.kind === 'sortie') {
+        if (current.phase === 'ready') current.incomplete = true
+        finish(event.shipDisplay)
+      } else current = null
+      return true
+    }
+    if (type === 'practiceResult' && current.kind === 'practice') {
+      const values = decodeRewards(current.ships, 'main', event.main)
+      if (values?.size && (event.deckId == null || event.deckId === current.deckId)) {
+        current.battles = 1
+        reward(current, values)
+        finish(event.shipDisplay)
+      } else current = null
+      return true
+    }
+    if (type === 'practiceNight' && current.kind === 'practice' &&
+        event.deckId != null && event.deckId !== current.deckId) {
+      current = null
+      return true
+    }
+    if (current.kind !== 'sortie') return false
+    if (type === 'next') {
+      if (!Number.isSafeInteger(event.node) || event.node < 1 ||
+          (event.map && event.map !== current.map)) {
+        current.incomplete = true
+        current.phase = 'interrupted'
+        return true
+      }
+      if (current.node === event.node && current.phase !== 'interrupted') return false
+      if (current.phase === 'ready') current.incomplete = true
+      current.node = event.node
+      current.phase = 'waiting'
+      return true
+    }
+    if (type === 'phase' && current.phase === 'waiting') {
+      if (event.deckId != null && event.deckId !== current.deckId) {
+        current.incomplete = true
+        current.phase = 'interrupted'
+      } else current.phase = 'ready'
+      return true
+    }
+    if (type === 'retreat') {
+      const ids = new Set(event.ids ?? [])
+      const slots = event.slots ?? []
+      for (const ship of current.ships) {
+        if (ids.has(ship.id) || slots.some(slot => slot.group === ship.group && slot.slot === ship.slot)) ship.retreated = true
+      }
+      return true
+    }
+    if (type !== 'result' || current.phase !== 'ready') return false
+    current.phase = 'settled'
+    current.battles += 1
+    const hasEscort = current.ships.some(ship => ship.group === 'escort')
+    if (!hasEscort && !current.expectsEscort && Array.isArray(event.escort) && event.escort.some(value => value > 0)) {
+      current.incomplete = true
+      return true
+    }
+    for (const [group, raw] of [['main', event.main], ['escort', event.escort]]) {
+      const values = decodeRewards(current.ships, group, raw)
+      if (values) reward(current, values)
+      else current.incomplete = true
+    }
+    return true
+  }
+
+  update()
+  return {
+    handle(event) {
+      if (!event || typeof event.type !== 'string') return
+      const changed = accept(event)
+      const retrying = dirty
+      persist()
+      if (changed || retrying) update()
+    },
+    setTracking(enabled) {
+      if (!accountId || readFailed) return
+      archive = { ...archive, tracking: Boolean(enabled) }
+      dirty = true
+      persist()
+      update()
+    },
+    setTotalShipSelection(ids) {
+      if (!accountId || readFailed) return
+      archive = { ...archive, totalShipSelection: normalizeShipSelection(ids) }
+      dirty = true
+      persist()
+      update()
+    },
+    clearTotal() {
+      if (!accountId || readFailed) return
+      current?.pendingTotals.clear()
+      archive = { ...archive, totalSorties: 0, totals: [] }
+      dirty = true
+      persist()
+      update()
+    },
+    getSnapshot: () => view,
+  }
+}
+
+module.exports = { createExperience }

package/src/panel.css

@@ -0,0 +1,225 @@
+.pex {
+  --bg: #10171f;
+  --surface: #17222e;
+  --row: #192633;
+  --raised: #202f3e;
+  --line: #2b3b4b;
+  --text: #ebf2f8;
+  --muted: #a1b3c4;
+  --accent: #9bc9f6;
+  --live: #f3cc7d;
+  --done: #8bdbbf;
+  --danger-text: #ff8492;
+  box-sizing: border-box;
+  width: 100%;
+  min-width: 0;
+  max-width: 1464px;
+  margin: 0 auto;
+  padding: clamp(15px, 2.5%, 36px);
+  color: var(--text);
+  background: var(--bg);
+  font: 14px/1.5 "Segoe UI", "Microsoft YaHei UI", sans-serif;
+  container-type: inline-size;
+}
+
+.pex *, .pex *::before, .pex *::after { box-sizing: border-box; }
+body:not(.bp6-dark):not(.bp5-dark) .pex {
+  --bg: #eff5fb;
+  --surface: #fff;
+  --row: #f4f8fb;
+  --raised: #e8f1f9;
+  --line: #c9d9e7;
+  --text: #1c3143;
+  --muted: #4e6476;
+  --accent: #145f8a;
+  --live: #855a00;
+  --done: #116751;
+  --danger-text: #b42336;
+}
+.pex button { font: inherit; cursor: pointer; }
+.pex button:disabled { cursor: default; opacity: .48; }
+.pex button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.pex h2, .pex h3, .pex p { margin: 0; }
+.pex-card-heading {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px 12px;
+}
+.pex-card-controls { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
+.pex-pagination {
+  display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 8px;
+  padding: 10px 16px; border-top: 1px solid var(--line);
+}
+.pex-header { margin-bottom: 16px; }
+.pex .pex-header h2 { font-size: 30px; font-weight: 720; margin-top: 3px; line-height: 1.24; letter-spacing: -.035em; }
+.pex-kicker { color: var(--accent); font-size: 11px; font-weight: 700; letter-spacing: .17em; }
+.pex-button, .pex-switch {
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--raised);
+  color: var(--text);
+  padding: 6px 10px;
+  white-space: nowrap;
+}
+.pex .pex-button, .pex .pex-switch { font-size: 12px; }
+.pex-button:hover:enabled, .pex-switch:hover:enabled { border-color: var(--accent); }
+.pex-button.pex-clear-button {
+  background: #b42336;
+  border-color: #b42336;
+  color: #fff;
+}
+.pex-button.pex-clear-button:hover:enabled { background: #932032; border-color: #932032; }
+.pex-clear-dialog, .pex-filter-dialog {
+  width: min(360px, calc(100% - 32px));
+  padding: 20px;
+  background: var(--surface);
+  color: var(--text);
+  border: 1px solid var(--line);
+  border-radius: 10px;
+}
+.pex-clear-dialog::backdrop, .pex-filter-dialog::backdrop { background: rgb(0 0 0 / .55); }
+.pex-clear-dialog h3, .pex-filter-dialog h3 { font-size: 18px; font-weight: 680; }
+.pex .pex-clear-dialog p, .pex .pex-filter-dialog p { margin-top: 8px; color: var(--muted); }
+.pex-clear-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 18px; }
+.pex-button.pex-clear-confirm { color: var(--danger-text); }
+.pex-button.pex-clear-confirm:hover:enabled { border-color: var(--danger-text); }
+.pex-filter-dialog { width: min(960px, calc(100% - 24px)); padding: clamp(10px, 3vw, 20px); }
+.pex-filter-search {
+  display: block; width: 100%; margin-top: 14px; padding: 7px 10px;
+  border: 1px solid var(--line); border-radius: 6px;
+  background: var(--bg); color: var(--text); font: inherit;
+}
+.pex-filter-search:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+.pex-filter-tools { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
+.pex-filter-tools > span { margin-right: auto; }
+.pex-filter-list {
+  max-height: min(48vh, 420px); overflow: auto; margin-top: 10px;
+  border: 1px solid var(--line); border-radius: 6px; container-type: inline-size;
+}
+.pex-button.pex-filter-done { border-color: var(--accent); color: var(--accent); }
+.pex-tabs {
+  display: flex;
+  gap: 27px;
+  border-bottom: 1px solid var(--line);
+  margin-bottom: 18px;
+}
+.pex-tabs button {
+  position: relative; background: none; border: 0; color: var(--muted);
+  font-weight: 600; padding: 9px 2px 11px; min-width: 72px; text-align: left;
+}
+.pex-tabs button[aria-pressed="true"] { color: var(--text); }
+.pex-tabs button[aria-pressed="true"]::after {
+  content: ""; position: absolute; inset: auto 0 -1px; height: 2px; background: var(--accent); border-radius: 2px;
+}
+.pex-content { --value: var(--done); }
+.pex-content[data-tone="live"] { --value: var(--live); }
+.pex-card { min-width: 0; background: var(--surface); border: 1px solid var(--line); border-radius: 10px; overflow: hidden; }
+.pex-context {
+  display: grid; grid-template-columns: repeat(3, minmax(0,1fr)) minmax(0,1.4fr) auto;
+  align-items: center; margin-bottom: 18px; padding: 14px 16px;
+}
+.pex-context-total { grid-template-columns: repeat(2, minmax(0,1fr)) auto; gap: 12px; }
+.pex-metric { min-width: 0; padding: 0 17px; border-left: 1px solid var(--line); }
+.pex-metric:first-child { padding-left: 0; border-left: 0; }
+.pex-muted { color: var(--muted); font-size: 12px; }
+.pex-metric-value { display: block; margin-top: 3px; font-size: 19px; font-weight: 650; overflow-wrap: anywhere; }
+.pex-metric-value small { color: var(--muted); font-size: 12px; font-weight: 500; white-space: nowrap; }
+.pex-status {
+  display: inline-flex; align-items: center; gap: 7px; justify-self: end; padding: 5px 9px;
+  border: 1px solid color-mix(in srgb, var(--value) 43%, transparent);
+  background: color-mix(in srgb, var(--value) 8%, transparent); color: var(--value);
+  border-radius: 6px; font-size: 12px; font-weight: 650; white-space: nowrap;
+}
+.pex-status::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: currentColor; }
+.pex-total-controls { display: flex; align-items: center; flex-wrap: wrap; gap: 10px; }
+.pex-switch { display: inline-flex; align-items: center; gap: 8px; }
+.pex-switch::before {
+  content: ""; width: 23px; height: 12px; border-radius: 10px;
+  background: #425266; box-shadow: inset 6px 0 0 #b7c6d4; transition: box-shadow .14s;
+}
+.pex-switch[aria-checked="true"] { color: var(--done); }
+.pex-switch[aria-checked="true"]::before { background: #335a52; box-shadow: inset -6px 0 0 var(--done); }
+.pex-card-heading { align-items: baseline; padding: 15px 16px; }
+.pex .pex-card h3 { font-size: 16px; line-height: 1.5; font-weight: 680; }
+.pex-table {
+  --table-inset: 16px;
+  /* Reserve space for borders, padding, and the optional selection column. */
+  --cell-width: max(1px, calc((100cqi - 3px - var(--selection-width, 0px)) / 3 - 2 * var(--table-inset)));
+  --tile-scale: min(1, calc(var(--cell-width) / 226px));
+  --exp-size: 28.5px;
+  width: 100%;
+  border-collapse: collapse; table-layout: fixed; font-variant-numeric: tabular-nums;
+}
+.pex-table th, .pex-table td { text-align: left; padding: 8px var(--table-inset); }
+.pex-table thead th, .pex-table .pex-fleet th {
+  background: var(--raised); color: var(--muted); font-size: 12px; font-weight: 600; white-space: nowrap;
+}
+.pex-table thead th { font-size: min(12px, calc(var(--cell-width) / 5)); }
+.pex-table td {
+  height: min(65px, calc(var(--cell-width) * 58 / 226 + 7px));
+  padding-block: 3px;
+}
+.pex-table tr + tr td { box-shadow: inset 0 1px var(--line); }
+.pex-table tbody tr:nth-child(even) { background: color-mix(in srgb, var(--surface), var(--row)); }
+.pex-table tbody tr:hover { background: var(--row); }
+.pex-filter-table { --selection-width: clamp(26px, 5cqi, 40px); }
+.pex-filter-column { width: var(--selection-width); }
+.pex-filter-table thead th { position: sticky; top: 0; z-index: 1; }
+.pex-filter-table .pex-filter-checkbox { padding-inline: 0; text-align: center; }
+.pex-filter-checkbox label { display: grid; min-height: 24px; place-items: center; cursor: pointer; }
+.pex-filter-checkbox input { margin: 0; accent-color: var(--accent); cursor: pointer; }
+.pex .pex-ship-tile {
+  display: grid;
+  grid-template-columns: 70px 150px;
+  grid-template-rows: 16px 10px 16px 16px;
+  column-gap: 6px;
+  align-items: center;
+  position: relative;
+  width: 226px;
+  height: 58px;
+  zoom: var(--tile-scale);
+  padding: 0;
+  border-radius: 0;
+  box-shadow: none;
+  overflow: hidden;
+  white-space: nowrap;
+  font-size: 15px;
+  line-height: 1.4286;
+  font-variant-numeric: normal;
+}
+.pex-avatar-unavailable { opacity: 0; }
+.pex-ship-tile .ship-avatar { max-width: none; }
+.pex-exp, .pex-share {
+  font-size: min(var(--exp-size), calc(var(--cell-width) / 7));
+  font-weight: 700; line-height: 1.25; white-space: nowrap;
+}
+.pex-exp { color: var(--value); }
+.pex-share { color: #fff; }
+body:not(.bp6-dark):not(.bp5-dark) .pex-share {
+  -webkit-text-stroke: 2px var(--text);
+  paint-order: stroke fill;
+}
+.pex-exp small { font-size: .58em; font-weight: 650; }
+.pex-exp.pex-missing { color: var(--muted); }
+.pex-exp.pex-missing, .pex-exp .pex-muted { font-size: min(12px, calc(var(--cell-width) / 3.5)); }
+.pex .pex-warning { padding: 6px 0; margin-bottom: 9px; color: var(--live); font-size: 12px; }
+.pex-empty { display: grid; gap: 4px; padding: 24px 16px; text-align: center; }
+.pex-empty span { color: var(--muted); font-size: 12px; }
+@container (max-width: 880px) {
+  .pex-table { --table-inset: 8px; --exp-size: 25.5px; }
+}
+@container (max-width: 690px) {
+  .pex-metric { padding-inline: 9px; }
+}
+@container (max-width: 560px) {
+  .pex-context { grid-template-columns: repeat(2, minmax(0,1fr)); gap: 10px 0; }
+  .pex-context:not(.pex-context-total) .pex-metric:nth-child(3) { padding-left: 0; border-left: 0; }
+  .pex-context .pex-status, .pex-total-controls { justify-self: start; grid-column: 1 / -1; }
+}
+@container (max-width: 430px) {
+  .pex .pex-header h2 { font-size: 23px; }
+  .pex-context { padding-inline: 10px; }
+  .pex-table { --table-inset: 4px; --exp-size: 22.5px; }
+}

package/src/panel.js

@@ -0,0 +1,275 @@
+'use strict'
+
+const { poiPlugin } = require('../package.json')
+const number = new Intl.NumberFormat('zh-CN')
+const percent = new Intl.NumberFormat('zh-CN', { style: 'percent', minimumFractionDigits: 1, maximumFractionDigits: 1 })
+const noShips = Object.freeze({})
+const noGameSnapshot = () => noShips
+const noGameSubscription = () => () => {}
+const knownExp = value => Number.isSafeInteger(value) && value >= 0
+const positive = value => Number.isSafeInteger(value) && value > 0
+const shipsPerPage = 10
+
+function matchingGameShip(ship, gameShips) {
+  const candidate = gameShips[ship.id]
+  return candidate && (!positive(ship.masterId) || ship.masterId === candidate.masterId) ? candidate : undefined
+}
+
+function displayName(ship, live, t) {
+  return t(`resources:${live?.name ?? ship.name}`, { keySeparator: 'chiba' })
+}
+
+function sumExperience(ships) {
+  return ships.length ? ships.reduce((sum, ship) => knownExp(ship.exp) ? (sum ?? 0) + ship.exp : sum, null) : 0
+}
+
+function createPanel(React, tracker, subscribe, css, {
+  ShipAvatar, Gradient, ShipBasic, ShipName, ShipSubText, ShipLabel, useTranslation,
+  subscribeGame = noGameSubscription, getGameSnapshot = noGameSnapshot,
+}) {
+  const h = React.createElement
+  const button = (label, onClick, options = {}) => h('button', { type: 'button', onClick, ...options }, label)
+  const expText = value => knownExp(value)
+    ? [`${value > 0 ? '+' : ''}${number.format(value)}`, h('small', { key: 'unit' }, ' EXP')]
+    : '未捕获'
+
+  function ShipTile({ ship, live, name, t }) {
+    const masterId = live?.masterId ?? ship.masterId
+    const isDamaged = Boolean(live?.isDamaged ?? ship.isDamaged)
+    const level = live?.level ?? ship.level
+    const kind = live?.kind ?? ship.kind
+    const nextExp = live?.nextExp ?? ship.nextExp
+    const [failed, setFailed] = React.useState(null)
+    const artKey = `${masterId}:${isDamaged}`
+    return h('div', {
+      className: 'bp6-card pex-ship-tile',
+      onErrorCapture: () => setFailed(artKey),
+      onLoadCapture: () => setFailed(null),
+    },
+    positive(masterId) ? h(ShipAvatar, {
+      className: `pex-native-avatar${failed === artKey ? ' pex-avatar-unavailable' : ''}`,
+      mstId: masterId, isDamaged, height: 58, useFixedWidth: false, useDefaultBG: false,
+    }) : null,
+    h(Gradient, { color: live?.avatarColor ?? ship.avatarColor }),
+    h(ShipBasic, { avatar: true, className: 'ship-basic' },
+      h('span', { className: 'ship-lv' }, 'Lv. ', positive(level) ? level : '??'),
+      h(ShipLabel, { className: 'ship-type' }, kind ? t(`resources:${kind}`) : '??')),
+    h(ShipName, { avatar: true, className: 'ship-name', title: name }, name),
+    h(ShipSubText, { avatar: true, className: 'ship-exp' }, 'Next. ', knownExp(nextExp) ? nextExp : '—'))
+  }
+
+  function ShipTable({ ships, fleet, total, sum, gameShips, selection }) {
+    const { t } = useTranslation(['main', 'resources'])
+    return h('table', {
+      className: selection ? 'pex-table pex-filter-table' : 'pex-table',
+      'aria-label': selection ? '已统计舰娘' : '逐舰获得经验',
+    },
+      selection ? h('colgroup', null, h('col', { className: 'pex-filter-column' }), h('col', { span: 3 })) : null,
+      h('thead', null, h('tr', null,
+        selection ? h('th', { scope: 'col', className: 'pex-filter-checkbox' }, '显示') : null,
+        h('th', { scope: 'col' }, '舰娘'),
+        h('th', { scope: 'col' }, total ? '总累计经验' : '获得经验'),
+        h('th', { scope: 'col' }, '占比'))),
+      h('tbody', null, ships.flatMap((ship, index) => {
+        const live = matchingGameShip(ship, gameShips)
+        const name = displayName(ship, live, t)
+        const share = knownExp(ship.exp) ? percent.format(sum ? ship.exp / sum : 0) : '—'
+        const row = h('tr', { key: ship.id, 'data-ship': ship.id },
+          selection ? h('td', { className: 'pex-filter-checkbox' },
+            h('label', null, h('input', {
+              type: 'checkbox', 'aria-label': `显示 ${name}`, checked: selection.ids.has(ship.id),
+              onChange: event => selection.toggle(ship.id, event.target.checked),
+            }))) : null,
+          h('td', null, h(ShipTile, { ship, live, name, t })),
+          h('td', { className: `pex-exp${knownExp(ship.exp) ? '' : ' pex-missing'}` }, expText(ship.exp),
+            ship.retreated ? h('div', { className: 'pex-muted' }, '已退避') : null),
+          h('td', { className: 'pex-share' }, share))
+        if (fleet && (index === 0 || ship.group !== ships[index - 1].group)) {
+          return [h('tr', { key: `fleet-${ship.id}`, className: 'pex-fleet' },
+            h('th', { colSpan: 3 }, ship.group === 'main' ? '主力舰队' : '护卫舰队')), row]
+        }
+        return [row]
+      })))
+  }
+
+  function PaginatedShipTable({ ships, sum, gameShips }) {
+    const [pageIndex, setPageIndex] = React.useState(0)
+    const pageCount = Math.ceil(ships.length / shipsPerPage)
+    const page = Math.min(pageIndex, pageCount - 1)
+    const first = page * shipsPerPage
+    React.useEffect(() => {
+      setPageIndex(index => Math.min(index, pageCount - 1))
+    }, [pageCount])
+    return h(React.Fragment, null,
+      h(ShipTable, { ships: ships.slice(first, first + shipsPerPage), total: true, sum, gameShips }),
+      pageCount > 1 ? h('nav', { className: 'pex-pagination', 'aria-label': '总累计舰娘分页' },
+        button('上一页', () => setPageIndex(page - 1), { className: 'pex-button', disabled: page === 0 }),
+        h('span', { className: 'pex-muted', 'aria-live': 'polite' }, `第 ${page + 1} / ${pageCount} 页`),
+        button('下一页', () => setPageIndex(page + 1), { className: 'pex-button', disabled: page === pageCount - 1 }))
+        : null)
+  }
+
+  function metric(label, value, unit) {
+    return h('div', { className: 'pex-metric' },
+      h('div', { className: 'pex-muted' }, label),
+      h('strong', { className: 'pex-metric-value' }, value, unit ? h('small', null, unit) : null))
+  }
+
+  function details(ships, { total = false, sum, gameShips, totalCount = ships.length, customize, pageKey }) {
+    const count = ships.length === totalCount ? `${number.format(totalCount)} 艘舰船`
+      : `显示 ${number.format(ships.length)} / ${number.format(totalCount)} 艘`
+    const empty = totalCount ? '当前未显示任何舰娘' : total ? '暂无累计经验' : '暂无舰船记录'
+    const table = total ? h(PaginatedShipTable, { key: pageKey, ships, sum, gameShips })
+      : h(ShipTable, { ships, fleet: ships.some(ship => ship.group === 'escort'), sum, gameShips })
+    return h('section', { className: 'pex-card' },
+      h('header', { className: 'pex-card-heading' }, h('h3', null, total ? '逐舰总累计' : '舰队明细'),
+        h('div', { className: 'pex-card-controls' }, h('span', { className: 'pex-muted' }, count), customize)),
+      ships.length ? table : h('div', { className: 'pex-empty' }, h('strong', null, empty)))
+  }
+
+  function runView(view, gameShips) {
+    const run = view.current ?? view.last
+    if (!run) return h('div', { className: 'pex-card pex-empty' },
+      h('strong', null, view.accountReady ? '暂无出击记录' : '等待游戏账号'),
+      h('span', null, view.accountReady ? '普通出击或演习结算后，这里会显示逐舰经验。' : '登录游戏并进入母港即可开始记录。'))
+    const live = Boolean(view.current)
+    const practice = run.kind === 'practice'
+    const status = practice ? (live ? '演习中' : '演习已结算') : (live ? '出击中' : '已返港')
+    const sum = sumExperience(run.ships)
+    return h('div', null,
+      h('div', { className: 'pex-card pex-context', 'aria-live': 'polite' },
+        metric(practice ? '出击类型' : '海域', practice ? '演习' : run.map),
+        metric('出击舰队', `第 ${run.deckId} 舰队`),
+        metric('已结算', number.format(run.battles), ' 场战斗'),
+        metric(practice ? '本次演习合计' : '本次舰队合计', sum === null ? '—' : expText(sum)),
+        h('span', { className: 'pex-status' }, status)),
+      run.incomplete ? h('p', { className: 'pex-warning' }, '数据不完整，仅显示已确认经验。') : null,
+      details(run.ships, { sum, gameShips }))
+  }
+
+  function ClearTotalButton({ accountId, disabled }) {
+    const dialog = React.useRef(null)
+    const titleId = React.useId()
+    const descriptionId = React.useId()
+    const close = () => dialog.current.close()
+    const confirm = () => {
+      close()
+      if (tracker.getSnapshot().accountId === accountId) tracker.clearTotal()
+    }
+
+    return h(React.Fragment, null,
+      button('清零', () => dialog.current.showModal(), {
+        className: 'pex-button pex-clear-button', 'aria-haspopup': 'dialog', disabled,
+      }),
+      h('dialog', {
+        ref: dialog, className: 'pex-clear-dialog', 'aria-labelledby': titleId, 'aria-describedby': descriptionId,
+      },
+      h('h3', { id: titleId }, '是否清零总累计记录？'),
+      h('p', { id: descriptionId }, '将清除当前账号的累计出击场数和经验。'),
+      h('div', { className: 'pex-clear-actions' },
+        button('取消', close, { className: 'pex-button' }),
+        button('确认', confirm, { className: 'pex-button pex-clear-confirm' }))))
+  }
+
+  function TotalShipFilter({ view, sum, gameShips }) {
+    const { t } = useTranslation(['main', 'resources'])
+    const dialog = React.useRef(null)
+    const titleId = React.useId()
+    const [query, setQuery] = React.useState('')
+    const [isOpen, setIsOpen] = React.useState(false)
+    const [draft, setDraft] = React.useState(null)
+    const ships = view.totals
+    const selected = new Set(draft ?? ships.map(ship => ship.id))
+    const shown = ships.filter(ship => selected.has(ship.id)).length
+    const search = query.trim().toLocaleLowerCase()
+    const matches = search ? ships.filter(ship => {
+      const live = matchingGameShip(ship, gameShips)
+      return displayName(ship, live, t).toLocaleLowerCase().includes(search)
+    }) : ships
+    const toggle = (id, checked) => {
+      setDraft(previous => {
+        const next = new Set(previous ?? ships.map(ship => ship.id))
+        if (checked) next.add(id)
+        else next.delete(id)
+        return ships.every(ship => next.has(ship.id)) ? null : [...next]
+      })
+    }
+    const open = () => {
+      setQuery('')
+      setDraft(view.totalShipSelection)
+      dialog.current.showModal()
+      setIsOpen(true)
+    }
+    const close = () => dialog.current.close()
+    const confirm = () => {
+      const current = tracker.getSnapshot()
+      if (current.accountId === view.accountId && draft !== current.totalShipSelection) {
+        const available = new Set(current.totals.map(ship => ship.id))
+        tracker.setTotalShipSelection(draft?.filter(id => available.has(id)) ?? null)
+      }
+      close()
+    }
+
+    return h(React.Fragment, null,
+      button('自定义显示', open, { className: 'pex-button', 'aria-haspopup': 'dialog', disabled: !view.accountReady }),
+      h('dialog', {
+        ref: dialog, className: 'pex-filter-dialog', 'aria-labelledby': titleId,
+        onClose: event => setIsOpen(event.currentTarget.open),
+      },
+        h('h3', { id: titleId }, '自定义显示舰娘'),
+        h('p', null, '点击「完成」后应用显示设置。隐藏的舰娘仍会累计经验。'),
+        h('input', {
+          className: 'pex-filter-search', type: 'search', value: query, placeholder: '搜索舰娘',
+          'aria-label': '搜索舰娘', onChange: event => setQuery(event.target.value),
+        }),
+        h('div', { className: 'pex-filter-tools' },
+          h('span', { className: 'pex-muted', 'aria-live': 'polite' }, `已选 ${shown} / ${ships.length} 艘`),
+          button('显示全部', () => setDraft(null), { className: 'pex-button' }),
+          button('全部隐藏', () => setDraft([]), { className: 'pex-button', disabled: !ships.length })),
+        isOpen && (matches.length ? h('div', { className: 'pex-filter-list' },
+          h(ShipTable, { ships: matches, total: true, sum, gameShips, selection: { ids: selected, toggle } }))
+          : h('p', null, ships.length ? '没有匹配的舰娘' : '暂无已统计的舰娘')),
+        h('div', { className: 'pex-clear-actions' },
+          button('取消', close, { className: 'pex-button' }),
+          button('完成', confirm, { className: 'pex-button pex-filter-done' }))))
+  }
+
+  function totalView(view, gameShips) {
+    const disabled = !view.accountReady
+    const sum = sumExperience(view.totals)
+    const selection = view.totalShipSelection === null ? null : new Set(view.totalShipSelection)
+    const ships = selection === null ? view.totals : view.totals.filter(ship => selection.has(ship.id))
+    return h('div', null,
+      h('div', { className: 'pex-card pex-context pex-context-total' },
+        metric('累计记录', `总累计 ${number.format(view.totalSorties)} 场`, ' 出击'),
+        metric('全部舰船合计', expText(sum)),
+        h('div', { className: 'pex-total-controls' },
+          button(view.tracking ? '累计开启' : '累计关闭', () => tracker.setTracking(!view.tracking), {
+            className: 'pex-switch', role: 'switch', 'aria-label': '累计开关', 'aria-checked': view.tracking, disabled,
+          }),
+          h(ClearTotalButton, { key: view.accountId, accountId: view.accountId, disabled }))),
+      details(ships, {
+        total: true, sum, gameShips, totalCount: view.totals.length,
+        pageKey: `${view.accountId}:${JSON.stringify(view.totalShipSelection)}`,
+        customize: h(TotalShipFilter, { key: view.accountId, view, sum, gameShips }),
+      }))
+  }
+
+  return function ExperiencePanel() {
+    const view = React.useSyncExternalStore(subscribe, tracker.getSnapshot, tracker.getSnapshot)
+    const gameShips = React.useSyncExternalStore(subscribeGame, getGameSnapshot, getGameSnapshot) ?? noShips
+    const [tab, setTab] = React.useState('run')
+    return h('section', { className: 'pex', 'aria-label': poiPlugin.name },
+      h('style', null, css),
+      h('header', { className: 'pex-header' },
+        h('div', { className: 'pex-kicker' }, 'SORTIE EXPERIENCE'), h('h2', null, poiPlugin.name)),
+      h('div', { className: 'pex-tabs', 'aria-label': '经验统计视图' },
+        button(view.current ? '本次出击' : '上次出击', () => setTab('run'), { 'aria-pressed': tab === 'run' }),
+        button('总累计', () => setTab('total'), { 'aria-pressed': tab === 'total' })),
+      h('div', { className: 'pex-content', 'data-tone': tab === 'run' && view.current ? 'live' : 'done' },
+        view.storageError ? h('p', { className: 'pex-warning', role: 'status' }, '本地统计暂时无法读取或保存。') : null,
+        tab === 'run' ? runView(view, gameShips) : totalView(view, gameShips)))
+  }
+}
+
+module.exports = { createPanel }

package/src/poi-adapter.js

@@ -0,0 +1,163 @@
+'use strict'
+
+const { createShipProjection, positive, readShipDisplay } = require('./poi-ship-data')
+
+const prefix = '/kcsapi/'
+const phases = new Set([
+  ...['battle', 'airbattle', 'ld_airbattle', 'ld_shooting'].map(name => `api_req_sortie/${name}`),
+  ...[
+    'battle', 'battle_water', 'airbattle', 'ld_airbattle', 'ld_shooting', 'ec_battle',
+    'each_battle', 'each_battle_water', 'midnight_battle', 'sp_midnight',
+    'ec_midnight_battle', 'ec_night_to_day',
+  ].map(name => `api_req_combined_battle/${name}`),
+  'api_req_battle_midnight/battle', 'api_req_battle_midnight/sp_midnight',
+])
+
+function getMap(body, post) {
+  const area = positive(body.api_maparea_id ?? post.api_maparea_id)
+  const map = positive(body.api_mapinfo_no ?? post.api_mapinfo_no)
+  return area && map ? `${area}-${map}` : undefined
+}
+
+function practiceDeck(body, post) {
+  const returned = positive(body.api_deck_id)
+  const requested = positive(post.api_deck_id)
+  return returned && requested && returned !== requested ? 0 : returned ?? requested
+}
+
+function deckRoster(state, deckId, group) {
+  const fleets = Object.values(state?.info?.fleets ?? {})
+  const fleet = fleets.find(row => positive(row?.api_id) === deckId)
+  if (!Array.isArray(fleet?.api_ship)) return []
+  return fleet.api_ship.flatMap((rawId, slot) => {
+    const id = positive(rawId)
+    if (id === undefined) return []
+    return [{ id, slot, group, name: '未知舰船', ...readShipDisplay(state, state.info.ships?.[id]) }]
+  })
+}
+
+function createPoiAdapter({ tracker, getState, getShipSnapshot }) {
+  let memberId
+  let awaitingPortFor
+  let combined = false
+  const seen = new Set()
+  const emit = (type, data) => tracker.handle({ type, ...data })
+  const shipSnapshot = getShipSnapshot ?? createShipProjection(getState, () => memberId)
+
+  function account(id) {
+    if (id !== memberId) combined = false
+    memberId = id
+    emit('account', { accountId: id })
+  }
+
+  function awaitPort(id) {
+    awaitingPortFor = id
+    account(undefined)
+  }
+
+  function reconcileShips(ships) {
+    if (!Array.isArray(ships)) return
+    const owned = new Set(ships.map(ship => positive(ship?.api_id)))
+    if (owned.has(undefined) || owned.size !== ships.length) return
+    const view = tracker.getSnapshot()
+    const recorded = new Set([...view.totals.map(ship => ship.id), ...(view.totalShipSelection ?? [])])
+    emit('removeShips', { accountId: memberId, ids: [...recorded].filter(id => !owned.has(id)) })
+  }
+
+  return {
+    onResponse(detail) {
+      if (!detail?.path?.startsWith(prefix)) return
+      const path = detail.path.slice(prefix.length)
+      const envelope = detail.body ?? {}
+      if (envelope.api_result != null && Number(envelope.api_result) !== 1) return
+      const body = envelope.api_data ?? envelope
+      const post = detail.postBody ?? {}
+
+      // The host time identifies re-delivery of the same response. Distinct
+      // results still need an active phase, even when the time differs.
+      if (Number.isFinite(detail.time)) {
+        const key = `${path}:${detail.time}`
+        if (seen.has(key)) return
+        seen.add(key)
+        if (seen.size > 96) seen.delete(seen.values().next().value)
+      }
+
+      if (path === 'api_start2/getData') {
+        awaitPort()
+        return
+      }
+      if (path === 'api_get_member/require_info' || path === 'api_get_member/basic') {
+        const id = positive(body.api_basic?.api_member_id ?? body.api_member_id)
+        if (id && String(id) !== memberId) awaitPort(String(id))
+        return
+      }
+      if (path === 'api_port/port') {
+        const id = positive(body.api_basic?.api_member_id)
+        if (!id) return
+        const confirmed = String(id)
+        if (awaitingPortFor && awaitingPortFor !== confirmed) return
+        awaitingPortFor = undefined
+        account(confirmed)
+        emit('port', { accountId: memberId, shipDisplay: shipSnapshot() })
+        reconcileShips(body.api_ship)
+        return
+      }
+      if (!memberId) return
+
+      // Poi updates Redux before emitting game.response, including for account changes.
+      const state = getState()
+      const hostMemberId = positive(state?.info?.basic?.api_member_id)
+      if (hostMemberId && String(hostMemberId) !== memberId) {
+        awaitPort(String(hostMemberId))
+        return
+      }
+      if (path === 'api_req_kousyou/destroyship' || path === 'api_req_kaisou/powerup') {
+        const modernization = path === 'api_req_kaisou/powerup'
+        const target = positive(body.api_ship?.api_id)
+        if (modernization && (!target || (post.api_id != null && positive(post.api_id) !== target))) return
+        const rawIds = modernization ? post.api_id_items : post.api_ship_id
+        if (typeof rawIds !== 'string' && typeof rawIds !== 'number') return
+        const ids = String(rawIds).split(',').map(positive)
+        if (ids.every(id => id !== undefined) && (!modernization || !ids.includes(target))) {
+          emit('removeShips', { accountId: memberId, ids })
+        }
+        return
+      }
+      if (path === 'api_req_map/start' || path === 'api_req_practice/battle') {
+        const isPractice = path === 'api_req_practice/battle'
+        const deckId = isPractice ? practiceDeck(body, post) : positive(post.api_deck_id ?? body.api_deck_id)
+        combined = !isPractice && deckId === 1 && positive(state?.sortie?.combinedFlag) !== undefined
+        const main = deckRoster(state, deckId, 'main')
+        const escort = combined ? deckRoster(state, 2, 'escort') : []
+        emit(isPractice ? 'practice' : 'sortie', {
+          deckId, map: getMap(body, post), node: positive(body.api_no),
+          roster: main.length ? [...main, ...escort] : [],
+          expectsEscort: combined, incomplete: combined && !escort.length,
+        })
+      } else if (path === 'api_req_map/next') {
+        emit('next', { map: getMap(body, post), node: positive(body.api_no) })
+      } else if (phases.has(path)) {
+        const deckId = path.startsWith('api_req_sortie/') ? positive(post.api_deck_id ?? body.api_deck_id) : undefined
+        emit('phase', { deckId })
+      } else if (path === 'api_req_practice/midnight_battle') {
+        emit('practiceNight', { deckId: practiceDeck(body, post) })
+      } else if (path === 'api_req_practice/battle_result') {
+        emit('practiceResult', { deckId: practiceDeck(body, post), main: body.api_get_ship_exp, shipDisplay: shipSnapshot() })
+      } else if (path === 'api_req_sortie/battleresult' || path === 'api_req_combined_battle/battleresult') {
+        emit('result', { main: body.api_get_ship_exp, escort: body.api_get_ship_exp_combined })
+      } else if (path === 'api_req_sortie/goback_port' || path === 'api_req_combined_battle/goback_port') {
+        const positions = state?.sortie?.escapedPos ?? []
+        const slots = positions.filter(slot => Number.isSafeInteger(slot) && slot >= 0).map(slot =>
+          combined && slot >= 6 ? { group: 'escort', slot: slot - 6 } : { group: 'main', slot })
+        emit('retreat', { slots })
+      }
+    },
+    reset: () => awaitPort(),
+    interrupt: () => emit('interrupt'),
+  }
+}
+
+// poi writes dotted config paths with lodash, where numeric keys imply arrays.
+const storagePath = id => `plugin.poi-plugin-sortie-exp.experience.v1.member_${id}`
+
+module.exports = { createPoiAdapter, storagePath }

package/src/poi-ship-data.js

@@ -0,0 +1,67 @@
+'use strict'
+
+const noShips = Object.freeze({})
+const noTagColors = Object.freeze([])
+
+function positive(value) {
+  if (typeof value !== 'number' && typeof value !== 'string') return undefined
+  const number = Number(value)
+  return Number.isSafeInteger(number) && number > 0 ? number : undefined
+}
+
+function readShipDisplay(state, owned) {
+  const masterId = positive(owned?.api_ship_id)
+  const level = positive(owned?.api_lv)
+  const nextExp = owned?.api_exp?.[1]
+  const master = state?.const?.$ships?.[masterId]
+  const kind = state?.const?.$shipTypes?.[master?.api_stype]?.api_name
+  const maxHp = positive(owned?.api_maxhp)
+  const nowHp = owned?.api_nowhp == null ? NaN : Number(owned.api_nowhp)
+  return {
+    ...(masterId !== undefined && { masterId }),
+    ...(level !== undefined && { level }),
+    ...(Number.isSafeInteger(nextExp) && nextExp >= 0 && { nextExp }),
+    ...(typeof master?.api_name === 'string' && master.api_name && { name: master.api_name }),
+    ...(typeof kind === 'string' && kind && { kind }),
+    ...(maxHp !== undefined && Number.isFinite(nowHp) && nowHp >= 0 && { isDamaged: nowHp * 2 <= maxHp }),
+  }
+}
+
+function createShipProjection(getState, getAccountId, selectAvatarColor) {
+  let previousAccount
+  let previousOwned
+  let previousMaster
+  let previousAvatarType
+  let previousTagColors
+  let projection = noShips
+
+  // useSyncExternalStore needs the same reference until the relevant data changes.
+  return () => {
+    const state = getState()
+    const owner = positive(state?.info?.basic?.api_member_id)
+    const account = getAccountId()
+    const owned = state?.info?.ships
+    const master = state?.const
+    if (!owner || String(owner) !== account || !owned) return noShips
+    const avatarType = state.config?.poi?.appearance?.avatarType ?? ''
+    const tagColors = state.fcd?.shiptag?.color ?? noTagColors
+    if (account === previousAccount && owned === previousOwned && master === previousMaster &&
+        avatarType === previousAvatarType && tagColors === previousTagColors) return projection
+    previousAccount = account
+    previousOwned = owned
+    previousMaster = master
+    previousAvatarType = avatarType
+    previousTagColors = tagColors
+    projection = Object.fromEntries(Object.entries(owned).flatMap(([id, ship]) => {
+      const ownedId = positive(ship?.api_id ?? id)
+      if (!ship || ownedId === undefined) return []
+      const display = readShipDisplay(state, ship)
+      const masterShip = master?.$ships?.[display.masterId]
+      if (selectAvatarColor && masterShip) display.avatarColor = selectAvatarColor(ship, masterShip, tagColors, avatarType)
+      return [[ownedId, display]]
+    }))
+    return projection
+  }
+}
+
+module.exports = { createShipProjection, positive, readShipDisplay }