mvframe 1.1.16 → 1.1.17

package/.cursor/rules/util.mdc

@@ -19,6 +19,7 @@ alwaysApply: true
 | 方法 | 用途 |
 |------|------|
 | `$getImg(url)` | 获取图片 URL，支持相对路径和 `/` 开头绝对路径 |
+| `$l(key, vars?)` | 多语言文案；`vars` 支持 `{name}` 变量占位替换 |
 | `$getLang()` | 获取当前语言 |
 | `$d` | **dayjs**：`globalThis.$d` 与默认导出一致；`$d()`、`$d(ts)`、`$d().format(...)`、`$d().add(n, 'day')` 等，勿在业务中重复 `import dayjs`（插件仅在应用入口统一 `extend`） |
 | `$md5(v)` | 提取数字并拼接（简易 md5） |
@@ -46,6 +47,7 @@ alwaysApply: true
 ## 使用建议
 
 - 直接调用全局方法即可，无需在业务代码中 import util
+- 多语言变量统一使用 `$l("helloUser", { name: userName })`，字典文案写作 `"Hello {name}"`；变量名仅使用字母、数字、下划线、点、短横线或 `$`，缺失变量会保留原 `{name}` 占位
 - 新增工具方法时，应挂载到 `globalThis` 并补充到本 rules
 
 ## 全局封装方法的注释规范

package/README.cn.md

@@ -189,12 +189,17 @@ yarn notify
 # 或发布包命令
 yarn exec mvframe-notify
 
-# 同时启动 yarn dev 与通知服务
+# 启动 MVFrame 封装的 Vite dev
 yarn d
 # 或发布包命令
 yarn exec mvframe-d
+
+# 同时启动 Vite dev 与通知服务
+yarn exec mvframe-d -n
 ```
 
+`mvframe-d` 默认只启动封装后的 Vite dev server；追加 `-n` / `--notify` 时才启动通知服务。通知服务启动失败只打印异常，不会停止 Vite。
+
 服务读取宿主项目根目录的 `.env.mvframe-notify`（可用 `--env` 指定）：
 
 ```env
@@ -265,7 +270,7 @@ await notify("需要发送到钉钉的消息");
 
 ## 命令行：项目目录雏形（推荐）
 
-在**空目录或已有 Vite 工程根目录**执行，生成 `src/views`、`src/component`、`src/api`、`src/assets/img`、`src/assets/style`、`src/router`、`src/pinia/chip`、`src/config` 及示例 `main.js` / `App.vue`（已 `app.use(mvframe, …)` 挂好路由、Pinia `storeChips`、config，并写入 `components.async: ["VTable"]`），同时写入/更新宿主项目 **`AGENTS.md`** 的 MVFrame Codex 规则，其中包含 **每次 AI 完成开发后执行 `yarn exec mvframe-notify --once --message "..."` 发送完成通知** 的要求，并复制 **`/.cursor/rules/*.mdc`**（与 mvframe 仓库内 Cursor 规则一致）。若不存在则附带 `index.html` 与 `vite.config.js`。会**合并** `package.json` 的 `scripts` / `dependencies` / `devDependencies`（与 Vite 模板一致；**同名脚本和包保留你原有值**），初始化 `.env.mvframe-notify.example` / `.env.local.example` 与 `config.notify`，并自动执行 **`yarn install`**，最后请执行 **`yarn dev`**；需要同时启动通知服务时显式执行 **`yarn exec mvframe-d`**。加 `--no-package-json` 可不改动 `package.json` 且跳过安装。
+在**空目录或已有 Vite 工程根目录**执行，生成 `src/views`、`src/component`、`src/api`、`src/assets/img`、`src/assets/style`、`src/router`、`src/pinia/chip`、`src/config` 及示例 `main.js` / `App.vue`（已 `app.use(mvframe, …)` 挂好路由、Pinia `storeChips`、config，并写入 `components.async: ["VTable"]`），同时写入/更新宿主项目 **`AGENTS.md`** 的 MVFrame Codex 规则，其中包含 **每次 AI 完成开发后执行 `yarn exec mvframe-notify --once --message "..."` 发送完成通知** 的要求，并复制 **`/.cursor/rules/*.mdc`**（与 mvframe 仓库内 Cursor 规则一致）。若不存在则附带 `index.html` 与 `vite.config.js`。会**合并** `package.json` 的 `scripts` / `dependencies` / `devDependencies`（与 Vite 模板一致；**同名脚本和包保留你原有值**），初始化 `.env.mvframe-notify.example` / `.env.local.example` 与 `config.notify`，并自动执行 **`yarn install`**，最后请执行 **`yarn dev`**；需要同时启动通知服务时显式执行 **`yarn exec mvframe-d -n`**。加 `--no-package-json` 可不改动 `package.json` 且跳过安装。
 
 ```bash
 cd /path/to/your-app
@@ -353,7 +358,7 @@ yarn exec mvframe-install-cursor-skill
 
 - 新增 `mvframe-notify`：只支持钉钉机器人的本地通知服务，钉钉 webhook / secret 留在 Node 环境变量。
 - 新增 `mvframe/notify` 与全局 `$notify`：前端通过 `config.notify` 请求本地通知服务。
-- 新增框架命令 `yarn d` / `mvframe-d`：同时启动 `yarn dev` 与钉钉通知服务。
+- 新增框架命令 `yarn d` / `mvframe-d`：启动 MVFrame 封装的 Vite dev，追加 `-n` 时同时启动钉钉通知服务。
 - `mvframe-init-app` 初始化 `config.notify`、带测试钉钉机器人的 `.env.mvframe-notify` / `.env.mvframe-notify.example` 与 `.env.local.example`，不自动覆盖宿主 `d` 脚本。
 - `VTable` 默认使用异步全局注册；`mvframe-init-app` 会在 `main.js` 写入 `components.async: ["VTable"]`。
 

package/README.md

@@ -189,8 +189,11 @@ yarn exec mvframe-notify
 
 yarn d
 yarn exec mvframe-d
+yarn exec mvframe-d -n
 ```
 
+`mvframe-d` starts the wrapped Vite dev server only. Add `-n` / `--notify` when the notify service should also run; notify startup failures are reported without stopping Vite.
+
 The service reads `.env.mvframe-notify` from the host root:
 
 ```env
@@ -252,7 +255,7 @@ The floating label shell is implemented centrally in `src/style/chip/element.scs
 
 ## CLI: project skeleton
 
-From an **empty folder or existing Vite root**, generates `src/views`, `src/component`, `src/api`, `src/assets/img`, `src/assets/style`, `src/router`, `src/pinia/chip`, `src/config`, plus starter `main.js` / `App.vue` with `app.use(mvframe, …)` (routes, Pinia `storeChips`, config, and `components.async: ["VTable"]`). It also writes/updates host-project **`AGENTS.md`** with MVFrame Codex rules, including a requirement that AI send a completion message with `yarn exec mvframe-notify --once --message "..."` after each finished development task, and copies **`/.cursor/rules/*.mdc`** from the package (same as this repo’s Cursor rules). Adds `index.html` and `vite.config.js` only if missing (use `--force` to overwrite). **Merges** `scripts` / `dependencies` / `devDependencies` into `package.json` (existing values win for shared keys), initializes `.env.mvframe-notify.example` / `.env.local.example` and `config.notify`, then runs **`yarn install`**; use `--no-package-json` to skip package changes and install. Then run **`yarn dev`** or explicitly run **`yarn exec mvframe-d`** to start Vite with the notify service.
+From an **empty folder or existing Vite root**, generates `src/views`, `src/component`, `src/api`, `src/assets/img`, `src/assets/style`, `src/router`, `src/pinia/chip`, `src/config`, plus starter `main.js` / `App.vue` with `app.use(mvframe, …)` (routes, Pinia `storeChips`, config, and `components.async: ["VTable"]`). It also writes/updates host-project **`AGENTS.md`** with MVFrame Codex rules, including a requirement that AI send a completion message with `yarn exec mvframe-notify --once --message "..."` after each finished development task, and copies **`/.cursor/rules/*.mdc`** from the package (same as this repo’s Cursor rules). Adds `index.html` and `vite.config.js` only if missing (use `--force` to overwrite). **Merges** `scripts` / `dependencies` / `devDependencies` into `package.json` (existing values win for shared keys), initializes `.env.mvframe-notify.example` / `.env.local.example` and `config.notify`, then runs **`yarn install`**; use `--no-package-json` to skip package changes and install. Then run **`yarn dev`** or explicitly run **`yarn exec mvframe-d -n`** to start Vite with the notify service.
 
 ```bash
 cd /path/to/your-app
@@ -338,7 +341,7 @@ Default target is **`./.cursor/skills/mvframe-app-init`** under the current work
 
 - Added `mvframe-notify`, a DingTalk-only local Node notification service.
 - Added `mvframe/notify` and global `$notify` for browser calls through `config.notify`.
-- Added framework command `yarn d` / `mvframe-d` to run `yarn dev` with the notify service.
+- Added framework command `yarn d` / `mvframe-d` to run the MVFrame-wrapped Vite dev server; add `-n` to start the notify service too.
 - `mvframe-init-app` now initializes `config.notify`, `.env.mvframe-notify` / `.env.mvframe-notify.example` with the MVFrame test DingTalk robot, and `.env.local.example` without forcing host `d` scripts.
 - `VTable` now uses async global registration by default; `mvframe-init-app` writes `components.async: ["VTable"]` in `main.js`.
 

package/dist/composition.js

@@ -1,114 +1,112 @@
-import { M as q, g as D, s as z } from "./vendor.js";
-import { a as je, m as Ue, b as Be, c as Ne, p as Fe, u as We } from "./vendor.js";
-import H from "axios";
-const G = "lang", Se = (e, t) => {
+import { M as z, g as D, s as G } from "./vendor.js";
+import { a as Ve, m as Ue, b as Be, c as Ne, p as Fe, u as We } from "./vendor.js";
+import j from "axios";
+const Y = "lang", Se = (e, t) => {
   var i, a;
   const n = typeof window < "u", r = () => {
-    var p;
+    var d;
     if (!n)
       return { innerWidth: 1920, innerHeight: 1080 };
-    const o = window, l = typeof navigator < "u" ? o.navigator : {}, u = o.screen || {}, m = o.visualViewport, c = {
-      innerWidth: o.innerWidth,
-      innerHeight: o.innerHeight,
-      outerWidth: o.outerWidth,
-      outerHeight: o.outerHeight,
-      screenWidth: u.width ?? o.innerWidth,
-      screenHeight: u.height ?? o.innerHeight,
-      availWidth: u.availWidth ?? o.innerWidth,
-      availHeight: u.availHeight ?? o.innerHeight,
-      devicePixelRatio: o.devicePixelRatio || 1,
-      bodyHeight: o.innerHeight - ((p = t.pinia) != null && p.useTab ? 36 : 0) - 64 - 32,
-      drawerHeight: parseInt(o.innerHeight * 0.9),
-      pageHeight: o.innerHeight - 64 - 32,
-      pageWidth: o.innerWidth
+    const s = window, l = typeof navigator < "u" ? s.navigator : {}, u = s.screen || {}, p = s.visualViewport, h = {
+      innerWidth: s.innerWidth,
+      innerHeight: s.innerHeight,
+      outerWidth: s.outerWidth,
+      outerHeight: s.outerHeight,
+      screenWidth: u.width ?? s.innerWidth,
+      screenHeight: u.height ?? s.innerHeight,
+      availWidth: u.availWidth ?? s.innerWidth,
+      availHeight: u.availHeight ?? s.innerHeight,
+      devicePixelRatio: s.devicePixelRatio || 1,
+      bodyHeight: s.innerHeight - ((d = t.pinia) != null && d.useTab ? 36 : 0) - 64 - 32,
+      drawerHeight: parseInt(s.innerHeight * 0.9),
+      pageHeight: s.innerHeight - 64 - 32,
+      pageWidth: s.innerWidth
     };
-    m && (c.visualViewportWidth = m.width, c.visualViewportHeight = m.height, c.visualViewportScale = m.scale);
-    const f = l.userAgent || "";
-    return c.env = {
-      userAgent: f,
+    p && (h.visualViewportWidth = p.width, h.visualViewportHeight = p.height, h.visualViewportScale = p.scale);
+    const c = l.userAgent || "";
+    return h.env = {
+      userAgent: c,
       language: l.language || "",
       languages: l.languages ? [...l.languages] : [],
       platform: l.platform || "",
       cookieEnabled: !!l.cookieEnabled,
       onLine: l.onLine !== !1,
       maxTouchPoints: l.maxTouchPoints || 0,
-      isTouch: "ontouchstart" in o || (l.maxTouchPoints || 0) > 0,
+      isTouch: "ontouchstart" in s || (l.maxTouchPoints || 0) > 0,
       isMobile: /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini|Mobile/i.test(
-        f
+        c
       )
-    }, console.info(c), c;
-  }, s = () => {
+    }, console.info(h), h;
+  }, o = () => {
     var l;
-    const o = r();
+    const s = r();
     globalThis.$config = globalThis.$config || {}, globalThis.$config.options = {
       ...globalThis.$config.options || {},
-      ...o
+      ...s
     }, (l = e == null ? void 0 : e.config) != null && l.globalProperties && (e.config.globalProperties.$config = globalThis.$config);
   };
-  s(), n && (window.addEventListener("resize", s, { passive: !0 }), (a = (i = window.visualViewport) == null ? void 0 : i.addEventListener) == null || a.call(i, "resize", s, {
+  o(), n && (window.addEventListener("resize", o, { passive: !0 }), (a = (i = window.visualViewport) == null ? void 0 : i.addEventListener) == null || a.call(i, "resize", o, {
     passive: !0
   }));
 }, Ae = (e, t) => {
-  var l, u, m;
-  const n = t || {}, r = Array.isArray(n.use) && n.use.length > 0 ? n.use : q;
+  var u, p, h;
+  const n = t || {}, r = Array.isArray(n.use) && n.use.length > 0 ? n.use : z;
   globalThis.$config = globalThis.$config || {}, globalThis.$config.langUse = r.filter(
     (c) => c && c.use !== !1 && c.value
-  ), (l = e == null ? void 0 : e.config) != null && l.globalProperties && (e.config.globalProperties.$config = globalThis.$config);
-  const i = (typeof localStorage < "u" ? localStorage.getItem(G) : null) || ((u = globalThis.$config) == null ? void 0 : u.lang) || "en_us", a = Object.assign(
+  ), (u = e == null ? void 0 : e.config) != null && u.globalProperties && (e.config.globalProperties.$config = globalThis.$config);
+  const i = (typeof localStorage < "u" ? localStorage.getItem(Y) : null) || ((p = globalThis.$config) == null ? void 0 : p.lang) || "en_us", a = Object.assign(
     {},
     D(i),
-    ((m = globalThis.$config) == null ? void 0 : m.langMaps) || {},
+    ((h = globalThis.$config) == null ? void 0 : h.langMaps) || {},
     n.langMaps || {}
-  ), o = (c, f) => {
-    if (c)
-      if (f && globalThis.$getType(f) === "Object") {
-        let p = a[c] || c;
-        return Object.keys(f).forEach((d) => {
-          p[`{${d}}`] = f[d];
-        }), p;
-      } else
-        return a[c] || c;
-    else
+  ), s = (c, d) => !d || globalThis.$getType(d) !== "Object" ? c : String(c).replace(
+    /\{([A-Za-z0-9_.$-]+)\}/g,
+    (m, C) => Object.prototype.hasOwnProperty.call(d, C) ? d[C] : m
+  ), l = (c, d) => {
+    if (c) {
+      const m = a[c] || c;
+      return s(m, d);
+    } else
       return c ?? "";
   };
   globalThis.$patchLangMaps = (c) => {
     c && globalThis.$getType(c) === "Object" && Object.assign(a, c);
-  }, globalThis.$l = o, e.config.globalProperties.$l = o, e.config.globalProperties.$patchLangMaps = globalThis.$patchLangMaps, String.prototype.$l = function() {
+  }, globalThis.$l = l, e.config.globalProperties.$l = l, e.config.globalProperties.$patchLangMaps = globalThis.$patchLangMaps, String.prototype.$l = function() {
     return $l(this);
   };
-}, $e = (e, t) => {
+}, Le = (e, t) => {
   if (!e || !t) return !1;
-  const n = e.getBoundingClientRect(), r = t.getBoundingClientRect(), s = r.right > n.left && r.left < n.right, i = r.bottom > n.top && r.top < n.bottom;
-  return s && i;
-}, Y = (e, t) => {
+  const n = e.getBoundingClientRect(), r = t.getBoundingClientRect(), o = r.right > n.left && r.left < n.right, i = r.bottom > n.top && r.top < n.bottom;
+  return o && i;
+}, K = (e, t) => {
   if (e === t) return !0;
   if (e == null || t == null || typeof e != "object" || typeof t != "object")
     return JSON.stringify(e) === JSON.stringify(t);
   const n = Object.keys(e), r = Object.keys(t);
   if (n.length !== r.length) return !1;
-  for (const s of n)
-    if (!r.includes(s) || !Y(e[s], t[s])) return !1;
+  for (const o of n)
+    if (!r.includes(o) || !K(e[o], t[o])) return !1;
   return !0;
-}, x = "download", K = 150, X = (e, t = x) => {
-  const n = t || x, r = String(e ?? "").trim();
+}, O = "download", X = 150, J = (e, t = O) => {
+  const n = t || O, r = String(e ?? "").trim();
   if (!r) return n;
   const i = r.replace(/[/\\?%*:|"<>]/g, "_").replace(/\.\./g, "_").split(/[/\\]/).pop() || n, a = 200;
   return i.length > a ? i.slice(0, a) : i;
-}, J = (e) => {
+}, Z = (e) => {
   const t = ((e == null ? void 0 : e.type) || "").toLowerCase();
   return t ? t.includes("spreadsheet") || t.includes("ms-excel") || t.includes("excel") && t.includes("application") : !1;
 }, S = (e, t) => {
-  const n = URL.createObjectURL(e), r = X(t), s = document.createElement("a");
-  s.href = n, s.download = r, s.style.display = "none", document.body.appendChild(s);
+  const n = URL.createObjectURL(e), r = J(t), o = document.createElement("a");
+  o.href = n, o.download = r, o.style.display = "none", document.body.appendChild(o);
   try {
-    s.click();
+    o.click();
   } finally {
-    document.body.removeChild(s), setTimeout(() => URL.revokeObjectURL(n), K);
+    document.body.removeChild(o), setTimeout(() => URL.revokeObjectURL(n), X);
   }
 }, Q = (e) => {
   if (!e || e.source !== void 0 || e.type === void 0)
     return e;
-  const { type: t, data: n, url: r, headers: s, name: i, filename: a, init: o, ...l } = e, u = a ?? i;
+  const { type: t, data: n, url: r, headers: o, name: i, filename: a, init: s, ...l } = e, u = a ?? i;
   return t === "csv" ? {
     ...l,
     source: "inline",
@@ -119,100 +117,100 @@ const G = "lang", Se = (e, t) => {
     ...l,
     source: "fetch",
     url: r,
-    init: { ...o || {}, headers: s ?? (o == null ? void 0 : o.headers) },
+    init: { ...s || {}, headers: o ?? (s == null ? void 0 : s.headers) },
     response: "blob",
     expectExcel: !0,
     filename: u
   } : e;
-}, Le = async (e = {}) => {
+}, $e = async (e = {}) => {
   const t = Q(e), {
     source: n = "inline",
     content: r,
-    blob: s,
+    blob: o,
     bom: i = !0,
     mime: a,
-    url: o,
+    url: s,
     init: l,
     response: u = "blob",
-    openIn: m = "self",
-    expectExcel: c,
-    filename: f,
-    name: p,
-    error: d = () => {
+    openIn: p = "self",
+    expectExcel: h,
+    filename: c,
+    name: d,
+    error: m = () => {
     },
     // 避免 legacy 字段渗入后续逻辑
-    type: _e,
+    type: C,
     data: Te,
     headers: we,
     ...Me
-  } = t, M = f ?? p;
+  } = t, M = c ?? d;
   try {
     if (n === "inline") {
-      if (s instanceof Blob) {
-        S(s, M);
+      if (o instanceof Blob) {
+        S(o, M);
         return;
       }
       if (r == null) {
-        d(new Error("content or blob is required for inline"));
+        m(new Error("content or blob is required for inline"));
         return;
       }
-      const h = typeof r == "string" ? r : String(r), v = i ? "\uFEFF" + h : h, R = a || (i ? "text/csv;charset=utf-8" : "text/plain;charset=utf-8");
-      S(new Blob([v], { type: R }), M);
+      const f = typeof r == "string" ? r : String(r), R = i ? "\uFEFF" + f : f, v = a || (i ? "text/csv;charset=utf-8" : "text/plain;charset=utf-8");
+      S(new Blob([R], { type: v }), M);
       return;
     }
     if (n === "fetch") {
-      if (!o) {
-        d(new Error("url is required for fetch"));
+      if (!s) {
+        m(new Error("url is required for fetch"));
         return;
       }
-      const h = await fetch(o, l);
-      if (!h.ok) {
-        d(new Error(`fetch failed: ${h.status}`));
+      const f = await fetch(s, l);
+      if (!f.ok) {
+        m(new Error(`fetch failed: ${f.status}`));
         return;
       }
       if (u === "text") {
-        const R = await h.text(), F = i ? "\uFEFF" + R : R, W = a || (i ? "text/csv;charset=utf-8" : "text/plain;charset=utf-8");
-        S(new Blob([F], { type: W }), M);
+        const v = await f.text(), W = i ? "\uFEFF" + v : v, q = a || (i ? "text/csv;charset=utf-8" : "text/plain;charset=utf-8");
+        S(new Blob([W], { type: q }), M);
         return;
       }
-      const v = await h.blob();
-      if (c && !J(v)) {
-        d(new Error("excel does not exist"));
+      const R = await f.blob();
+      if (h && !Z(R)) {
+        m(new Error("excel does not exist"));
         return;
       }
-      S(v, M);
+      S(R, M);
       return;
     }
     if (n === "open") {
-      if (!o) {
-        d(new Error("url is required for open"));
+      if (!s) {
+        m(new Error("url is required for open"));
         return;
       }
-      m === "blank" ? window.open(o, "_blank", "noopener,noreferrer") : window.location.href = o;
+      p === "blank" ? window.open(s, "_blank", "noopener,noreferrer") : window.location.href = s;
       return;
     }
-    d(new Error(`unknown source: ${n}`));
-  } catch (h) {
-    d(h instanceof Error ? h : new Error(String(h)));
+    m(new Error(`unknown source: ${n}`));
+  } catch (f) {
+    m(f instanceof Error ? f : new Error(String(f)));
   }
 };
-function Z(e, t, n) {
+function ee(e, t, n) {
   if (t === "" || t === void 0 || t === null)
     return "";
-  const r = globalThis.$fa, s = globalThis.$fu, i = (n == null ? void 0 : n.precision) ?? 2, a = n == null ? void 0 : n.unit;
-  if ((a === "currency" || a === "%") && s) {
-    const o = {
+  const r = globalThis.$fa, o = globalThis.$fu, i = (n == null ? void 0 : n.precision) ?? 2, a = n == null ? void 0 : n.unit;
+  if ((a === "currency" || a === "%") && o) {
+    const s = {
       [e]: {
         unit: a === "currency" ? "currency" : "%",
         precision: i
       }
     };
     try {
-      return s({
+      return o({
         prop: e,
         currency: n == null ? void 0 : n.currency,
         value: t,
-        obj: o
+        obj: s
       });
     } catch {
     }
@@ -226,33 +224,33 @@ function Z(e, t, n) {
   return String(t);
 }
 function Pe(e, t, n = {}) {
-  const { columns: r = [] } = e || {}, { resolveMetric: s } = n;
+  const { columns: r = [] } = e || {}, { resolveMetric: o } = n;
   return !r.length || !t || typeof t != "object" ? [] : r.map((i) => {
     const a = i.property ?? i.prop ?? "";
     if (!a)
       return "";
-    let o = t[a];
-    if (o === void 0 && (o = ""), o === "")
+    let s = t[a];
+    if (s === void 0 && (s = ""), s === "")
       return "";
-    const l = typeof s == "function" ? s(a) : void 0;
+    const l = typeof o == "function" ? o(a) : void 0;
     try {
-      return Z(a, o, l);
+      return ee(a, s, l);
     } catch {
-      return String(o);
+      return String(s);
     }
   });
 }
-const C = "mvframe_primary", V = "mvframe_theme", I = "mvframe_theme_name", ee = "dark", A = "main", $ = "mv-theme-", T = { r: 255, g: 255, b: 255 }, te = { r: 0, g: 0, b: 0 }, j = [1, 3, 5, 7, 9], ne = [
+const I = "mvframe_primary", V = "mvframe_theme", x = "mvframe_theme_name", te = "dark", A = "main", L = "mv-theme-", T = { r: 255, g: 255, b: 255 }, ne = { r: 0, g: 0, b: 0 }, U = [1, 3, 5, 7, 9], re = [
   "--el-color-primary-light-3",
   "--el-color-primary-light-5",
   "--el-color-primary-light-7",
   "--el-color-primary-light-8",
   "--el-color-primary-light-9",
   "--el-color-primary-dark-2"
-], re = j.map(
+], oe = U.map(
   (e) => `--color-primary${e}`
 );
-function L(e) {
+function $(e) {
   let t = String(e).trim().replace(/^#/, "");
   if (t.length === 3 && (t = t.split("").map((r) => r + r).join("")), t.length >= 8 && (t = t.slice(0, 6)), t.length !== 6 || Number.isNaN(parseInt(t, 16)))
     return null;
@@ -264,122 +262,122 @@ function L(e) {
   };
 }
 function y(e, t, n) {
-  const r = (s) => Math.max(0, Math.min(255, Math.round(s)));
-  return `#${[r(e), r(t), r(n)].map((s) => s.toString(16).padStart(2, "0")).join("")}`;
+  const r = (o) => Math.max(0, Math.min(255, Math.round(o)));
+  return `#${[r(e), r(t), r(n)].map((o) => o.toString(16).padStart(2, "0")).join("")}`;
 }
-function U(e, t, n, r) {
-  const s = (a) => Math.max(0, Math.min(255, Math.round(a))), i = Math.max(0, Math.min(1, r));
-  return `rgba(${s(e)}, ${s(t)}, ${s(n)}, ${i})`;
+function B(e, t, n, r) {
+  const o = (a) => Math.max(0, Math.min(255, Math.round(a))), i = Math.max(0, Math.min(1, r));
+  return `rgba(${o(e)}, ${o(t)}, ${o(n)}, ${i})`;
 }
 function se(e) {
   const t = [e.r, e.g, e.b].map((n) => (n /= 255, n <= 0.03928 ? n / 12.92 : ((n + 0.055) / 1.055) ** 2.4));
   return 0.2126 * t[0] + 0.7152 * t[1] + 0.0722 * t[2];
 }
-function B(e) {
+function N(e) {
   return se(e) > 0.5 ? "#1a1a1a" : "#ffffff";
 }
 function b(e, t, n) {
-  const r = n / 100, s = 1 - r;
+  const r = n / 100, o = 1 - r;
   return {
-    r: e.r * r + t.r * s,
-    g: e.g * r + t.g * s,
-    b: e.b * r + t.b * s
+    r: e.r * r + t.r * o,
+    g: e.g * r + t.g * o,
+    b: e.b * r + t.b * o
   };
 }
-function oe(e, t = "light") {
-  const n = L(e);
+function ie(e, t = "light") {
+  const n = $(e);
   if (!n)
     return null;
-  const r = b(T, n, 30), s = b(T, n, 50), i = b(T, n, 70), a = b(T, n, 80), o = b(T, n, 90), l = b(te, n, 20);
+  const r = b(T, n, 30), o = b(T, n, 50), i = b(T, n, 70), a = b(T, n, 80), s = b(T, n, 90), l = b(ne, n, 20);
   return {
     "--el-color-primary-light-3": y(r.r, r.g, r.b),
-    "--el-color-primary-light-5": y(s.r, s.g, s.b),
-    "--el-color-primary-light-7": t === "dark" ? U(n.r, n.g, n.b, 0.7) : y(i.r, i.g, i.b),
+    "--el-color-primary-light-5": y(o.r, o.g, o.b),
+    "--el-color-primary-light-7": t === "dark" ? B(n.r, n.g, n.b, 0.7) : y(i.r, i.g, i.b),
     "--el-color-primary-light-8": y(a.r, a.g, a.b),
-    "--el-color-primary-light-9": y(o.r, o.g, o.b),
+    "--el-color-primary-light-9": y(s.r, s.g, s.b),
     "--el-color-primary-dark-2": y(l.r, l.g, l.b)
   };
 }
-function ie(e) {
-  const t = L(e);
+function ae(e) {
+  const t = $(e);
   return t ? Object.fromEntries(
-    j.map((n) => [
+    U.map((n) => [
       `--color-primary${n}`,
-      U(t.r, t.g, t.b, n / 10)
+      B(t.r, t.g, t.b, n / 10)
     ])
   ) : null;
 }
-function ae(e) {
+function le(e) {
   e.style.removeProperty("--el-color-primary"), e.style.removeProperty("--color-on-primary-text");
-  for (const t of re)
+  for (const t of oe)
     e.style.removeProperty(t);
-  for (const t of ne)
+  for (const t of re)
     e.style.removeProperty(t);
 }
-function N(e) {
+function F(e) {
   const t = String(e ?? "").trim().toLowerCase();
   return t && t.replace(/[^a-z0-9_-]/g, "-").replace(/-+/g, "-") || A;
 }
-function le(e) {
+function ce(e) {
   const t = [...e.classList].find(
-    (n) => n.startsWith($)
+    (n) => n.startsWith(L)
   );
-  return t ? t.slice($.length) : A;
-}
-function ce(e) {
-  [...e.classList].filter((t) => t.startsWith($)).forEach((t) => e.classList.remove(t));
+  return t ? t.slice(L.length) : A;
 }
 function ue(e) {
-  return e.classList.contains("light") ? "light" : e.classList.contains("dark") ? "dark" : ee;
+  [...e.classList].filter((t) => t.startsWith(L)).forEach((t) => e.classList.remove(t));
+}
+function he(e) {
+  return e.classList.contains("light") ? "light" : e.classList.contains("dark") ? "dark" : te;
 }
-function he(e, t) {
-  const n = N(t);
-  return ce(e), e.classList.add(`${$}${n}`), n;
+function de(e, t) {
+  const n = F(t);
+  return ue(e), e.classList.add(`${L}${n}`), n;
 }
-function de(e, t, n = "light") {
-  const r = L(t.startsWith("#") ? t : `#${t}`);
+function me(e, t, n = "light") {
+  const r = $(t.startsWith("#") ? t : `#${t}`);
   if (!r)
     return !1;
-  const s = y(r.r, r.g, r.b);
-  e.style.setProperty("--color-primary", s), e.style.setProperty("--el-color-primary", s), e.style.setProperty("--color-on-primary-text", B(r));
-  const i = ie(s);
-  i && Object.entries(i).forEach(([o, l]) => e.style.setProperty(o, l));
-  const a = oe(s, n);
-  return a && Object.entries(a).forEach(([o, l]) => e.style.setProperty(o, l)), !0;
+  const o = y(r.r, r.g, r.b);
+  e.style.setProperty("--color-primary", o), e.style.setProperty("--el-color-primary", o), e.style.setProperty("--color-on-primary-text", N(r));
+  const i = ae(o);
+  i && Object.entries(i).forEach(([s, l]) => e.style.setProperty(s, l));
+  const a = ie(o, n);
+  return a && Object.entries(a).forEach(([s, l]) => e.style.setProperty(s, l)), !0;
 }
-function me(e = {}) {
-  const t = document.documentElement, n = (e.mode ?? ue(t)) === "light" ? "light" : "dark", r = e.theme ?? le(t);
-  if (he(t, r), e.primary != null && e.primary !== "") {
-    const s = String(e.primary).trim();
-    if (!de(t, s, n)) {
-      t.style.setProperty("--color-primary", s), t.style.setProperty("--el-color-primary", s);
-      const i = L(s.startsWith("#") ? s : `#${s}`);
-      i && t.style.setProperty("--color-on-primary-text", B(i));
+function fe(e = {}) {
+  const t = document.documentElement, n = (e.mode ?? he(t)) === "light" ? "light" : "dark", r = e.theme ?? ce(t);
+  if (de(t, r), e.primary != null && e.primary !== "") {
+    const o = String(e.primary).trim();
+    if (!me(t, o, n)) {
+      t.style.setProperty("--color-primary", o), t.style.setProperty("--el-color-primary", o);
+      const i = $(o.startsWith("#") ? o : `#${o}`);
+      i && t.style.setProperty("--color-on-primary-text", N(i));
     }
-  } else (e.primary === null || e.primary === "") && (t.style.removeProperty("--color-primary"), ae(t));
+  } else (e.primary === null || e.primary === "") && (t.style.removeProperty("--color-primary"), le(t));
   t.classList.toggle("light", n === "light"), t.classList.toggle("dark", n === "dark");
 }
 function Ce(e) {
-  e.primary !== void 0 && (e.primary == null || e.primary === "" ? localStorage.removeItem(C) : localStorage.setItem(C, String(e.primary))), e.mode !== void 0 && localStorage.setItem(V, e.mode), e.theme !== void 0 && (e.theme == null || e.theme === "" ? localStorage.removeItem(I) : localStorage.setItem(
-    I,
-    N(e.theme)
+  e.primary !== void 0 && (e.primary == null || e.primary === "" ? localStorage.removeItem(I) : localStorage.setItem(I, String(e.primary))), e.mode !== void 0 && localStorage.setItem(V, e.mode), e.theme !== void 0 && (e.theme == null || e.theme === "" ? localStorage.removeItem(x) : localStorage.setItem(
+    x,
+    F(e.theme)
   ));
 }
 function Ie() {
-  var s;
-  const e = localStorage.getItem(C), t = localStorage.getItem(V), n = localStorage.getItem(I) || ((s = globalThis.$config) == null ? void 0 : s.theme) || A, r = t === "light" ? "light" : "dark";
-  me({
+  var o;
+  const e = localStorage.getItem(I), t = localStorage.getItem(V), n = localStorage.getItem(x) || ((o = globalThis.$config) == null ? void 0 : o.theme) || A, r = t === "light" ? "light" : "dark";
+  fe({
     primary: e != null && e !== "" ? e : null,
     mode: r,
     theme: n
   });
 }
-const fe = { BASE_URL: "/", DEV: !1, MODE: "production", PROD: !0, SSR: !1 };
+const pe = { BASE_URL: "/", DEV: !1, MODE: "production", PROD: !0, SSR: !1 };
 let w = null;
-function O(e) {
-  z("error", e);
+function H(e) {
+  G("error", e);
 }
-function ke(e) {
+function xe(e) {
   w = e && typeof e == "object" ? e : null;
 }
 function P(e) {
@@ -388,15 +386,15 @@ function P(e) {
   const t = typeof globalThis < "u" ? globalThis.__MVFRAME_ENV__ : null;
   if (t && t[e] != null && t[e] !== "")
     return String(t[e]);
-  const n = typeof import.meta < "u" ? fe : null;
+  const n = typeof import.meta < "u" ? pe : null;
   return n && n[e] != null && n[e] !== "" ? String(n[e]) : "";
 }
-const _ = H.create({
+const _ = j.create({
   timeout: 0,
   withCredentials: !1
 });
 let g = [];
-const ge = H.CancelToken, pe = (e) => {
+const ge = j.CancelToken, ye = (e) => {
   const t = e.url + "_" + e.headers["Content-HI"] + "_" + e.ex, n = [];
   if (g.length)
     for (let r in g)
@@ -415,8 +413,8 @@ const ge = H.CancelToken, pe = (e) => {
 _.interceptors.request.use(
   (e) => {
     e.headers = e.headers || {};
-    const { login: t, accountInfo: n = {} } = window.$store.launch(), { access_token: r } = t.info, s = e.noaccount === !0 || e.noAccount === !0;
-    return r && e.headers["Content-HI"] && (e.headers.Authorization = `Bearer ${r}`), n.partner_org_id && !s && (e.data ? e.method.toLowerCase() === "get" ? e.params.accountId = n.partner_org_id : e.data.accountId = n.partner_org_id : e.method.toLowerCase() === "get" ? e.params = { accountId: n.partner_org_id } : e.data = { accountId: n.partner_org_id }), pe(e), e.cancelToken = new ge((i) => {
+    const { login: t, accountInfo: n = {} } = window.$store.launch(), { access_token: r } = t.info, o = e.noaccount === !0 || e.noAccount === !0;
+    return r && e.headers["Content-HI"] && (e.headers.Authorization = `Bearer ${r}`), n.partner_org_id && !o && (e.data ? e.method.toLowerCase() === "get" ? e.params.accountId = n.partner_org_id : e.data.accountId = n.partner_org_id : e.method.toLowerCase() === "get" ? e.params = { accountId: n.partner_org_id } : e.data = { accountId: n.partner_org_id }), ye(e), e.cancelToken = new ge((i) => {
       g.push({
         v: e.url + "_" + e.headers["Content-HI"] + "_" + e.ex,
         cb: i
@@ -430,17 +428,17 @@ _.interceptors.response.use(
     var i;
     if (e == null || typeof e != "object" || Array.isArray(e))
       return E(t), e;
-    let { code: n, message: r, msg: s } = e;
-    if (s = s || r, n === 200)
+    let { code: n, message: r, msg: o } = e;
+    if (o = o || r, n === 200)
       E(t);
     else if (n === 500) {
       if (t.showMsg !== !1) {
         const a = (i = t == null ? void 0 : t.headers) != null && i.CONTACT_CUSTOMER_SERVICE ? window.$l("CONTACT_CUSTOMER_SERVICE") : "";
-        O({
+        H({
           grouping: !0,
           showClose: !0,
           duration: 0,
-          message: [s, a].filter(Boolean).join(" ")
+          message: [o, a].filter(Boolean).join(" ")
         });
       }
       E(t);
@@ -448,7 +446,7 @@ _.interceptors.response.use(
     return e;
   },
   (e) => {
-    var n, r, s, i, a;
+    var n, r, o, i, a;
     let t = !1;
     if (e && e.response)
       switch (e.response.status) {
@@ -469,33 +467,33 @@ _.interceptors.response.use(
       }
     else
       (n = e.stack) != null && n.includes("timeout") ? e.message = window.$l("Timeout, Please Refresh") : (e.message = window.$l("Connect Failed"), t = !0);
-    return t || ((r = e == null ? void 0 : e.response) == null ? void 0 : r.status) !== 403 && O({
+    return t || ((r = e == null ? void 0 : e.response) == null ? void 0 : r.status) !== 403 && H({
       grouping: !0,
-      message: `${e.message} ${(i = (s = e.config) == null ? void 0 : s.headers) == null ? void 0 : i["Content-HI"]}`
+      message: `${e.message} ${(i = (o = e.config) == null ? void 0 : o.headers) == null ? void 0 : i["Content-HI"]}`
     }), E(e.config), e.code === "ERR_CANCELED" ? Promise.resolve({ code: e.code, msg: e.message }) : Promise.resolve({
       code: (a = e.response) == null ? void 0 : a.status,
       msg: e.message
     });
   }
 );
-function ye(e) {
+function be(e) {
   return e.baseURL = P("VITE_APP_BASEURL"), e.method = "get", e.headers = { "Content-Type": "application/x-www-form-urlencoded" }, e.data && (e.params = e.data), _(e);
 }
-function be(e) {
+function Ee(e) {
   return e.baseURL = P("VITE_APP_BASEURL"), e.method = "get", e.headers = {
     ...e.headers,
     "Content-HI": e.url
   }, e.url = e.ver ? `api/${e.ver}/ads` : "api/v3/ads", e.data && (e.params = e.data), _(e);
 }
-function Ee(e) {
+function _e(e) {
   if (e.baseURL = P("VITE_APP_BASEURL"), e.method = "post", e.headers = {
     ...e.headers,
     "Content-HI": e.url
   }, e.data && window.$getType(e.data) === "Object") {
     const n = {};
     Object.keys(e.data).forEach((r) => {
-      const s = e.data[r];
-      [null, "", void 0].includes(s) || (n[r] = s);
+      const o = e.data[r];
+      [null, "", void 0].includes(o) || (n[r] = o);
     }), e.data = n;
   }
   return e.url = e.ver ? `api/${e.ver}/ads` : "api/v3/ads", _(e);
@@ -505,13 +503,13 @@ function k({
   url: t,
   ex: n,
   method: r = "post",
-  emptyString: s = !1
+  emptyString: o = !1
 }) {
   const i = {}, a = [void 0, null];
-  s === !1 && a.push("");
+  o === !1 && a.push("");
   for (let u in e)
     a.indexOf(e[u]) === -1 && (i[u] = e[u]);
-  const { login: o } = window.$store.launch(), { access_token: l } = o.info || {};
+  const { login: s } = window.$store.launch(), { access_token: l } = s.info || {};
   return _({
     headers: {
       "Content-Type": "application/json",
@@ -524,40 +522,40 @@ function k({
     ex: n
   });
 }
-const xe = k;
+const ke = k;
 function Oe(e) {
-  globalThis.$login = ye, globalThis.$get = be, globalThis.$post = Ee, globalThis.$form = k, globalThis.$xform = k;
+  globalThis.$login = be, globalThis.$get = Ee, globalThis.$post = _e, globalThis.$form = k, globalThis.$xform = k;
 }
 export {
-  ee as MVFRAME_DEFAULT_THEME_MODE,
+  te as MVFRAME_DEFAULT_THEME_MODE,
   A as MVFRAME_DEFAULT_THEME_NAME,
-  G as MVFRAME_STORAGE_LANG,
-  C as MVFRAME_STORAGE_PRIMARY,
+  Y as MVFRAME_STORAGE_LANG,
+  I as MVFRAME_STORAGE_PRIMARY,
   V as MVFRAME_STORAGE_THEME,
-  I as MVFRAME_STORAGE_THEME_NAME,
-  $ as MVFRAME_THEME_CLASS_PREFIX,
-  me as applyMvframeTheme,
-  Y as deepEqual,
-  Le as download,
-  Z as formatSummaryCell,
-  je as getMaps,
+  x as MVFRAME_STORAGE_THEME_NAME,
+  L as MVFRAME_THEME_CLASS_PREFIX,
+  fe as applyMvframeTheme,
+  K as deepEqual,
+  $e as download,
+  ee as formatSummaryCell,
+  Ve as getMaps,
   Oe as installRq,
-  $e as isInView,
+  Le as isInView,
   Ie as loadMvframeTheme,
   Ue as mapLang,
   Be as mapLangPath,
   Ne as mergeMaps,
   Fe as patchMaps,
   Ce as persistMvframeTheme,
-  X as sanitizeDownloadFileName,
-  ke as setMvframeRqEnv,
+  J as sanitizeDownloadFileName,
+  xe as setMvframeRqEnv,
   k as useForm,
-  be as useGet,
+  Ee as useGet,
   Ae as useLang,
-  ye as useLogin,
+  be as useLogin,
   We as useMap,
   Se as useOptions,
-  Ee as usePost,
+  _e as usePost,
   Pe as useRemoteSummary,
-  xe as useXform
+  ke as useXform
 };

package/dist/vendor.js

@@ -13917,7 +13917,7 @@ const Hr = (a, o = {}) => {
 }, Jr = {
   name: "Matt Avias Frame",
   copyright: "©2026",
-  version: "1.1.16",
+  version: "1.1.17",
   author: "Matt Avias",
   date: "2026-02-26",
   /** 默认语言 key，与 `$getLang`、localStorage `lang` 一致；业务在 app.use(mvframe, { config }) 里覆盖 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mvframe",
   "packageManager": "yarn@4.4.1",
-  "version": "1.1.16",
+  "version": "1.1.17",
   "author": "matt avis",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/scripts/dev-with-notify.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Run Vite and the MVFrame DingTalk notify service together.
+ * Run Vite, optionally with the MVFrame DingTalk notify service.
  * This mirrors `mvframe-b`: the package owns the command, the host may opt in
  * with `yarn exec mvframe-d` or a local script.
  */
@@ -10,13 +10,29 @@ const path = require("path");
 const children = new Set();
 let shuttingDown = false;
 
+function parseArgs(argv) {
+  const notifyArgs = [];
+  let shouldStartNotify = false;
+
+  for (const arg of argv) {
+    if (arg === "-n" || arg === "--notify") {
+      shouldStartNotify = true;
+      continue;
+    }
+    notifyArgs.push(arg);
+  }
+
+  return { notifyArgs, shouldStartNotify };
+}
+
 function spawnChild(name, command, args, options = {}) {
+  const { optional = false, ...spawnOptions } = options;
   const child = spawn(command, args, {
     cwd: process.cwd(),
     env: process.env,
     stdio: "inherit",
     shell: false,
-    ...options,
+    ...spawnOptions,
   });
 
   children.add(child);
@@ -24,13 +40,28 @@ function spawnChild(name, command, args, options = {}) {
   child.on("exit", (code, signal) => {
     children.delete(child);
     if (shuttingDown) return;
+
+    if (optional) {
+      if (code !== 0) {
+        console.error(`[mvframe-d] ${name} exited with ${signal || code}; vite will keep running`);
+      }
+      return;
+    }
+
     if (code !== 0) {
       console.error(`[mvframe-d] ${name} exited with ${signal || code}`);
       shutdown(code || 1);
+      return;
     }
+    shutdown(0);
   });
 
   child.on("error", (error) => {
+    if (optional) {
+      children.delete(child);
+      console.error(`[mvframe-d] failed to start ${name}: ${error.message}; vite will keep running`);
+      return;
+    }
     console.error(`[mvframe-d] failed to start ${name}: ${error.message}`);
     shutdown(1);
   });
@@ -52,9 +83,14 @@ function shutdown(code = 0) {
 process.on("SIGINT", () => shutdown(0));
 process.on("SIGTERM", () => shutdown(0));
 
-const notifyArgs = process.argv.slice(2);
+const { notifyArgs, shouldStartNotify } = parseArgs(process.argv.slice(2));
 const notifyScript = path.join(__dirname, "notify-server.js");
 const viteScript = path.join(__dirname, "dev-vite-server.js");
 
-spawnChild("notify", process.execPath, [notifyScript, ...notifyArgs]);
+if (shouldStartNotify) {
+  spawnChild("notify", process.execPath, [notifyScript, ...notifyArgs], {
+    optional: true,
+  });
+}
+
 spawnChild("vite", process.execPath, [viteScript]);

package/scripts/install-codex-agents.js

@@ -63,9 +63,10 @@ ${getSharedStyleRulesForCodex()}
 
 ## 全局方法
 
-- 优先使用 MVFrame 全局方法，不要重复 import 或本地封装等价 helper：\`globalThis.$d\`、\`$fa\`、\`$fu\`、\`$pm\`、\`$db\`、\`$copy\`、\`$deepClone\`、\`$getLang\`、\`$getImg\`、\`$sc\`、\`$c.info\`。
+- 优先使用 MVFrame 全局方法，不要重复 import 或本地封装等价 helper：\`globalThis.$d\`、\`$l\`、\`$fa\`、\`$fu\`、\`$pm\`、\`$db\`、\`$copy\`、\`$deepClone\`、\`$getLang\`、\`$getImg\`、\`$sc\`、\`$c.info\`。
 - 在模板里，如果这些方法已经通过 Vue globalProperties 注入，直接调用即可。
 - 对普通 JS 模块，优先使用 \`globalThis.$xxx\`；只有确实需要显式 import 时，再使用 MVFrame 的子路径导出。
+- 多语言变量统一使用 \`$l("helloUser", { name: userName })\`，字典文案写作 \`"Hello {name}"\`；变量名仅使用字母、数字、下划线、点、短横线或 \`$\`，缺失变量会保留原 \`{name}\` 占位。
 
 ## 路由、Store 与 Maps
 

package/scripts/scaffold-app.js

@@ -902,7 +902,7 @@ yarn dev
 如需同时启动 Vite 与 MVFrame 钉钉通知服务，可显式执行框架命令（与 \`mvframe-b\` 类似由 MVFrame 包提供，不会自动覆盖宿主脚本）：
 
 \`\`\`bash
-yarn exec mvframe-d
+yarn exec mvframe-d -n
 \`\`\`
 
 若需跳过对 \`package.json\` 的修改：\`node scripts/scaffold-app.js --no-package-json\` 或 \`node scripts/scaffold-app.js -n\`。
@@ -1007,7 +1007,7 @@ yarn exec mvframe-notify
 同时启动 Vite 和通知服务：
 
 \`\`\`bash
-yarn exec mvframe-d
+yarn exec mvframe-d -n
 \`\`\`
 
 前端发送：