poi-plugin-kai-planner 1.0.0

package/README.md

@@ -0,0 +1,48 @@
+# poi-plugin-kai-planner
+
+用于 POI 的改修规划插件（每日改修 + 改修心愿清单）。
+
+## 当前发布机制（2026-02）
+
+- 插件代码仓库：私有（本仓库）。
+- 玩家安装方式：通过 npm 安装 poi 插件包。
+- 远端静态数据：独立公开仓库 `PlannerRemoteRawData`（GitHub Raw）。
+- 调试页开关：`package.json -> poiPlugin.enableDebug`（发布建议 `false`）。
+- 发布包控制：
+  - `package.json.files` 白名单
+  - `.npmignore` 保险排除
+  - `npm run release:check` 发版前检查
+
+## 功能概览
+
+- 每日改修（GMT+9）
+- 改修心愿清单（计划创建、实时缺口、进度跟踪、起点重绑）
+  - 支持行内编辑计划优先级与目标星级（点击“编辑”进入，点击“保存”生效）
+  - 目标星级编辑限制：当起点装备实时状态与目标装备同 `sortno` 时，不可低于起点当前星级
+  - 展开区步骤展示按实时状态区分“已完成步骤 / 未完成步骤”
+- Debug（可选加载，默认可关闭）
+
+## 本地数据
+
+- 计划存储优先写入：
+  - `<plugin_root>/runtime_data/userPlans/plans.v1.json`
+- 文件存储不可用时回退 `localStorage`（`kai_planner_user_plans_v1`）。
+- 远端静态数据缓存：
+  - `runtime_data/static_data/meta.json`
+  - `runtime_data/static_data/cache/*.json`
+
+## 常用命令
+
+- `npm test`
+- `npm run release:check`
+- `npm run release:pack`
+
+## 文档导航
+
+- 架构说明：[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
+- 数据版本策略：[docs/DATA_VERSIONING.md](docs/DATA_VERSIONING.md)
+- 计划存储策略：[docs/STORAGE_POLICY.md](docs/STORAGE_POLICY.md)
+- Wishlist 状态字典：[docs/WISHLIST_STATE_FIELDS.md](docs/WISHLIST_STATE_FIELDS.md)
+- npm/POI 发布流程：[docs/RELEASE_POI_NPM.md](docs/RELEASE_POI_NPM.md)
+- 私有仓库更新流程：[docs/PRIVATE_REPO_UPDATE.md](docs/PRIVATE_REPO_UPDATE.md)
+- 远端静态数据更新流程：[docs/REMOTE_DATA_UPDATE.md](docs/REMOTE_DATA_UPDATE.md)

package/index.js

@@ -0,0 +1,35 @@
+/* poi-plugin-kai-planner/index.js */
+/* Entry: render src/app/KaiPlannerApp.js */
+
+const React = require("react");
+const { WindowEnv } = require("views/components/etc/window-env");
+
+const { KaiPlannerApp } = require("./src/app/KaiPlannerApp");
+
+function KaiPlannerAppWithEnv() {
+  return React.createElement(WindowEnv.Consumer, null, (ctx) => {
+    const w =
+      (ctx && ctx.window) ||
+      (ctx && ctx.env && ctx.env.window) ||
+      (ctx && ctx.remoteWindow) ||
+      null;
+
+    return React.createElement(KaiPlannerApp, { envWindow: w, envCtx: ctx });
+  });
+}
+
+module.exports = {
+  reactClass: KaiPlannerAppWithEnv,
+  windowMode: true,
+
+  pluginDidLoad() {
+    if (typeof window !== "undefined" && window.log) {
+      window.log("[kai-planner] loaded");
+    }
+  },
+  pluginWillUnload() {
+    if (typeof window !== "undefined" && window.log) {
+      window.log("[kai-planner] unloaded");
+    }
+  },
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "poi-plugin-kai-planner",
+  "version": "1.0.0",
+  "main": "index.js",
+  "private": false,
+  "files": [
+    "index.js",
+    "src/**"
+  ],
+  "scripts": {
+    "test": "node --test tests",
+    "release:check": "npm test && npm pack --dry-run",
+    "release:pack": "npm pack"
+  },
+  "poiPlugin": {
+    "title": "改修规划",
+    "description": "管理个人装备与改修计划。",
+    "icon": "tasks",
+    "enableDebug": false,
+    "dataSource": {
+      "manifestRawUrl": "https://raw.githubusercontent.com/auluu/PlannerRemoteRawData/refs/heads/main/data_manifest.json",
+      "rawBaseUrl": "https://raw.githubusercontent.com/auluu/PlannerRemoteRawData/refs/heads/main"
+    }
+  }
+}

package/src/app/KaiPlannerApp.js

@@ -0,0 +1,211 @@
+// src/app/KaiPlannerApp.js
+const React = require("react");
+const { DailyTab } = require("./tabs/daily/DailyTab");
+const { checkAndUpdateData } = require("../services/static/version/dataUpdateManager");
+const { readMeta } = require("../services/static/version/versionStore");
+
+const placeholderStyle = {
+  padding: 12,
+  background: "#111827",
+  color: "#e5e7eb",
+  borderRadius: 8,
+};
+
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+
+function formatSimpleTime(iso) {
+  if (!iso) return "-";
+  const d = new Date(iso);
+  if (!Number.isFinite(d.getTime())) return "-";
+  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())} ${pad2(d.getHours())}:${pad2(
+    d.getMinutes()
+  )}:${pad2(d.getSeconds())}`;
+}
+
+function readBundledManifestUpdatedAt() {
+  try {
+    // eslint-disable-next-line global-require
+    const m = require("../data/static/data_manifest.json");
+    if (m && m.updated_at) return String(m.updated_at);
+  } catch {}
+  return null;
+}
+
+function readEnableDebugFlag() {
+  try {
+    // eslint-disable-next-line global-require
+    const pkg = require("../../package.json");
+    const poiPlugin = pkg && pkg.poiPlugin ? pkg.poiPlugin : {};
+    if (poiPlugin.enableDebug == null) return true;
+    return !!poiPlugin.enableDebug;
+  } catch {
+    return true;
+  }
+}
+
+class KaiPlannerApp extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = {
+      tab: "daily", // daily | wishlist | debug
+      wishlistLoadError: null,
+      debugLoadError: null,
+      checkingUpdate: false,
+      lastUpdateAtText: "-",
+      updateTip: "",
+    };
+    this._WishlistTab = null;
+    this._DebugTab = null;
+    this.enableDebug = readEnableDebugFlag();
+    this.handleCheckUpdate = this.handleCheckUpdate.bind(this);
+  }
+
+  componentDidMount() {
+    this.syncUpdateMeta();
+    this.handleCheckUpdate(false);
+  }
+
+  syncUpdateMeta() {
+    try {
+      const meta = readMeta();
+      const fallback = readBundledManifestUpdatedAt();
+      this.setState({
+        lastUpdateAtText: formatSimpleTime((meta && meta.lastUpdateAt) || fallback),
+      });
+    } catch {}
+  }
+
+  async handleCheckUpdate(force) {
+    if (this.state.checkingUpdate) return;
+    this.setState({ checkingUpdate: true, updateTip: force ? "正在检查..." : "" });
+    try {
+      const res = await checkAndUpdateData({ force: !!force });
+      this.syncUpdateMeta();
+      if (force) {
+        if (res && res.ok && res.updated) this.setState({ updateTip: `已更新到数据版本 ${res.remoteVersion}` });
+        else if (res && res.ok && !res.updated) this.setState({ updateTip: "当前已是最新数据" });
+        else if (res && res.reason === "data_source_not_configured") this.setState({ updateTip: "未配置远端数据源" });
+        else this.setState({ updateTip: `检查失败${res && res.error ? `：${res.error}` : ""}` });
+      }
+    } catch (e) {
+      if (force) this.setState({ updateTip: `检查失败：${String(e && (e.stack || e))}` });
+    } finally {
+      this.setState({ checkingUpdate: false });
+    }
+  }
+
+  render() {
+    const tab = !this.enableDebug && this.state.tab === "debug" ? "daily" : this.state.tab;
+
+    const tabButtonStyle = (key) => ({
+      padding: "6px 10px",
+      borderRadius: 8,
+      cursor: "pointer",
+      border: "1px solid #374151",
+      background: tab === key ? "#1f2937" : "transparent",
+      color: "#e5e7eb",
+      marginRight: 8,
+      fontSize: 12,
+    });
+
+    let content = null;
+    if (tab === "daily") {
+      content = React.createElement(DailyTab, {
+        envWindow: this.props.envWindow,
+        envCtx: this.props.envCtx,
+      });
+    } else if (tab === "wishlist") {
+      if (!this._WishlistTab && !this.state.wishlistLoadError) {
+        try {
+          // eslint-disable-next-line global-require
+          this._WishlistTab = require("./tabs/wishlist/WishlistTab");
+        } catch (e) {
+          this.setState({ wishlistLoadError: String(e && e.stack ? e.stack : e) });
+        }
+      }
+
+      if (this.state.wishlistLoadError) {
+        content = React.createElement(
+          "div",
+          { style: { ...placeholderStyle, whiteSpace: "pre-wrap" } },
+          "【改修心愿清单】模块加载失败（已隔离，不影响 Daily/Debug）\n\n错误信息：\n" + this.state.wishlistLoadError
+        );
+      } else if (this._WishlistTab) {
+        content = React.createElement(this._WishlistTab, {
+          envWindow: this.props.envWindow,
+          envCtx: this.props.envCtx,
+        });
+      } else {
+        content = React.createElement("div", { style: placeholderStyle }, "【改修心愿清单】加载中...");
+      }
+    } else if (tab === "debug") {
+      if (!this._DebugTab && !this.state.debugLoadError) {
+        try {
+          // eslint-disable-next-line global-require
+          this._DebugTab = require("./tabs/debug/DebugTab");
+        } catch (e) {
+          this.setState({ debugLoadError: String(e && e.stack ? e.stack : e) });
+        }
+      }
+
+      if (this.state.debugLoadError) {
+        content = React.createElement(
+          "div",
+          { style: { ...placeholderStyle, whiteSpace: "pre-wrap" } },
+          "【Debug】模块加载失败（已隔离，不影响 Daily/Wishlist）\n\n错误信息：\n" + this.state.debugLoadError
+        );
+      } else if (this._DebugTab) {
+        content = React.createElement(this._DebugTab, {
+          envWindow: this.props.envWindow,
+          envCtx: this.props.envCtx,
+        });
+      } else {
+        content = React.createElement("div", { style: placeholderStyle }, "【Debug】加载中...");
+      }
+    } else {
+      content = React.createElement("div", { style: placeholderStyle }, "未知标签页");
+    }
+
+    return React.createElement(
+      "div",
+      { style: { padding: 12 } },
+      React.createElement(
+        "div",
+        { style: { marginBottom: 12, display: "flex", alignItems: "center", justifyContent: "space-between", gap: 12 } },
+        React.createElement(
+          "div",
+          null,
+          React.createElement("button", { style: tabButtonStyle("daily"), onClick: () => this.setState({ tab: "daily" }) }, "每日改修"),
+          React.createElement(
+            "button",
+            { style: tabButtonStyle("wishlist"), onClick: () => this.setState({ tab: "wishlist" }) },
+            "改修心愿清单"
+          ),
+          this.enableDebug
+            ? React.createElement(
+                "button",
+                { style: tabButtonStyle("debug"), onClick: () => this.setState({ tab: "debug" }) },
+                "Debug"
+              )
+            : null
+        ),
+        React.createElement(
+          "div",
+          { style: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap", justifyContent: "flex-end" } },
+          React.createElement("span", { style: { fontSize: 12, opacity: 0.8 } }, `上一次数据源更新：${this.state.lastUpdateAtText}`),
+          React.createElement(
+            "button",
+            { style: tabButtonStyle("__check__"), onClick: () => this.handleCheckUpdate(true), disabled: this.state.checkingUpdate },
+            this.state.checkingUpdate ? "检查中..." : "检查更新"
+          ),
+          this.state.updateTip ? React.createElement("span", { style: { fontSize: 12, opacity: 0.85 } }, this.state.updateTip) : null
+        )
+      ),
+      content
+    );
+  }
+}
+
+module.exports = { KaiPlannerApp };