dsh-niuma 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文件记录用户可感知的变化。版本号遵循语义化版本。
 
+## 0.2.2 — 2026-10-22
+
+### 新增：主金额小数位 + 刷新频率 + 滚动数字/加速
+
+- **主金额改连续「里程表」滚动**：每一位按位权连续转动——最后一位小数转得最快（0-9 快速循环），
+  前一位慢 10 倍，整数位几乎不动；不是整块金额跳变，而是数字持续往上滚
+- **加速开关**：主金额右侧「加速」勾选后强制毫秒级刷新（`requestAnimationFrame`，≈16ms），
+  滚轮每帧更新，低位小数飞快转动、高位慢慢进位
+- **小数位数可选（0–6，默认 4）**：主卡金额右侧「小数 [n] 位」，改完即时保存、立即生效
+- **刷新频率可调**：设置区新增「刷新频率」行
+  - 按秒（1s，默认，最省电）
+  - 250 ms / 100 ms / 50 ms（毫秒级滚动）
+  - 刷新率（≈16 ms，requestAnimationFrame，跟随屏幕刷新连续跳动）
+- core 新增配置 `decimals`（0–6 整数）、`updateMs`（16–1000 整数）与 `turbo`（布尔），宿主写接口同样校验
+- 刷新由 `useClock(updateMs)` 驱动：≥50ms 用 setInterval，≤16ms 用 rAF
+
 ## 0.2.1 — 2026-10-21
 
 ### 新增：本月工作天数进度

package/README.md

@@ -32,6 +32,9 @@
 - 节假日数据内置在插件中（2026 官方 / 2027 预估），设置区不再需要手工维护一长串日期；2027 官方安排公布后随插件更新
 - 午休可设置起止，**可勾选午休是否算工时**；午休不算工时则午休期间金额冻结
 - 状态徽标：休息日 / 未上班 / 搬砖中 / 午休中 / 已下班
+- 主金额是**连续里程表滚动**：小数末位飞快转、前一位慢 10 倍、整数位慢慢进位；勾选「加速」按屏幕刷新率每帧滚动
+- 主金额**小数位可选（0–6）**，右侧下拉即时生效
+- **刷新频率可选**：按秒 / 250ms / 100ms / 50ms / 屏幕刷新率（≈16ms 连续滚动）
 - 今日进度条、距上班/距下班倒计时
 - **本月已工作 / 剩余工作日**（与工资口径一致：节假日、周末、调休都算进去）
 

package/lib/client.js

@@ -187,7 +187,13 @@ var DEFAULTS = Object.freeze({
   lunchEnd: "13:00",
   lunchPaid: false,
   holidays: DEFAULT_HOLIDAYS,
-  extraWorkdays: DEFAULT_EXTRA_WORKDAYS
+  extraWorkdays: DEFAULT_EXTRA_WORKDAYS,
+  /** 主金额小数位（0-6） */
+  decimals: 4,
+  /** 面板刷新间隔 ms：1000=按秒；16≈屏幕刷新率（连续滚动）；中间值为毫秒级 */
+  updateMs: 1e3,
+  /** 加速（滚动模式）：true 时强制毫秒级刷新（≈屏幕刷新率），数字连续滚动 */
+  turbo: false
 });
 var SALARY_MAX = 1e7;
 var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
@@ -266,6 +272,21 @@ function normalizeConfig(patch) {
   }
   merged.lunchEnabled = merged.lunchEnabled !== false;
   merged.lunchPaid = merged.lunchPaid === true;
+  merged.turbo = merged.turbo === true;
+  const decimals = Number(merged.decimals);
+  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 6) {
+    errors.push("\u5C0F\u6570\u4F4D\u6570\u9700\u8981\u662F 0~6 \u7684\u6574\u6570");
+    merged.decimals = Number.isInteger(decimals) ? decimals : DEFAULTS.decimals;
+  } else {
+    merged.decimals = decimals;
+  }
+  const updateMs = Number(merged.updateMs);
+  if (!Number.isInteger(updateMs) || updateMs < 16 || updateMs > 1e3) {
+    errors.push("\u5237\u65B0\u95F4\u9694\u9700\u8981\u662F 16~1000ms \u7684\u6574\u6570");
+    merged.updateMs = Number.isInteger(updateMs) ? updateMs : DEFAULTS.updateMs;
+  } else {
+    merged.updateMs = updateMs;
+  }
   const holidays = normalizeDateList(merged.holidays);
   const extraWorkdays = normalizeDateList(merged.extraWorkdays);
   errors.push(...holidays.errors, ...extraWorkdays.errors);
@@ -588,6 +609,12 @@ var zh = {
   "configFailed": "\u8BBE\u7F6E\u8BFB\u53D6\u5931\u8D25\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u503C",
   "retry": "\u91CD\u8BD5",
   "settings": "\u8BBE\u7F6E",
+  "decimalsLabel": "\u5C0F\u6570",
+  "decimalsUnit": "\u4F4D",
+  "turboLabel": "\u52A0\u901F",
+  "refreshRate": "\u5237\u65B0\u9891\u7387",
+  "rateSecond": "\u6309\u79D2\uFF081s\uFF09",
+  "rateFrame": "\u5237\u65B0\u7387\uFF08\u224816ms\uFF09",
   "settingsHint": "\u6539\u5B8C\u70B9\u300C\u4FDD\u5B58\u300D\u751F\u6548\uFF1B\u683C\u5F0F\u4E0D\u5BF9\u4F1A\u5728\u4E0B\u65B9\u7EA2\u5B57\u63D0\u793A\uFF0C\u4E0D\u5F71\u54CD\u8BA1\u65F6\u3002",
   "salaryField": "\u5B9E\u6536\u6708\u85AA",
   "groupSalary": "\u5DE5\u8D44",
@@ -686,6 +713,12 @@ var en = {
   "configFailed": "Failed to load settings, using defaults",
   "retry": "Retry",
   "settings": "Settings",
+  "decimalsLabel": "Decimals",
+  "decimalsUnit": "dp",
+  "turboLabel": "Turbo",
+  "refreshRate": "Refresh rate",
+  "rateSecond": "Per second (1s)",
+  "rateFrame": "Display rate (~16ms)",
   "settingsHint": "Click Save to apply. Invalid input is shown in red below; the ticker keeps running.",
   "salaryField": "Net monthly salary",
   "groupSalary": "Salary",
@@ -763,7 +796,8 @@ function formFromConfig(config) {
     lunchEnabled: config.lunchEnabled !== false,
     lunchStart: String(config.lunchStart == null ? "" : config.lunchStart),
     lunchEnd: String(config.lunchEnd == null ? "" : config.lunchEnd),
-    lunchPaid: config.lunchPaid === true
+    lunchPaid: config.lunchPaid === true,
+    updateMs: String(config.updateMs == null ? 1e3 : config.updateMs)
   };
 }
 function patchFromForm(form) {
@@ -775,7 +809,8 @@ function patchFromForm(form) {
     lunchEnabled: Boolean(form.lunchEnabled),
     lunchStart: String(form.lunchStart || "").trim(),
     lunchEnd: String(form.lunchEnd || "").trim(),
-    lunchPaid: Boolean(form.lunchPaid)
+    lunchPaid: Boolean(form.lunchPaid),
+    updateMs: Number(form.updateMs)
   };
 }
 function useRemoteConfig() {
@@ -811,18 +846,21 @@ function useRemoteConfig() {
   const refresh = import_react.default.useCallback(() => setTick((n) => n + 1), []);
   return { ...state, refresh };
 }
-function useSecondClock() {
+function useClock(updateMs) {
   const [now, setNow] = import_react.default.useState(() => /* @__PURE__ */ new Date());
   import_react.default.useEffect(() => {
-    let lastSecond = -1;
-    const timer = setInterval(() => {
-      const second = Math.floor(Date.now() / 1e3);
-      if (second === lastSecond) return;
-      lastSecond = second;
-      setNow(/* @__PURE__ */ new Date());
-    }, 250);
+    if (updateMs <= 16) {
+      let raf = 0;
+      const loop = () => {
+        setNow(/* @__PURE__ */ new Date());
+        raf = requestAnimationFrame(loop);
+      };
+      raf = requestAnimationFrame(loop);
+      return () => cancelAnimationFrame(raf);
+    }
+    const timer = setInterval(() => setNow(/* @__PURE__ */ new Date()), updateMs);
     return () => clearInterval(timer);
-  }, []);
+  }, [updateMs]);
   return now;
 }
 function NiumaIcon(props) {
@@ -898,10 +936,106 @@ function SectionTitle(props) {
     props.hint ? import_react.default.createElement("span", { key: "h", style: { fontSize: 10.5, color: C.label3, ...NUM } }, props.hint) : null
   ]);
 }
+var ROLL_BLOCKS = Array.from({ length: 11 }, (_, i) => String(i % 10));
+function RollingDigit(props) {
+  const heightEm = 1.22;
+  const widthEm = 0.62;
+  const pos = Number.isFinite(props.position) ? props.position : 0;
+  const wheel = (pos % 10 + 10) % 10;
+  return import_react.default.createElement("span", {
+    "aria-hidden": "true",
+    style: {
+      display: "inline-block",
+      position: "relative",
+      overflow: "hidden",
+      width: `${widthEm}em`,
+      height: `${heightEm}em`,
+      verticalAlign: "baseline"
+    }
+  }, [
+    import_react.default.createElement("span", {
+      key: "ghost",
+      style: { visibility: "hidden", display: "block", height: `${heightEm}em`, lineHeight: `${heightEm}em` }
+    }, "0"),
+    import_react.default.createElement("span", {
+      key: "strip",
+      style: {
+        position: "absolute",
+        left: 0,
+        top: 0,
+        display: "flex",
+        flexDirection: "column",
+        transform: `translateY(${-(wheel * heightEm)}em)`,
+        willChange: "transform"
+      }
+    }, ROLL_BLOCKS.map((value, i) => import_react.default.createElement("span", {
+      key: i,
+      style: { display: "block", height: `${heightEm}em`, lineHeight: `${heightEm}em` }
+    }, value)))
+  ]);
+}
+function RollingMoney(props) {
+  const decimals = Math.max(0, Math.min(6, Number.isInteger(props.decimals) ? props.decimals : 4));
+  const text = formatMoney(props.value, decimals);
+  const scale = 10 ** decimals;
+  const chars = text.split("");
+  const significances = new Array(chars.length).fill(-1);
+  let seen = 0;
+  for (let i = chars.length - 1; i >= 0; i -= 1) {
+    if (/[0-9]/.test(chars[i])) {
+      significances[i] = seen;
+      seen += 1;
+    }
+  }
+  return import_react.default.createElement("span", {
+    style: {
+      display: "inline-flex",
+      alignItems: "baseline",
+      letterSpacing: 0,
+      position: "relative",
+      // 等宽字体保证每个数字轮宽度稳定（不裁字、不抖动）
+      fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+      ...props.style || {}
+    }
+  }, [
+    import_react.default.createElement("span", {
+      key: "sr",
+      style: {
+        position: "absolute",
+        width: 1,
+        height: 1,
+        padding: 0,
+        margin: -1,
+        overflow: "hidden",
+        clip: "rect(0,0,0,0)",
+        whiteSpace: "nowrap",
+        border: 0
+      }
+    }, text),
+    import_react.default.createElement("span", {
+      key: "visual",
+      "aria-hidden": "true",
+      style: { display: "inline-flex", alignItems: "baseline" }
+    }, chars.map((char, i) => {
+      if (!/[0-9]/.test(char)) {
+        return import_react.default.createElement("span", {
+          key: `s${i}`,
+          style: { display: "inline-block", lineHeight: "1.22em" }
+        }, char);
+      }
+      const position = (Number(props.value) || 0) * scale / 10 ** significances[i];
+      return import_react.default.createElement(RollingDigit, { key: `d${i}`, position });
+    }))
+  ]);
+}
 function HeroCard(props) {
   const t = props.t;
   const snap = props.snap;
   const rates = snap.rates;
+  const decimals = Number.isInteger(props.decimals) ? props.decimals : 4;
+  const onDecimalsChange = props.onDecimalsChange;
+  const turbo = props.turbo === true;
+  const onTurboChange = props.onTurboChange;
   const progress = Math.max(0, Math.min(1, Number(snap.todayProgress) || 0));
   const percentText = `${(progress * 100).toFixed(1)}%`;
   const live = snap.status === "working";
@@ -959,22 +1093,83 @@ function HeroCard(props) {
       key: "amt",
       style: { display: "flex", alignItems: "baseline", gap: 7, marginTop: 4, flexWrap: "wrap" }
     }, [
-      import_react.default.createElement("span", {
+      import_react.default.createElement(RollingMoney, {
         key: "val",
+        value: snap.todayEarned,
+        decimals,
         style: {
           fontSize: 46,
           lineHeight: 1.12,
           fontWeight: 800,
-          letterSpacing: "-1.2px",
           ...GOLD,
           ...NUM,
           ...rest ? { opacity: 0.62 } : {}
         }
-      }, formatMoney(snap.todayEarned, 4)),
+      }),
       import_react.default.createElement("span", {
         key: "unit",
         style: { fontSize: 18, fontWeight: 700, color: C.label2, ...NUM }
-      }, "\u5143")
+      }, "\u5143"),
+      import_react.default.createElement("label", {
+        key: "dec",
+        title: t("decimalsLabel"),
+        style: {
+          marginLeft: "auto",
+          display: "inline-flex",
+          alignItems: "center",
+          gap: 3,
+          fontSize: 10,
+          color: C.label3,
+          ...NUM
+        }
+      }, [
+        import_react.default.createElement("span", { key: "l" }, t("decimalsLabel")),
+        import_react.default.createElement("select", {
+          key: "s",
+          value: String(decimals),
+          "aria-label": t("decimalsLabel"),
+          onChange: (event) => onDecimalsChange && onDecimalsChange(Number(event.target.value)),
+          style: {
+            height: 22,
+            padding: "0 2px",
+            borderRadius: 6,
+            border: `1px solid ${C.border1}`,
+            background: C.layer2,
+            color: C.label2,
+            fontSize: 10.5,
+            fontVariantNumeric: "tabular-nums",
+            outline: "none",
+            cursor: "pointer"
+          }
+        }, [0, 1, 2, 3, 4, 5, 6].map((n) => import_react.default.createElement("option", { key: n, value: String(n) }, String(n)))),
+        import_react.default.createElement("span", { key: "u" }, t("decimalsUnit"))
+      ]),
+      import_react.default.createElement("label", {
+        key: "turbo",
+        title: t("turboLabel"),
+        style: {
+          display: "inline-flex",
+          alignItems: "center",
+          gap: 3,
+          fontSize: 10,
+          padding: "1px 6px",
+          borderRadius: 999,
+          border: `1px solid ${turbo ? `color-mix(in srgb, ${GOLD_TINT} 60%, ${C.border1})` : C.border1}`,
+          background: turbo ? `color-mix(in srgb, ${GOLD_TINT} 16%, transparent)` : "transparent",
+          color: turbo ? C.label2 : C.label3,
+          cursor: "pointer",
+          ...NUM
+        }
+      }, [
+        import_react.default.createElement("input", {
+          key: "i",
+          type: "checkbox",
+          checked: turbo,
+          onChange: (event) => onTurboChange && onTurboChange(event.target.checked),
+          style: { accentColor: GOLD_TINT, width: 12, height: 12, margin: 0, cursor: "inherit" }
+        }),
+        import_react.default.createElement("span", { key: "l" }, t("turboLabel"))
+      ])
     ]),
     import_react.default.createElement("div", {
       key: "chips",
@@ -1439,6 +1634,13 @@ function SettingsSection(props) {
     import_react.default.createElement("span", { key: "l" }, t(labelKey))
   ]);
   const lunchDisabled = !form.lunchEnabled;
+  const RATE_OPTIONS = [
+    ["1000", t("rateSecond")],
+    ["250", "250 ms"],
+    ["100", "100 ms"],
+    ["50", "50 ms"],
+    ["16", t("rateFrame")]
+  ];
   return import_react.default.createElement("details", {
     open: true,
     style: { background: C.layer1, border: `1px solid ${C.border1}`, borderRadius: 12, padding: "10px 12px" }
@@ -1468,6 +1670,14 @@ function SettingsSection(props) {
         timeRange("lunchStart", "lunchEnd", t("groupLunch"), lunchDisabled),
         toggle("lunchEnabled", "lunchEnabledShort", false),
         toggle("lunchPaid", "lunchPaidShort", lunchDisabled)
+      ]),
+      row("refresh", t("refreshRate"), [
+        import_react.default.createElement("select", {
+          key: "r",
+          value: String(form.updateMs),
+          onChange: (event) => setField("updateMs", event.target.value),
+          style: { ...selectStyle, width: 128, padding: "4px 6px" }
+        }, RATE_OPTIONS.map(([value, label]) => import_react.default.createElement("option", { key: value, value }, label)))
       ])
     ]),
     import_react.default.createElement("div", {
@@ -1505,7 +1715,6 @@ function SettingsSection(props) {
 function NiumaPanel(props) {
   const t = props && typeof props.t === "function" ? props.t : fallbackTranslate;
   const remote = useRemoteConfig();
-  const now = useSecondClock();
   const cfg = import_react.default.useMemo(() => {
     const raw = remote.data && remote.data.config ? remote.data.config : null;
     if (!raw) return DEFAULTS;
@@ -1516,6 +1725,8 @@ function NiumaPanel(props) {
       return DEFAULTS;
     }
   }, [remote.data]);
+  const updateMs = cfg.turbo === true ? 16 : Number.isInteger(cfg.updateMs) ? cfg.updateMs : 1e3;
+  const now = useClock(updateMs);
   const snap = import_react.default.useMemo(() => earnedToday(cfg, now), [cfg, now]);
   const rates = snap && snap.rates ? snap.rates : computeRates(cfg, snap && snap.dateKey);
   const baseForm = import_react.default.useMemo(() => formFromConfig(cfg), [cfg]);
@@ -1605,6 +1816,28 @@ function NiumaPanel(props) {
       setSave({ status: "error", errors: [String(error && error.message || error)], message: "" });
     });
   };
+  const [quickError, setQuickError] = import_react.default.useState("");
+  const postConfig = import_react.default.useCallback((patch) => {
+    if (typeof fetch !== "function") return;
+    fetch(`${ROUTE_BASE}/settings`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      credentials: "same-origin",
+      body: JSON.stringify(patch)
+    }).then(async (response) => {
+      let body = null;
+      try {
+        body = await response.json();
+      } catch (error) {
+        body = null;
+      }
+      if (!response.ok || !body || body.ok !== true) throw new Error(body && body.error || `HTTP ${response.status}`);
+      setQuickError("");
+      remote.refresh();
+    }).catch((error) => setQuickError(String(error && error.message || error)));
+  }, [remote.refresh]);
+  const onDecimalsChange = (value) => postConfig({ decimals: value });
+  const onTurboChange = (checked) => postConfig({ turbo: Boolean(checked) });
   const holidaySource = remote.data && remote.data.holidaySource || HOLIDAY_SOURCE;
   const banner = remote.status === "failed" ? {
     color: C.warn,
@@ -1707,7 +1940,7 @@ function NiumaPanel(props) {
           }
         }, t("retry")) : null
       ]) : null,
-      import_react.default.createElement(HeroCard, { key: "hero", t, snap }),
+      import_react.default.createElement(HeroCard, { key: "hero", t, snap, decimals: cfg.decimals, onDecimalsChange, turbo: cfg.turbo, onTurboChange }),
       import_react.default.createElement(CountdownRow, { key: "countdown", t, snap }),
       import_react.default.createElement("div", {
         key: "ratesHead",