mvframe 1.0.95 → 1.0.96

package/README.cn.md

@@ -293,16 +293,41 @@ Codex 不会自动读取 Cursor 的 `.cursor/rules/*.mdc`。宿主项目需要
 
 ```bash
 cd /path/to/your-app
+yarn exec mvframe-init-rules
+# 或：npx mvframe-init-rules
+
+# 仅初始化 Codex 规则
 yarn exec mvframe-install-codex-rules
 # 或：npx mvframe-install-codex-rules
 
 # 克隆 / monorepo 中指向 mvframe 源码时
+node /path/to/mvframe/scripts/init-rules.js
+node /path/to/mvframe/scripts/init-rules.js /path/to/your-app
+
+# 仅初始化 Codex 规则
 node /path/to/mvframe/scripts/install-codex-agents.js
 node /path/to/mvframe/scripts/install-codex-agents.js /path/to/your-app
 ```
 
 脚手架命令已自动执行这一步。生成区块带有 `MVFRAME-CODEX-RULES` 标记，重复执行只更新这段内容，不覆盖你在 `AGENTS.md` 中的其它规则。
 
+## Cursor 规则（`.cursor/rules`）
+
+统一命令 `mvframe-init-rules` 会同时把 **mvframe 包内**与仓库一致的 **`*.mdc`** 补充到目标项目 **`/.cursor/rules/`**（`component-hierarchy`、`script-setup`、`style-system`、`views`、`router`、`global-components`、`data`、`util`）。
+若宿主项目已存在同名规则文件，则保留宿主文件，仅补缺失项。
+
+仅安装 Cursor 规则时：
+
+```bash
+cd /path/to/your-app
+yarn exec mvframe-install-cursor-rules
+# 或：npx mvframe-install-cursor-rules
+
+# 克隆 / monorepo 中指向 mvframe 源码时
+node /path/to/mvframe/scripts/install-cursor-rules.js
+node /path/to/mvframe/scripts/install-cursor-rules.js /path/to/your-app
+```
+
 ## Cursor Skill（应用初始化）
 
 本仓库自带 **`.cursor/skills/mvframe-app-init`**，消费方项目可复制到自身 `.cursor/skills` 以便 Cursor 识别 MVFrame 接入规范。

package/README.md

@@ -278,16 +278,41 @@ Codex does **not** automatically read Cursor `.cursor/rules/*.mdc`. For host pro
 
 ```bash
 cd /path/to/your-app
+yarn exec mvframe-init-rules
+# or: npx mvframe-init-rules
+
+# Codex rules only
 yarn exec mvframe-install-codex-rules
 # or: npx mvframe-install-codex-rules
 
 # Full checkout / monorepo path to mvframe
+node /path/to/mvframe/scripts/init-rules.js
+node /path/to/mvframe/scripts/init-rules.js /path/to/your-app
+
+# Codex rules only
 node /path/to/mvframe/scripts/install-codex-agents.js
 node /path/to/mvframe/scripts/install-codex-agents.js /path/to/your-app
 ```
 
 The scaffold command already runs this step. The generated block is bounded by `MVFRAME-CODEX-RULES` markers, so rerunning the command updates only that block and preserves other `AGENTS.md` content.
 
+## Cursor Rules (`.cursor/rules`)
+
+The unified `mvframe-init-rules` command also adds the package’s **`*.mdc`** files into the target project’s **`/.cursor/rules/`** (`component-hierarchy`, `script-setup`, `style-system`, `views`, `router`, `global-components`, `data`, `util`).
+If the host project already has a same-named rule file, the host file is kept and only missing rules are added.
+
+Install Cursor rules only:
+
+```bash
+cd /path/to/your-app
+yarn exec mvframe-install-cursor-rules
+# or: npx mvframe-install-cursor-rules
+
+# Full checkout / monorepo path to mvframe
+node /path/to/mvframe/scripts/install-cursor-rules.js
+node /path/to/mvframe/scripts/install-cursor-rules.js /path/to/your-app
+```
+
 ## Cursor Skill (app scaffold)
 
 This repo ships **`.cursor/skills/mvframe-app-init`**. Copy it into your app’s **`.cursor/skills`** so Cursor can pick up MVFrame integration conventions.

package/dist/vendor.js

@@ -13477,7 +13477,7 @@ const xr = (e, o = {}) => {
 }, Nr = {
   name: "Matt Avias Frame",
   copyright: "©2026",
-  version: "1.0.95",
+  version: "1.0.96",
   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.0.95",
+  "version": "1.0.96",
   "author": "matt avis",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -44,6 +44,8 @@
     "d": "node scripts/dev-with-notify.js",
     "notify": "node scripts/notify-server.js",
     "build": "node scripts/prebuild.js",
+    "init-rules": "node scripts/init-rules.js",
+    "install-cursor-rules": "node scripts/install-cursor-rules.js",
     "install-cursor-skill": "node scripts/install-cursor-skill.js",
     "install-codex-rules": "node scripts/install-codex-agents.js",
     "scaffold-app": "node scripts/scaffold-app.js",
@@ -54,7 +56,9 @@
     "mvframe-b": "scripts/build-host.js",
     "mvframe-d": "scripts/dev-with-notify.js",
     "mvframe-init-app": "scripts/scaffold-app.js",
+    "mvframe-init-rules": "scripts/init-rules.js",
     "mvframe-install-codex-rules": "scripts/install-codex-agents.js",
+    "mvframe-install-cursor-rules": "scripts/install-cursor-rules.js",
     "mvframe-install-cursor-skill": "scripts/install-cursor-skill.js",
     "mvframe-notify": "scripts/notify-server.js"
   },
@@ -63,7 +67,9 @@
     "src/style/chip/mixin.scss",
     "scripts/build-host.js",
     "scripts/dev-with-notify.js",
+    "scripts/init-rules.js",
     "scripts/install-codex-agents.js",
+    "scripts/install-cursor-rules.js",
     "scripts/install-cursor-skill.js",
     "scripts/notify-server.js",
     "scripts/scaffold-app.js",

package/scripts/init-rules.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * 一次初始化宿主项目的 MVFrame Codex + Cursor 规则。
+ *
+ * 用法：
+ *   node path/to/mvframe/scripts/init-rules.js
+ *   node path/to/mvframe/scripts/init-rules.js /abs/path/to/your-project
+ *   yarn exec mvframe-init-rules
+ *
+ * 环境变量（可选）：
+ *   MVFRAME_INIT_RULES_OUT=/path/to/project  等价于第一个参数
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { upsertCodexAgents } = require("./install-codex-agents.js");
+const { installCursorRules } = require("./install-cursor-rules.js");
+
+function main() {
+  const argPath = process.argv.find((a, i) => i >= 2 && !a.startsWith("--"));
+  const projectRoot = path.resolve(
+    process.env.MVFRAME_INIT_RULES_OUT || argPath || process.cwd(),
+  );
+
+  if (!fs.existsSync(projectRoot)) {
+    console.error("[mvframe] 目录不存在:", projectRoot);
+    process.exit(1);
+  }
+
+  installCursorRules(projectRoot);
+  upsertCodexAgents(projectRoot);
+
+  console.log("[mvframe] 已完成 MVFrame 规则初始化：");
+  console.log("  - Cursor: .cursor/rules/*.mdc");
+  console.log("  - Codex: AGENTS.md");
+  console.log("[mvframe] 请重开 Cursor / 开启新 Codex 会话，确保新规则被重新读取。");
+}
+
+if (require.main === module) {
+  main();
+}

package/scripts/install-cursor-rules.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * 将 MVFrame 包内 `.cursor/rules/*.mdc` 补充到目标工程的 `.cursor/rules/`。
+ * 若宿主项目已存在同名规则文件，则保留宿主文件，不覆盖。
+ *
+ * 用法：
+ *   node path/to/mvframe/scripts/install-cursor-rules.js
+ *   node path/to/mvframe/scripts/install-cursor-rules.js /abs/path/to/your-project
+ *
+ * 环境变量（可选）：
+ *   MVFRAME_CURSOR_RULES_OUT=/path/to/project  等价于第一个参数
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+function installCursorRules(projectRoot) {
+  const targetRoot = path.resolve(projectRoot);
+  const rulesSrc = path.join(__dirname, "..", ".cursor", "rules");
+
+  if (!fs.existsSync(rulesSrc)) {
+    console.warn(
+      "[mvframe] 未找到包内 .cursor/rules（请使用含该目录的 mvframe 版本），跳过 Cursor 规则复制",
+    );
+    return;
+  }
+
+  const entries = fs.readdirSync(rulesSrc, { withFileTypes: true });
+  for (const ent of entries) {
+    if (!ent.isFile() || !ent.name.endsWith(".mdc")) continue;
+    const src = path.join(rulesSrc, ent.name);
+    const dest = path.join(targetRoot, ".cursor", "rules", ent.name);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    if (fs.existsSync(dest)) {
+      console.log("[mvframe] 已存在 Cursor 规则，跳过：");
+      console.log("  ", dest);
+      continue;
+    }
+    fs.copyFileSync(src, dest);
+    console.log("[mvframe] 已写入 Cursor 规则：");
+    console.log("  ", dest);
+  }
+
+  console.log("[mvframe] Cursor 打开该项目后会读取 .cursor/rules/*.mdc。");
+}
+
+function main() {
+  const argPath = process.argv.find((a, i) => i >= 2 && !a.startsWith("--"));
+  const projectRoot = path.resolve(
+    process.env.MVFRAME_CURSOR_RULES_OUT || argPath || process.cwd(),
+  );
+
+  if (!fs.existsSync(projectRoot)) {
+    console.error("[mvframe] 目录不存在:", projectRoot);
+    process.exit(1);
+  }
+
+  installCursorRules(projectRoot);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  installCursorRules,
+};

package/scripts/scaffold-app.js

@@ -17,6 +17,7 @@ const fs = require("fs");
 const path = require("path");
 const { execFileSync } = require("child_process");
 const { upsertCodexAgents } = require("./install-codex-agents.js");
+const { installCursorRules } = require("./install-cursor-rules.js");
 
 const FORCE = process.argv.includes("--force") || process.argv.includes("-f");
 const NO_PKG = process.argv.includes("--no-package-json") || process.argv.includes("-n");
@@ -54,27 +55,6 @@ function appendGitignoreLines(lines) {
   console.log("[mvframe-init] 已更新 .gitignore");
 }
 
-/**
- * 将本包 `.cursor/rules/*.mdc` 复制到目标工程，与 mvframe 仓库内 Cursor 规则保持一致。
- * 发布包需在 `package.json` 的 `files` 中包含 `.cursor/rules`。
- */
-function copyCursorRulesFromPackage() {
-  const rulesSrc = path.join(__dirname, "..", ".cursor", "rules");
-  if (!fs.existsSync(rulesSrc)) {
-    console.warn(
-      "[mvframe-init] 未找到包内 .cursor/rules（请使用含该目录的 mvframe 版本），跳过 Cursor 规则复制",
-    );
-    return;
-  }
-  const entries = fs.readdirSync(rulesSrc, { withFileTypes: true });
-  for (const ent of entries) {
-    if (!ent.isFile() || !ent.name.endsWith(".mdc")) continue;
-    const content = fs.readFileSync(path.join(rulesSrc, ent.name), "utf8");
-    const rel = path.join(".cursor", "rules", ent.name);
-    write(rel.replace(/\\/g, "/"), content);
-  }
-}
-
 /** 与 main.js / vite.config 模板一致；版本号与 mvframe 本仓库对齐思路，可随发布调整 */
 // @vue/shared 为 Vue 3 内部包，传递依赖在部分包管理器下未提升时 Vite 解析失败，故写入直连依赖
 const SCAFFOLD_DEPENDENCIES = {
@@ -187,7 +167,7 @@ function main() {
     fs.mkdirSync(path.join(target, d), { recursive: true });
   }
 
-  copyCursorRulesFromPackage();
+  installCursorRules(target);
   upsertCodexAgents(target);
   appendGitignoreLines([".env.local", ".env.mvframe-notify"]);
 
@@ -976,6 +956,12 @@ await notify("需要发送到钉钉的消息");
 
 初始化脚本会写入/更新项目根 **\`AGENTS.md\`** 的 MVFrame 区块，供 Codex 在宿主项目内优先使用 **MVFrame 全局组件、全局方法与全局样式工具类**，并要求 **每次 AI 完成开发后调用 \`yarn exec mvframe-notify --once --message "..."\` 发送完成通知**。该区块带有 \`MVFRAME-CODEX-RULES\` 标记，重复执行脚手架会更新这段内容，不会覆盖你在 \`AGENTS.md\` 中的其它规则。
 
+同时初始化 Codex + Cursor 两侧规则：
+
+\`\`\`bash
+yarn exec mvframe-init-rules
+\`\`\`
+
 仅安装 Codex 规则：
 
 \`\`\`bash
@@ -984,7 +970,13 @@ yarn exec mvframe-install-codex-rules
 
 ## Cursor 规则（\`.cursor/rules\`）
 
-初始化脚本会把 **mvframe 包内**与仓库一致的 **\`*.mdc\`** 写入目标项目 **\`/.cursor/rules/\`**（\`component-hierarchy\`、\`script-setup\`、\`style-system\`、\`views\`、\`router\`、\`global-components\`、\`data\`、\`util\`）。若目录或文件已存在且未加 \`--force\` / \`-f\`，则跳过对应文件。
+初始化脚本会把 **mvframe 包内**与仓库一致的 **\`*.mdc\`** 补充到目标项目 **\`/.cursor/rules/\`**（\`component-hierarchy\`、\`script-setup\`、\`style-system\`、\`views\`、\`router\`、\`global-components\`、\`data\`、\`util\`）。若宿主项目已存在同名规则文件，则保留宿主文件，仅补缺失项。
+
+仅安装 Cursor 规则：
+
+\`\`\`bash
+yarn exec mvframe-install-cursor-rules
+\`\`\`
 
 npm 包需在 \`files\` 中包含 \`.cursor/rules\`；使用本地 \`file:\` / 源码链接时同样可用。