mvframe 1.1.16 → 1.1.18

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mvframe",
   "packageManager": "yarn@4.4.1",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "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
 \`\`\`
 
 前端发送：