poi-plugin-kai-planner 1.0.18 → 1.0.20

package/README.md

@@ -6,10 +6,10 @@
 
 - 在`每日改修`页面查看当天可改修装备、基础消耗、秘书舰要求与可进化状态。
 - 在`每日改修`页面把常看的装备标记为收藏，收藏项会优先排序并长期保存在本地。
-- 在`改修心愿清单`页面创建、编辑、刷新和追踪个人改修计划，查看实时完成进度与资源缺口。
+- 在`改修规划`页面创建、编辑、刷新和追踪个人改修计划，查看实时完成进度与资源缺口。
 - 在`装备获取规划`页面管理想提前准备的装备，查看它们与未完成改修计划之间的待消耗关联。
-- 在`Debug`页面查看插件运行时数据与调试信息。
-- 静态数据支持远端版本更新；插件默认每 2 天自动检查一次，也可以手动点击“检查更新”。
+- 按需开启 `poiPlugin.enableDebug` 后，在 `Debug` 页面查看运行时数据；默认隐藏。
+- 静态数据在页面挂载时检查：成功后间隔 2 个 UTC 自然日，失败后间隔 15 分钟；可手动“检查更新”。下载有超时和有限重试，成功后页面自动刷新并保留编辑草稿。
 - 改修规划的待消耗道具会区分 useitem 与 `api_material` 资源类材料，例如高速建造材、高速修复材、开发资材、改修资材。
 
 ## 技术文档

package/index.js

@@ -7,6 +7,8 @@ const { WindowEnv } = require("views/components/etc/window-env");
 const { KaiPlannerApp } = require("./src/app/KaiPlannerApp");
 const { subscribeMaterialResourceUpdates } = require("./src/services/player/materialResourceCounts");
 
+const { enableDataUpdates, disposeDataUpdates } = require("./src/services/static/version/dataUpdateManager");
+
 let unsubscribeMaterialResourceUpdates = null;
 
 function KaiPlannerAppWithEnv() {
@@ -21,27 +23,26 @@ function KaiPlannerAppWithEnv() {
   });
 }
 
-module.exports = {
-  reactClass: KaiPlannerAppWithEnv,
-  windowMode: true,
-
-  pluginDidLoad() {
-    if (!unsubscribeMaterialResourceUpdates) {
-      unsubscribeMaterialResourceUpdates = subscribeMaterialResourceUpdates(
-        typeof window !== "undefined" ? window : null
-      );
-    }
-    if (typeof window !== "undefined" && window.log) {
-      window.log("[kai-planner] loaded");
-    }
-  },
-  pluginWillUnload() {
-    if (unsubscribeMaterialResourceUpdates) {
-      unsubscribeMaterialResourceUpdates();
-      unsubscribeMaterialResourceUpdates = null;
-    }
-    if (typeof window !== "undefined" && window.log) {
-      window.log("[kai-planner] unloaded");
-    }
-  },
+exports.reactClass = KaiPlannerAppWithEnv;
+exports.windowMode = true;
+exports.pluginDidLoad = function pluginDidLoad() {
+  enableDataUpdates();
+  if (!unsubscribeMaterialResourceUpdates) {
+    unsubscribeMaterialResourceUpdates = subscribeMaterialResourceUpdates(
+      typeof window !== "undefined" ? window : null
+    );
+  }
+  if (typeof window !== "undefined" && window.log) {
+    window.log("[kai-planner] loaded");
+  }
+};
+exports.pluginWillUnload = function pluginWillUnload() {
+  disposeDataUpdates();
+  if (unsubscribeMaterialResourceUpdates) {
+    unsubscribeMaterialResourceUpdates();
+    unsubscribeMaterialResourceUpdates = null;
+  }
+  if (typeof window !== "undefined" && window.log) {
+    window.log("[kai-planner] unloaded");
+  }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-kai-planner",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "main": "index.js",
   "author": "aulu",
   "contributors": ["aulu"],

package/src/app/KaiPlannerApp.js

@@ -1,7 +1,8 @@
 const React = require("react");
 const { DailyTabV2 } = require("./tabs/daily/DailyTabV2");
-const { checkAndUpdateData } = require("../services/static/version/dataUpdateManager");
+const { checkAndUpdateData, getUpdateState, subscribeDataUpdates } = require("../services/static/version/dataUpdateManager");
 const { readMeta } = require("../services/static/version/versionStore");
+const { ensurePluginWindowVisible } = require("../core/poi/ensurePluginWindowVisible");
 const {
   DEFAULT_THEME_TOKENS,
   readPoiTheme,
@@ -66,7 +67,7 @@ function getUpdateFailureTip(result) {
     data_source_not_configured: "未配置远端数据源",
   };
   const label = labels[reason] || "检查失败";
-  return result && result.error ? `${label}：${result.error}` : label;
+  return reason === "update_cancelled" ? "更新已取消。" : `${label}，可点击检查更新重试。`;
 }
 
 class KaiPlannerApp extends React.Component {
@@ -77,7 +78,10 @@ class KaiPlannerApp extends React.Component {
       wishlistLoadError: null,
       acquisitionLoadError: null,
       debugLoadError: null,
-      checkingUpdate: false,
+      checkingUpdate: getUpdateState().checking,
+      dataRevision: getUpdateState().dataRevision,
+      updateDiagnostic: "",
+      copyTip: "",
       lastUpdateAtText: "-",
       updateTip: "",
       materialResourceVersion: 0,
@@ -89,12 +93,17 @@ class KaiPlannerApp extends React.Component {
     this._unsubscribeTheme = null;
     this._unsubscribeMaterialResources = null;
     this._themeWarmupTimer = null;
+    this._cancelWindowVisibility = null;
     this.enableDebug = readEnableDebugFlag();
     this.handleCheckUpdate = this.handleCheckUpdate.bind(this);
     this.syncTheme = this.syncTheme.bind(this);
   }
 
   componentDidMount() {
+    this._mounted = true;
+    this._unsubscribeDataUpdates = subscribeDataUpdates(() => this.syncDataUpdateState());
+    this.syncDataUpdateState();
+    this._cancelWindowVisibility = ensurePluginWindowVisible(this.props.envWindow, this.props.envCtx);
     this.syncTheme();
     this._unsubscribeTheme = subscribePoiTheme(this.props.envWindow, (hostTheme) => {
       this.setState({ themeTokens: buildPlannerThemeTokens(hostTheme) });
@@ -109,6 +118,10 @@ class KaiPlannerApp extends React.Component {
   }
 
   componentWillUnmount() {
+    this._mounted = false;
+    if (this._unsubscribeDataUpdates) this._unsubscribeDataUpdates();
+    if (this._cancelWindowVisibility) this._cancelWindowVisibility();
+    this._cancelWindowVisibility = null;
     if (typeof this._unsubscribeTheme === "function") this._unsubscribeTheme();
     if (typeof this._unsubscribeMaterialResources === "function") this._unsubscribeMaterialResources();
     if (this._themeWarmupTimer != null) {
@@ -133,21 +146,44 @@ class KaiPlannerApp extends React.Component {
     } catch {}
   }
 
+  syncDataUpdateState() {
+    if (!this._mounted) return;
+    const update = getUpdateState();
+    const meta = readMeta();
+    const result = update.result;
+    const failure = result && !result.ok ? result : ((!result || result.skipped) && meta.lastCheckOk === false ? {
+      reason: meta.lastCheckReason, error: meta.lastCheckError, diagnostic: meta.lastCheckDiagnostic,
+    } : null);
+    this.setState({
+      checkingUpdate: update.checking,
+      dataRevision: update.dataRevision,
+      updateDiagnostic: failure ? JSON.stringify({ checkedAt: meta.lastCheckAt, reason: failure.reason, diagnostic: failure.diagnostic, error: failure.error }, null, 2) : "",
+    });
+    this.syncUpdateMeta();
+  }
+
+  async copyUpdateDiagnostic() {
+    try {
+      await require("views/services/clipboard").writeClipboardText(this.state.updateDiagnostic);
+      if (this._mounted) this.setState({ copyTip: "已复制" });
+    } catch {
+      if (this._mounted) this.setState({ copyTip: "复制失败，请选中下方详情手动复制。" });
+    }
+  }
+
   async handleCheckUpdate(force) {
-    if (this.state.checkingUpdate) return;
-    this.setState({ checkingUpdate: true, updateTip: force ? "正在检查..." : "" });
+    if (!this._mounted) return;
+    this.setState({ updateTip: force ? "正在检查..." : "", copyTip: "" });
     try {
       const result = await checkAndUpdateData({ force: !!force });
-      this.syncUpdateMeta();
+      if (!this._mounted) return;
       if (force) {
-        if (result && result.ok && result.updated) this.setState({ updateTip: `已更新到数据版本 ${result.remoteVersion}` });
-        else if (result && result.ok && !result.updated) this.setState({ updateTip: "当前已是最新数据。" });
+        if (result.ok && result.updated) this.setState({ updateTip: `已更新到数据版本 ${result.remoteVersion}` });
+        else if (result.ok) this.setState({ updateTip: "当前已是最新数据。" });
         else this.setState({ updateTip: getUpdateFailureTip(result) });
       }
     } catch (error) {
-      if (force) this.setState({ updateTip: `检查失败：${String(error && (error.stack || error))}` });
-    } finally {
-      this.setState({ checkingUpdate: false });
+      if (this._mounted) this.setState({ updateTip: "检查失败，可重试。", updateDiagnostic: String(error.stack || error) });
     }
   }
 
@@ -177,6 +213,7 @@ class KaiPlannerApp extends React.Component {
       content = React.createElement(DailyTabV2, {
         envWindow: this.props.envWindow,
         envCtx: this.props.envCtx,
+        dataRevision: this.state.dataRevision,
         themeTokens,
       });
     } else if (tab === "wishlist") {
@@ -198,6 +235,7 @@ class KaiPlannerApp extends React.Component {
         content = React.createElement(this._WishlistTab, {
           envWindow: this.props.envWindow,
           envCtx: this.props.envCtx,
+        dataRevision: this.state.dataRevision,
           materialResourceVersion: this.state.materialResourceVersion,
           themeTokens,
         });
@@ -223,6 +261,7 @@ class KaiPlannerApp extends React.Component {
         content = React.createElement(this._AcquisitionTab, {
           envWindow: this.props.envWindow,
           envCtx: this.props.envCtx,
+        dataRevision: this.state.dataRevision,
           themeTokens,
         });
       } else {
@@ -247,6 +286,7 @@ class KaiPlannerApp extends React.Component {
         content = React.createElement(this._DebugTab, {
           envWindow: this.props.envWindow,
           envCtx: this.props.envCtx,
+        dataRevision: this.state.dataRevision,
           themeTokens,
         });
       } else {
@@ -284,6 +324,13 @@ class KaiPlannerApp extends React.Component {
           this.state.updateTip ? React.createElement("span", { style: { fontSize: 14, color: themeTokens.textMuted } }, this.state.updateTip) : null
         )
       ),
+      this.state.updateDiagnostic ? React.createElement("details", { style: { marginBottom: 12 } },
+        React.createElement("summary", null, "最近一次更新未完成：查看诊断详情"),
+        React.createElement("button", { onClick: () => this.copyUpdateDiagnostic() }, "复制诊断详情"),
+        React.createElement("span", null, this.state.copyTip),
+        React.createElement("textarea", { readOnly: true, value: this.state.updateDiagnostic,
+          style: { width: "100%", height: 140 }, onFocus: (event) => event.target.select() })
+      ) : null,
       content
     );
   }

package/src/app/tabs/acquisition/AcquisitionTab.js

@@ -48,11 +48,7 @@ class AcquisitionTab extends React.Component {
   constructor(props) {
     super(props);
 
-    this.staticData = loadStaticData();
-    this.consumeIndexes = buildConsumeIndexes(this.staticData);
-    this.upgradeIndexes = buildUpgradeIndexes(this.staticData);
-    this.pathByPair = buildPathIndexes(this.staticData).pathByPair;
-    this.arrangementIndex = buildArrangementIndex(this.staticData.improvementArrangement).index;
+    this.reloadStaticData();
 
     this.state = {
       nowText: formatTokyoText(),
@@ -77,11 +73,26 @@ class AcquisitionTab extends React.Component {
     this.refresh = this.refresh.bind(this);
   }
 
+  reloadStaticData() {
+    this.staticData = loadStaticData();
+    this.consumeIndexes = buildConsumeIndexes(this.staticData);
+    this.upgradeIndexes = buildUpgradeIndexes(this.staticData);
+    this.pathByPair = buildPathIndexes(this.staticData).pathByPair;
+    this.arrangementIndex = buildArrangementIndex(this.staticData.improvementArrangement).index;
+  }
+
   componentDidMount() {
     this._timer = setInterval(() => this.setState({ nowText: formatTokyoText() }), 1000);
     this.refresh();
   }
 
+  componentDidUpdate(prevProps) {
+    if (prevProps.dataRevision !== this.props.dataRevision) {
+      this.reloadStaticData();
+      this.refresh();
+    }
+  }
+
   componentWillUnmount() {
     if (this._timer) clearInterval(this._timer);
   }

package/src/app/tabs/daily/DailyTabV2.js

@@ -185,6 +185,10 @@ class DailyTabV2 extends React.Component {
     }, 1000);
   }
 
+  componentDidUpdate(prevProps) {
+    if (prevProps.dataRevision !== this.props.dataRevision) this.refresh();
+  }
+
   componentWillUnmount() {
     if (this._timer) clearInterval(this._timer);
   }

package/src/app/tabs/debug/debugDiagnostics.js

@@ -42,6 +42,7 @@ function buildDebugDiagnostics({
       lastCheckAt: meta.lastCheckAt || "",
       lastCheckOk: meta.lastCheckOk == null ? null : !!meta.lastCheckOk,
       lastCheckReason: meta.lastCheckReason || "",
+      lastCheckDiagnostic: meta.lastCheckDiagnostic || null,
       dataDir: staticInfo.dataDir || "",
       cachePath: staticInfo.cachePath || "",
       cacheExists: !!staticInfo.cacheExists,

package/src/app/tabs/wishlist/WishlistTabV2.js

@@ -121,11 +121,7 @@ class WishlistTabV2 extends React.Component {
   constructor(props) {
     super(props);
 
-    this.staticData = loadStaticData();
-    this.consumeIndexes = buildConsumeIndexes(this.staticData);
-    this.upgradeIndexes = buildUpgradeIndexes(this.staticData);
-    this.pathByPair = buildPathIndexes(this.staticData).pathByPair;
-    this.arrangementIndex = buildArrangementIndex(this.staticData.improvementArrangement).index;
+    this.reloadStaticData();
     this._ownerShipIndexCache = { shipsRef: null, map: {} };
     this._startOptionsCache = { targetEquipId: null, equipsRef: null, plansKey: "", ownerMapRef: null, options: [] };
 
@@ -167,6 +163,14 @@ class WishlistTabV2 extends React.Component {
     this.refreshPlanById = this.refreshPlanById.bind(this);
   }
 
+  reloadStaticData() {
+    this.staticData = loadStaticData();
+    this.consumeIndexes = buildConsumeIndexes(this.staticData);
+    this.upgradeIndexes = buildUpgradeIndexes(this.staticData);
+    this.pathByPair = buildPathIndexes(this.staticData).pathByPair;
+    this.arrangementIndex = buildArrangementIndex(this.staticData.improvementArrangement).index;
+  }
+
   componentDidMount() {
     this._timer = setInterval(() => this.setState({ nowText: formatTokyoText() }), 1000);
     this.refreshPlans();
@@ -179,6 +183,12 @@ class WishlistTabV2 extends React.Component {
   }
 
   componentDidUpdate(prevProps) {
+    if (prevProps.dataRevision !== this.props.dataRevision) {
+      this.reloadStaticData();
+      this._startOptionsCache = {};
+      this.refreshPlans({ preserveInteraction: true });
+      return;
+    }
     if (prevProps.materialResourceVersion === this.props.materialResourceVersion) return;
     const state = this.getReduxState();
     if (!state || !state.const || !state.info) return;
@@ -374,7 +384,8 @@ class WishlistTabV2 extends React.Component {
   setFilterNote(value) {
     this.setState(this.clearSelectionState({ filterNote: value, info: null }));
   }
-  refreshPlans() {
+  refreshPlans({ preserveInteraction = false } = {}) {
+    const interactionPatch = (patch) => preserveInteraction ? patch : this.clearSelectionState(patch);
     try {
       const state = this.getReduxState();
       const plans = loadPlans();
@@ -461,7 +472,7 @@ class WishlistTabV2 extends React.Component {
       };
 
       this.setState(
-        this.clearSelectionState({
+        interactionPatch({
           ...buildInitialWishlistHydrationState({
             plans,
             initialSnapshot,
@@ -474,7 +485,7 @@ class WishlistTabV2 extends React.Component {
         }
       );
     } catch (error) {
-      this.setState(this.clearSelectionState({ error: String(error && (error.stack || error)), hydrating: false, hydrationQueue: [] }));
+      this.setState(interactionPatch({ error: String(error && (error.stack || error)), hydrating: false, hydrationQueue: [] }));
     }
   }
 

package/src/core/poi/ensurePluginWindowVisible.js

@@ -0,0 +1,54 @@
+const PLUGIN_QUERY = "?poi-plugin-kai-planner";
+
+// Portal components execute in poi's main renderer. Never use
+// remote.getCurrentWindow(): that would target the main window.
+function ensurePluginWindowVisible(envWindow, envCtx, options = {}) {
+  let cancelled = false;
+  let timer = null;
+  const schedule = options.schedule || setTimeout;
+  const clear = options.clear || clearTimeout;
+  const warn = options.warn || ((error) => console.warn("[kai-planner] window visibility fallback failed", error));
+  const cancel = () => {
+    cancelled = true;
+    if (timer !== null) clear(timer);
+    timer = null;
+  };
+
+  try {
+    const mountPoint = envCtx && envCtx.mountPoint;
+    if (!envWindow || envWindow.closed || envWindow.isWindowMode !== true || !mountPoint) return cancel;
+    const doc = envWindow.document;
+    const url = new URL(envWindow.location.href);
+    if (url.protocol !== "file:" || !url.pathname.endsWith("/index-plugin.html") || url.search !== PLUGIN_QUERY) return cancel;
+    if (mountPoint.ownerDocument !== doc || !mountPoint.isConnected) return cancel;
+
+    const remote = options.remote || require("@electron/remote");
+    const matches = remote.BrowserWindow.getAllWindows().filter(
+      (win) => !win.isDestroyed() && win.webContents.getURL() === url.href
+    );
+    if (matches.length !== 1) return cancel;
+    // Capture this instance now, never search again after a close/reopen.
+    const target = matches[0];
+    if (target.isVisible() || target.isMinimized()) return cancel;
+
+    // Run after the mount commit; one check only, no polling or focus call.
+    timer = schedule(() => {
+      timer = null;
+      if (cancelled) return;
+      try {
+        if (envWindow.closed || target.isDestroyed()) return;
+        if (envWindow.document !== doc || envWindow.location.href !== url.href) return;
+        if (!mountPoint.isConnected || mountPoint.ownerDocument !== doc || !mountPoint.querySelector(".kai-planner-root")) return;
+        if (target.webContents.getURL() !== url.href || target.isVisible() || target.isMinimized()) return;
+        target.show();
+      } catch (error) {
+        warn(error);
+      }
+    }, 0);
+  } catch (error) {
+    warn(error);
+  }
+  return cancel;
+}
+
+module.exports = { ensurePluginWindowVisible };

package/src/data/static/data_manifest.json

@@ -1,8 +1,8 @@
 {
-  "data_version": "2026.04.29",
-  "run_date": "2026-04-29",
-  "updated_at": "2026-04-29T00:00:00+08:00",
-  "previous_snapshot": "2026-04-25",
+  "data_version": "2026.08.26",
+  "run_date": "2026-08-26",
+  "updated_at": "2026-08-26T00:00:00+08:00",
+  "previous_snapshot": "2026-07-10",
   "version_complete": true,
   "source": {
     "repo": "yukikuri/akashi-list",
@@ -10,39 +10,56 @@
     "detail_path": "detail/"
   },
   "target_equipment_ids": [
+    2,
     3,
-    10,
-    13,
-    14,
-    15,
-    24,
     27,
-    45,
-    57,
-    88,
-    89,
-    91,
+    35,
+    39,
+    40,
+    48,
+    49,
+    63,
+    76,
     106,
-    125,
+    122,
+    146,
+    171,
+    174,
+    198,
+    205,
+    226,
     229,
-    278,
-    284,
-    285,
-    286,
-    287,
-    288,
+    256,
+    266,
+    267,
     294,
-    307,
-    313,
+    295,
     315,
-    379,
-    382,
-    397,
-    398,
-    553,
-    572,
-    573,
-    574
+    317,
+    362,
+    381,
+    385,
+    419,
+    468,
+    470,
+    471,
+    483,
+    503,
+    529,
+    536,
+    537,
+    541,
+    542,
+    577,
+    578,
+    579,
+    580,
+    582,
+    583,
+    584,
+    585,
+    586,
+    587
   ],
   "fetch_report_file": "fetch_report.json",
   "files": [

package/src/data/static/equip_base_cost.json

@@ -1063,6 +1063,13 @@
     "consume_steel": 0,
     "consume_bauxite": 600
   },
+  {
+    "id": 189,
+    "consume_fuel": 200,
+    "consume_ammo": 190,
+    "consume_steel": 20,
+    "consume_bauxite": 490
+  },
   {
     "id": 190,
     "consume_fuel": 24,
@@ -2078,6 +2085,20 @@
     "consume_steel": 420,
     "consume_bauxite": 0
   },
+  {
+    "id": 428,
+    "consume_fuel": 30,
+    "consume_ammo": 260,
+    "consume_steel": 320,
+    "consume_bauxite": 20
+  },
+  {
+    "id": 429,
+    "consume_fuel": 40,
+    "consume_ammo": 320,
+    "consume_steel": 320,
+    "consume_bauxite": 20
+  },
   {
     "id": 431,
     "consume_fuel": 290,
@@ -2574,5 +2595,12 @@
     "consume_ammo": 20,
     "consume_steel": 170,
     "consume_bauxite": 280
+  },
+  {
+    "id": 575,
+    "consume_fuel": 10,
+    "consume_ammo": 40,
+    "consume_steel": 30,
+    "consume_bauxite": 20
   }
 ]