momo-ai 1.0.49 → 1.0.50

package/AGENTS.md

@@ -0,0 +1,307 @@
+# AI Agents Integration (Momo CLI)
+
+This document helps AI coding assistants understand the project structure and workflows. Following these conventions improves accuracy when assisting development.
+
+## Project Workflow
+
+1. **Requirements** – Define and analyze business needs
+2. **Task planning** – Break requirements into executable tasks
+3. **Role assignment** – Assign AI or human roles per task
+4. **Implementation** – Implement tasks and generate code
+5. **Verification** – Validate that outcomes meet requirements
+6. **Archive & commit** – Archive and commit completed work
+
+## Momo CLI Tools (Reference)
+
+All tools are invoked as `momo <command> [options]`. Descriptions and options are derived from `src/commander/*.json`.
+
+---
+
+### Basic commands
+
+#### `momo help [-c <command>]`
+Show help. With `-c`, show detailed help for a specific command.
+
+**Options:**
+- `-c, --command`: Command name
+
+**Examples:**
+```bash
+momo help
+momo help -c init
+```
+
+#### `momo env`
+Check environment (Node.js, Python, and other system dependencies).
+
+**Examples:**
+```bash
+momo env
+```
+
+#### `momo init [-d <dir>]`
+Initialize R2MO specification directory structure.
+
+**Options:**
+- `-d, --dir`: Target directory (default: current directory)
+
+**Examples:**
+```bash
+momo init
+momo init -d ./my-project
+```
+
+---
+
+### Development & project commands
+
+#### `momo app -n <name>`
+Create a new R2MO/Spring or ZERO/Vertx application.
+
+**Options:**
+- `-n, --name`: Application name (required)
+
+**Examples:**
+```bash
+momo app -n my-app
+```
+
+#### `momo open [-d <dir>]`
+Open the project with a chosen AI tool (Antigravity, Trae, Cursor).
+
+**Options:**
+- `-d, --dir`: Directory to open (default: current directory)
+
+**Examples:**
+```bash
+momo open
+momo open -d ./src
+```
+
+#### `momo domain [-d <dir>] [-e]`
+Run `r2mo_proto` to process Maven project domain model (Protobuf / DB).
+
+**Options:**
+- `-d, --dir`: Target directory (default: current directory); must be Maven root with `pom.xml`
+- `-e, --entity`: Generate from Entity (true) or from SQL (false); default true
+
+**Examples:**
+```bash
+momo domain
+momo domain -d ./my-maven-project
+```
+
+#### `momo ui -n <name> [-d <dir>] [-u]`
+Create or update a UI subproject from the r2mo-ui template (Rust/WASM + Tauri).
+
+**Options:**
+- `-n, --name`: Project name (required for create; DPA suggests `xxx-ui`)
+- `-d, --dir`: Parent directory (default: current directory)
+- `-u, --update`: Update mode: sync root MD, `src/pages/components`, `src/pages/utils`, and optionally other changed files via multi-select; target defaults to current directory when `-u` is used without `-n`
+
+**Examples:**
+```bash
+momo ui -n my-app-ui -d .
+momo ui -u
+```
+
+#### `momo admin [-d <dir>]`
+Generate front-end page structure from project requirements (`.r2mo/requirements/project.md`). Writes module/personal pages under `src/pages/`; skips overwriting existing files (metadata, requirement, page yaml).
+
+**Options:**
+- `-d, --dir`: Target directory (default: current directory)
+
+**Examples:**
+```bash
+momo admin
+momo admin -d .
+```
+
+---
+
+### Specification & API commands
+
+#### `momo mod [-d <dir>]`
+Pull r2mo-spec into `.r2mo/repo` and copy project/OpenAPI artifacts to `.r2mo/api/`.
+
+**Options:**
+- `-d, --dir`: Project root (default: current directory)
+
+**Examples:**
+```bash
+momo mod
+momo mod -d .
+```
+
+#### `momo openapi [-d <dir>]`
+Extract Operation/Schema markdown from subprojects’ `src/main/resources/openapi` and copy to `-ui/.r2mo/api/` preserving structure.
+
+**Options:**
+- `-d, --dir`: Project root (default: current directory)
+
+**Examples:**
+```bash
+momo openapi
+momo openapi -d .
+```
+
+#### `momo docs [-d <dir>]`
+Open the docs directory with Obsidian.
+
+**Options:**
+- `-d, --dir`: Target directory (default: current directory)
+
+**Examples:**
+```bash
+momo docs
+momo docs -d ./specification
+```
+
+#### `momo menu [-d <dir>]`
+Scan `src/pages` for `menu.yaml` and print the full tree menu (name, text, icon).
+
+**Options:**
+- `-d, --dir`: Project root (default: current directory)
+
+**Examples:**
+```bash
+momo menu
+momo menu -d .
+```
+
+---
+
+### Dictionary & Flyway commands
+
+#### `momo dict [-d <dir>] [-r]`
+**Forward:** Read `.r2mo/api/components/schemas` (XTabular/XCategory), connect via `app.env`, export `X_TABULAR`/`X_CATEGORY` by TYPE to `targetDir/.r2mo/data/dbdict/` as `dict.{type}.yaml` and `tree.{type}.yaml`. When matching Flyway SQL exists, prepend metadata (sqlFile, sqlPath) in YAML front-matter.
+
+**Reverse (`-r`):** Read `.r2mo/data/dbdict` YAML (DPA: from `-ui` dir). Only process files with valid metadata (sqlPath). Ask once to overwrite; then overwrite the SQL files at recorded paths.
+
+**Options:**
+- `-d, --dir`: Project root (default: current directory)
+- `-r, --reverse`: Reverse mode: YAML as input, generate/overwrite Flyway SQL using metadata
+
+**Examples:**
+```bash
+momo dict
+momo dict -d .
+momo dict -r
+```
+
+---
+
+### Spec repository codegen commands
+
+#### `momo mmr0`
+Download from r2mo-spec repository and generate Flyway SQL files (e.g. into `-domain` Flyway dir).
+
+**Examples:**
+```bash
+momo mmr0
+```
+
+#### `momo mmr2`
+Download from r2mo-spec repository and generate Entity classes.
+
+**Examples:**
+```bash
+momo mmr2
+```
+
+---
+
+### Skills & MCP commands
+
+#### `momo apply [-r [repo_name]]`
+Install skills from a remote repository into the local project. Choose target path interactively.
+
+**Options:**
+- `-r, --remote`: Install from remote (optional repo name)
+
+**Install targets:**
+- Cursor (`.claude/skills/`)
+- Antigravity (`.agent/skills/`)
+- Trae CN / Trae (`.trae/skills/`)
+- Lingma (`.lingma/skills/`)
+
+**Examples:**
+```bash
+momo apply -r
+momo apply -r anthropics/skills
+```
+
+#### `momo mcp [-c]`
+Configure MCP Skills Server: merge project and global skills and generate Cursor `mcp.json`.
+
+**Options:**
+- `-c, --check`: Only check dependencies; do not configure
+
+**Behavior:**
+- Install MCP deps under `.r2mo/mcpserver`
+- Write `.cursor/mcp.json`
+- Copy config to clipboard
+
+**Examples:**
+```bash
+momo mcp
+momo mcp -c
+```
+
+---
+
+### Prompt & template commands
+
+#### `momo ask`
+Pick a prompt template from `src/_template/R2MO/`, extract content between `--- BEGIN` and `--- END`, copy to clipboard, and show template details (file, title, version, skills, commands). If the prompt contains a “模块：ID,NAME,PATH” placeholder, scan `src/pages/*/requirement.module.md` (with valid front-matter, no `{}` placeholders), let the user choose a module, and replace the placeholder with that module’s ID, name, and path.
+
+**Examples:**
+```bash
+momo ask
+```
+
+---
+
+## Tool summary (by command)
+
+| Command   | Description (short) |
+|----------|----------------------|
+| `help`   | Show help; optional `-c` for command-specific help |
+| `env`    | Environment check |
+| `init`   | Initialize R2MO spec directory |
+| `app`    | Create R2MO/Spring or ZERO/Vertx app |
+| `open`   | Open project in AI tool (Antigravity/Trae/Cursor) |
+| `domain` | Run r2mo_proto for domain/Protobuf |
+| `ui`     | Create/update UI subproject from r2mo-ui; `-u` update mode |
+| `admin`  | Generate front-end page structure from requirements (skip existing) |
+| `mod`    | Pull r2mo-spec, copy OpenAPI to `.r2mo/api/` |
+| `openapi`| Extract OpenAPI md to `-ui/.r2mo/api/` |
+| `docs`   | Open docs in Obsidian |
+| `menu`   | Print tree menu from `src/pages` menu.yaml |
+| `dict`   | Export dict to `.r2mo/data/dbdict` (with metadata); `-r` reverse to Flyway SQL |
+| `mmr0`   | Generate Flyway SQL from r2mo-spec |
+| `mmr2`   | Generate Entity classes from r2mo-spec |
+| `apply`  | Install skills from remote (Cursor/Agent/Trae/Lingma) |
+| `mcp`    | Configure MCP Skills Server and `mcp.json` |
+| `ask`    | Select prompt template, optional module substitution, copy to clipboard |
+
+---
+
+## Key paths
+
+- **Spec / requirements:** `.r2mo/requirements/`, `src/_template/R2MO/`
+- **Schemas / API:** `.r2mo/api/components/schemas`, `-ui/.r2mo/api/`
+- **Dictionary:** `.r2mo/data/dbdict/` (dict.*.yaml, tree.*.yaml; optional front-matter sqlFile/sqlPath)
+- **Flyway SQL:** `-domain/src/main/resources/plugins/<artifactId>/flyway/MYSQL/`
+- **Skills:** `.claude/skills/`, `.agent/skills/`, `.trae/skills/`, `.lingma/skills/`
+- **MCP:** `.r2mo/mcpserver/`, `.cursor/mcp.json`
+
+---
+
+## Conventions
+
+1. **DPA vs ONE:** DPA = Domain + Provider + Api (+ `-ui`); target dir for UI/dbdict is `-ui`; app.env from `-api`. ONE = single project; target dir is project root.
+2. **momo dict:** Forward writes YAML with optional metadata from matching Flyway SQL; reverse only processes YAML with valid metadata and overwrites SQL after user confirmation.
+3. **momo admin:** Does not overwrite existing metadata, requirement, or page yaml files.
+4. **momo ask:** Modules with `{}` placeholders in front-matter are excluded from the module list.
+5. **momo ui -u:** Without `-n`, target is current directory; Rust/Tauri and listed root files are not updated in “other files” multi-select.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "momo-ai",
-    "version": "1.0.49",
+    "version": "1.0.50",
     "description": "Rachel Momo ( OpenSpec )",
     "main": "src/momo.js",
     "bin": {

package/skills/mo-dev-login/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: mo-dev-login
+description: Leptos+Rust login flow: Z_ENDPOINT/Z_APP, /app/name, /auth/login, storage keys, WASM pitfalls
+version: 1.0.0
+tags: [r2mo, dev, login, rust, leptos, wasm, auth, storage, gloo-net]
+repository: https://gitee.com/silentbalanceyh/r2mo-lain.git
+---
+
+# mo-dev-login (concise)
+
+Leptos (CSR) + Trunk + gloo-net: login via GET `/app/name/{Z_APP}` and POST `/auth/login`; session keys (LocalStorage appId, SessionStorage token+userId); auth guard in layout; session restore on load. Align with `.r2mo/api`.
+
+## Scope
+
+**In**: `Z_ENDPOINT`/`Z_APP` (config, `option_env!`); GET `/app/name/{Z_APP}` on login mount → `data.id`; POST `/auth/login` → id/username/token; storage keys below; layout token check + redirect; main restore from `Ut::load_user()`.
+
+**Out**: Backend, OAuth/SMS/email, register, MFA.
+
+## Storage keys
+
+| Where | Key | Value |
+|-------|-----|--------|
+| LocalStorage | `app_id_{Z_APP}` | app id from `/app/name` |
+| SessionStorage | `current_user_{appId}` | userId |
+| SessionStorage | `user_data_{appId}_{userId}` | UserData (id, username, token, role, login_time) |
+
+`UserData` must include `id` (from login response).
+
+## Files (minimal)
+
+| File | Role |
+|------|------|
+| `src/config.rs` | `z_endpoint()`, `z_app()` via `option_env!`, defaults 6200 / r2-cloud.app-admin |
+| `src/api/auth.rs` | `fetch_app_by_name()`, `login(user, pass)`; base from config |
+| `src/models/auth.rs` | XApp, AppByNameResponse, RequestLoginCommon, ResponseLoginCommon, LoginResponse |
+| `src/utils/storage.rs` | set/get_app_id (LS), save/load/clear_user (SS, keys above) |
+| `src/pages/login.rs` | Mount: Effect + spawn_local fetch app → set_app_id; submit: login → save_user → nav /home |
+| `src/components/layout.rs` | Effect: no token → clear_user, clear_app_id, nav /; logout same |
+| `src/main.rs` | If `Ut::load_user().is_some()` → set is_logged_in, user_name |
+
+## WASM pitfalls & fixes
+
+| Error / warning | Fix |
+|-----------------|-----|
+| `no method send for Result` | `Request::body()` returns Result → `.body(body_str).map_err(...)?` then `.send()` |
+| `future cannot be sent` / not `Send` | Don't use `Resource::new` for fetch; use `Effect::new` + `spawn_local(async { fetch_app_by_name().await })` |
+| `borrow of moved value: navigate` | Before Effect: `let navigate_auth = navigate.clone();` use `navigate_auth` in Effect |
+| `?` can't convert serde_json::Error to JsValue | `.map_err(\|e\| JsValue::from(e.to_string()))?` in storage |
+| unused imports (models), unused AppData (utils) | Drop re-exports or remove from `pub use` |
+| `clear_app` never used | `#[allow(dead_code)]` on fn |
+
+## Snippets
+
+**App fetch (no Resource):**
+```rust
+Effect::new(move |_| {
+    let set_app_ready = set_app_ready.clone();
+    let set_error_message = set_error_message.clone();
+    spawn_local(async move {
+        match fetch_app_by_name().await {
+            Ok(app) => { let _ = Ut::set_app_id(&app.id); set_app_ready.set(true); }
+            Err(e) => set_error_message.set(e),
+        }
+    });
+});
+```
+
+**POST body:**
+```rust
+let body_str = serde_json::to_string(&body).map_err(|e| e.to_string())?;
+Request::post(&url).header("Content-Type", "application/json").body(body_str).map_err(...)? .send().await
+```
+
+**Storage JSON error:**
+```rust
+serde_json::to_string(data).map_err(|e| JsValue::from(e.to_string()))?
+```
+
+## Checklist
+
+- [ ] Login page: GET app/name → set_app_id (LS); POST login → save_user (SS) → nav /home
+- [ ] Layout: no token → clear + nav /; logout → clear_user, clear_app_id, nav /
+- [ ] Main: load_user() → restore context
+- [ ] cargo check / clippy clean
+
+Ref: `.r2mo/api/operations/app.name.$name.get/`, `.r2mo/api/metadata.yaml` (/auth/login, @RequestLoginCommon, @ResponseLoginCommon), `r2-frontend-rust.mdc`, `.claude/skills/r2-dev-login`.

package/src/_template/R2MO/03.req-page.md

@@ -7,13 +7,15 @@ version: 1.0.0
 使用 `r2-req-page` 技能分析模块需求，生成对应模块下的页面需求，执行时先做一个 Plan，若无特殊说明采用最小需求的模式执行分析，保证模块的业务闭环。
 
 输入（模块目录中）：
-- `metadata.yaml` 中包含了页面配置，若页面有缺失请直接创建新目录
+- `metadata.yaml` 中包含了页面配置
 - `metadata.md` （可选）中包含了部分补充说明，虽然不完善，但依旧可遵循
 - `requirement.module.md` 中包含了模块需求
+- API部分的内容参考：`.r2mo/api/metadata.yaml` ，`.r2mo/api/missed/*.yaml` 的定义
 
 输出：
 - 严格遵循 rules ( `*.mdc` ) 规范和 skills 中的规范
-- 输出内容精简，让AI可以更容易理解
+- 输出内容精简，让AI可以更容易理解，但要保证页面开发就绪
+- 按分析结果更新 `requirement.page.md` 和 `page.yaml`
 
 模块：ID,NAME,PATH
 --- END

package/src/_template/R2MO/09.util-system.md

@@ -1,5 +1,5 @@
 ---
-title: 09 - 辅助系统 / 全系统整合
+title: 09 - 辅助工具 / 全系统整合
 skill: r2-sys-integrate
 version: 1.1.0
 ---

package/src/_template/R2MO/10.util-route.md

@@ -8,12 +8,19 @@ version: 1.0.0
 
 输入：
 - {MOD}/menu.yaml，模块目录下的菜单配置
-- {MOD}/{PAGE}，模块目录下的页面目录清单
+- {MOD}/metadata.yaml，模块需求中的页面清单
+- {MOD}/{PAGE-DIRECTORY}，模块目录下的页面目录清单
 
-> `MOD` 表示模块目录，位于当前项目的 `src/pages/` 下。
+> `MOD` 表示模块目录，位于当前项目的 `src/pages/` 下
 
 输出：
-- 以 `menu.yaml` 为基础，追加缺失的页面信息
-- 以 `menu.yaml` 为基础，将多余的页面信息全部删除
+- 以 `metadata.yaml` 中的页面为第一优先级，为了能开发**业务流程**完整的模块
+	- 创建缺失的页面（包括内部的 `page.yaml`、`requirement.page.md` ）
+	- 删除不再使用的页面（没有存在于 `menu.yaml` 和 `metadata.yaml` 中）
+- 以 `menu.yaml` 为基础，检查是否有页面和它对齐，产生最终的报告，未对齐的部分再次**创建缺失页面**（按步骤一对齐），报告输出位置：`docs/pages/` 目录
+- 严格限制：
+	- 整个过程中不要更新 `menu.yaml` 文件
+	- `menu.yaml` 和 `metadata.yaml` 中出现过的页面确认有目录与之对应
+	- 没有多余页面目录存在于 `menu.yaml` 和 `metadata.yaml` 中
 
 --- END

package/src/_template/R2MO/11.util-api-missed.md

@@ -0,0 +1,19 @@
+---
+title: 11 - 辅助工具 / 缺失接口汇总
+skill:
+version: 1.0.0
+---
+--- BEGIN
+分析所有模块根目录（ `src/pages/{MOD}/`）生成的 `miss-api.md` 缺失集合，在 `src/pages` 中生成两份缺失接口文档。基于现有的业务需求，参考三类型原则
+- 最小版本
+- 标准版本
+- 完整版本
+但缺失接口只考虑边界版本：**最小版本**和**完整版本**。
+
+输出：
+- 生成最小缺失接口版本：`.r2mo/api/missed/min.yaml`，最小版本可以保证业务的基本闭环，剪裁掉一些无关紧要的接口。
+- 生成全缺失接口版本：`.r2mo/api/missed/full.yaml`，全版本基于现有需求生成的所有 `miss-api.md` 整合。
+- `min.yaml` 和 `full.yaml` 两份格式采用 OpenAPI 3.1 的规范。
+- 生成的 OpenAPI 中接口不可重复，相同路径下的接口合并到一起。
+
+--- END

package/src/commander/apply.json

@@ -1,13 +1,19 @@
 {
     "executor": "executeApply",
-    "description": "从远程仓库安装技能到本地项目（仅支持远程）",
+    "description": "从远程仓库安装技能到当前项目（默认）；-i 将当前项目 skills/ 反馈到 Z_LAIN_SKILL/skills",
     "command": "apply",
     "options": [
         {
             "name": "remote",
             "alias": "r",
-            "description": "从远程仓库安装技能（可选指定仓库名）",
+            "description": "远程仓库名（可选，默认仍从远程安装）",
             "type": "string"
+        },
+        {
+            "name": "import",
+            "alias": "i",
+            "description": "反馈模式：将当前项目 skills/ 拷贝到 Z_LAIN_SKILL/skills",
+            "type": "boolean"
         }
     ]
 }

package/src/commander/dict.json

@@ -1 +1 @@
-{"executor":"executeDict","description":"从 .r2mo/api/components/schemas 读取 XTabular/XCategory 结构，按 app.env 连接业务库导出 X_TABULAR/X_CATEGORY 到 .r2mo/dict/（dict.{type}.yaml / tree.{type}.yaml）","command":"dict","options":[{"name":"dir","alias":"d","description":"项目根目录（默认为当前目录）","default":"."}]}
+{"executor":"executeDict","description":"从 .r2mo/api/components/schemas 读取结构并导出字典到 .r2mo/data/dbdict；-r 逆向从 dbdict 的 yaml 生成 flyway SQL","command":"dict","options":[{"name":"dir","alias":"d","description":"项目根目录（默认为当前目录）","default":"."},{"name":"reverse","alias":"r","description":"逆向：以 .r2mo/data/dbdict 的 yaml 为输入，在 -domain 或当前项目 flyway 目录下生成 SQL 脚本","type":"boolean"}]}

package/src/executor/executeApply.js

@@ -5,8 +5,8 @@ const Ec = require('../epic');
 const fsAsync = require('fs').promises;
 const readline = require('readline');
 const { execSync } = require('child_process');
-const { parseOptional } = require('../utils/momo-args');
-const { copyDir, readJson, parseFile } = require('../utils/momo-file-utils');
+const { parseOptional, parseBool } = require('../utils/momo-args');
+const { copyDir, readJson, parseFile, ensureDir, exists } = require('../utils/momo-file-utils');
 const { selectSingle } = require('../utils/momo-menu');
 
 // 远程仓库配置文件路径
@@ -576,41 +576,83 @@ const _installFromRemote = async (repository, targetPath) => {
     Ec.info(`✅ 成功安装 ${selectedIndices.length} 个技能！`);
 };
 
-module.exports = async (options) => {
-    // 检查 -r 参数
-    const { hasFlag: hasRemote, value: remoteValue } = parseOptional('remote', 'r');
-    
-    if (!hasRemote) {
-        Ec.error('❌ 此命令必须使用 -r 参数指定远程仓库');
-        Ec.waiting('用法: momo apply -r [仓库名]');
+/**
+ * -i 模式：将当前项目 skills/ 拷贝到 Z_LAIN_SKILL/skills，重名时逐个询问是否覆盖
+ */
+const _importToLainSkills = async () => {
+    const projectDir = process.cwd();
+    const projectSkillsDir = path.join(projectDir, 'skills');
+    const lainRoot = process.env.Z_LAIN_SKILL;
+    if (!lainRoot || !String(lainRoot).trim()) {
+        Ec.error('❌ 环境变量 Z_LAIN_SKILL 未设置');
+        Ec.warn('请设置 Z_LAIN_SKILL 指向 Lain 技能根目录后再执行 momo apply -i');
+        process.exit(1);
+    }
+    const destDir = path.join(lainRoot.trim(), 'skills');
+    if (!exists(projectSkillsDir) || !fs.statSync(projectSkillsDir).isDirectory()) {
+        Ec.warn(`当前项目下未找到 skills/ 目录: ${projectSkillsDir}`);
         process.exit(1);
     }
+    const skills = _scanSkillsFromDir(projectSkillsDir);
+    if (skills.length === 0) {
+        Ec.warn('skills/ 目录下未找到任何有效技能');
+        process.exit(0);
+    }
+    Ec.waiting(`当前项目 skills/: ${projectSkillsDir}`);
+    Ec.waiting(`目标目录: ${destDir}`);
+    await ensureDir(destDir);
+    let copied = 0;
+    for (const skill of skills) {
+        const destPath = path.join(destDir, skill.dirname);
+        if (exists(destPath)) {
+            try {
+                const answer = await Ec.ask(`技能 "${skill.name}" 已存在，是否覆盖？(y/N): `);
+                if (!/^y|yes$/i.test((answer || '').trim())) {
+                    Ec.waiting(`  跳过: ${skill.name}`);
+                    continue;
+                }
+            } catch (e) {
+                Ec.waiting('已取消');
+                process.exit(0);
+            }
+            await fsAsync.rm(destPath, { recursive: true, force: true });
+        }
+        await _copyDirectory(skill.path, destPath);
+        Ec.waiting(`  ✓ 已拷贝: ${skill.name}`);
+        copied++;
+    }
+    Ec.info(`✅ 已反馈 ${copied} 个技能到 ${destDir}`);
+};
+
+module.exports = async (options) => {
+    const isImport = parseBool('import', 'i');
+    const { value: remoteValue } = parseOptional('remote', 'r');
+
+    if (isImport) {
+        await _importToLainSkills();
+        process.exit(0);
+    }
 
-    // 加载远程仓库配置
+    // 默认：从远程仓库安装技能到当前项目（原 momo apply -r）
     const repositories = _loadRepositories();
-    
     if (repositories.length === 0) {
         Ec.error('❌ 未找到任何远程仓库配置');
-        Ec.waiting(`请检查配置文件: ${REPOSITORIES_CONFIG}`);
+        Ec.warn(`请检查配置文件: ${REPOSITORIES_CONFIG}`);
         process.exit(1);
     }
 
-    // 选择仓库
     const repository = await _selectRepository(repositories, remoteValue);
     if (!repository) {
         Ec.waiting('已取消选择仓库');
         process.exit(0);
     }
 
-    // 选择目标路径
     const targetPathConfig = await _selectTargetPath();
     if (!targetPathConfig) {
         Ec.waiting('已取消选择目标路径');
         process.exit(0);
     }
 
-    // 从远程仓库安装技能
     await _installFromRemote(repository, targetPathConfig.path);
-    
     process.exit(0);
 };

package/src/executor/executeDict.js

@@ -1,15 +1,14 @@
 /**
- * momo dict [-d <dir>]
- * 1. 读取 targetDir/.r2mo/api/components/schemas 中的 XTabular、XCategory 作为字典结构依据
- * 2. DPA 时从 x-api/.r2mo/app.env 读取数据库配置，ONE 时从当前项目根 .r2mo/app.env 读取
- * 3. 从业务库 X_TABULAR、X_CATEGORY 按 TYPE 导出，写入 targetDir/.r2mo/data/dbdict/：dict.{type}.yaml、tree.{type}.yaml（YAML 使用 Schema 属性名，非数据库字段名）
+ * momo dict [-d <dir>] [-r]
+ * 正向：从 schemas + 业务库导出字典到 targetDir/.r2mo/data/dbdict/
+ * 逆向 -r：以 .r2mo/data/dbdict 的 yaml 为输入，在 -domain 或当前项目 flyway 目录下生成 SQL 脚本
  */
 const path = require('path');
 const fs = require('fs');
 const fsAsync = require('fs').promises;
 const Ec = require('../epic');
-const { parseOptional } = require('../utils/momo-args');
-const { exists, ensureDir } = require('../utils/momo-file-utils');
+const { parseOptional, parseBool } = require('../utils/momo-args');
+const { exists, ensureDir, parseFile } = require('../utils/momo-file-utils');
 
 /** 懒加载可选依赖，缺失时自动执行 npm install -g 并重试，仍失败则返回 null */
 const _requireOptional = (moduleName, installHint) => {
@@ -58,6 +57,12 @@ const _snakeToCamel = (str) => {
         .join('');
 };
 
+/** camelCase 转 UPPER_SNAKE（逆向写 SQL 列名用） */
+const _camelToSnake = (str) => {
+    if (!str || typeof str !== 'string') return str;
+    return str.replace(/([A-Z])/g, '_$1').replace(/^_/, '').toUpperCase();
+};
+
 /** 从 Schema .md 中解析 properties 下的属性名列表（顺序与 Schema 一致） */
 const _parseSchemaProperties = (schemasDir, entityName) => {
     const mdPath = path.join(schemasDir, `${entityName}.md`);
@@ -200,9 +205,95 @@ const _getDbConfigFromEnv = () => {
     };
 };
 
+// ---------- 逆向 -r：dbdict yaml -> flyway SQL ----------
+
+/** 递归查找包含 .sql 的 flyway 目录（优先 MYSQL，其次任意含 .sql 的目录） */
+const _findFlywaySqlDir = (startDir, maxDepth = 6) => {
+    const search = (dir, depth) => {
+        if (depth > maxDepth) return null;
+        if (!exists(dir) || !fs.statSync(dir).isDirectory()) return null;
+        const lower = dir.toLowerCase();
+        if (lower.includes('flyway') && (lower.includes('mysql') || path.basename(dir) === 'MYSQL')) {
+            try {
+                const files = fs.readdirSync(dir);
+                if (files.some((f) => f.endsWith('.sql'))) return dir;
+            } catch (e) {}
+        }
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const e of entries) {
+                if (!e.isDirectory()) continue;
+                const next = path.join(dir, e.name);
+                const found = search(next, depth + 1);
+                if (found) return found;
+            }
+        } catch (e) {}
+        return null;
+    };
+    return search(startDir, 0);
+};
+
+/** 在 flyway 目录中查找与 tableName + typeLabel 匹配的 SQL 文件，返回 { sqlFile, sqlPath } 或 null */
+const _findMatchingSqlFile = (flywaySqlDir, tableName, typeLabel) => {
+    if (!exists(flywaySqlDir)) return null;
+    const safeType = (typeLabel || '').replace(/\s+/g, '.');
+    const suffix = `.${tableName}.${safeType}.sql`;
+    const files = fs.readdirSync(flywaySqlDir).filter((f) => f.endsWith('.sql') && f.endsWith(suffix));
+    if (files.length === 0) return null;
+    const sqlFile = files[0];
+    const sqlPath = path.resolve(flywaySqlDir, sqlFile);
+    return { sqlFile, sqlPath };
+};
+
+/** 从 flyway 目录中解析已有 SQL 文件名（匹配表名+type），取最大版本号并返回下一段 */
+const _nextSqlVersion = (flywaySqlDir, tableName, typeLabel) => {
+    if (!exists(flywaySqlDir)) return '001.000.001';
+    const files = fs.readdirSync(flywaySqlDir).filter((f) => f.endsWith('.sql'));
+    const safeType = (typeLabel || '').replace(/\s+/g, '.');
+    const versionRe = new RegExp(`^R__([\\d.]+)\\.${tableName}\\.${safeType.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\.sql$`, 'i');
+    let maxThird = 0;
+    const fallbackRe = new RegExp(`^R__([\\d.]+)\\.${tableName}\\.`, 'i');
+    for (const f of files) {
+        let m = f.match(versionRe);
+        if (!m && safeType) m = f.match(fallbackRe);
+        if (m) {
+            const parts = m[1].split('.').map(Number);
+            const third = parts.length >= 3 ? parts[2] : 0;
+            if (third > maxThird) maxThird = third;
+        }
+    }
+    const nextThird = maxThird + 1;
+    return `211.001.${String(nextThird).padStart(3, '0')}`;
+};
+
+/** 将 yaml 行数组转为 INSERT IGNORE SQL（camelCase 键转 UPPER_SNAKE，占位符 ${SIGMA}/${TENANT_ID}/${APP_ID}） */
+const _yamlRowsToInsertSql = (rows, tableName, typeLabel) => {
+    if (!Array.isArray(rows) || rows.length === 0) return '';
+    const escape = (v) => {
+        if (v == null) return 'NULL';
+        if (typeof v === 'boolean') return v ? '1' : '0';
+        if (typeof v === 'number') return String(v);
+        return "'" + String(v).replace(/'/g, "''") + "'";
+    };
+    const cols = ['ID', 'CODE', 'NAME', 'COMMENT', 'ICON', 'SORT', 'TYPE', 'SIGMA', 'TENANT_ID', 'APP_ID', 'ACTIVE', 'LANGUAGE', 'CREATED_AT', 'CREATED_BY', 'UPDATED_AT', 'UPDATED_BY'];
+    const header = `-- =============================================================\n-- 逆向生成: ${tableName} (${typeLabel})\n-- =============================================================\n\nINSERT IGNORE INTO \`${tableName}\` (\n    \`${cols.join('`, `')}\`\n) VALUES\n`;
+    const placeholders = "'${SIGMA}', '${TENANT_ID}', '${APP_ID}', 1, 'zh_CN', NOW(), '9a0d5018-33ad-4c64-80bf-8ae7947c482f', NOW(), '9a0d5018-33ad-4c64-80bf-8ae7947c482f'";
+    const vals = rows.map((row) => {
+        const code = escape(row.code);
+        const name = escape(row.name);
+        const comment = escape(row.comment);
+        const icon = escape(row.icon);
+        const sort = row.sort != null ? Number(row.sort) : 0;
+        const type = escape(row.type || typeLabel);
+        return `(UUID(), ${code}, ${name}, ${comment}, ${icon}, ${sort}, ${type}, ${placeholders})`;
+    });
+    return header + vals.join(',\n') + ';';
+};
+
 module.exports = async () => {
     try {
         const dirArg = parseOptional('dir', 'd');
+        const isReverse = parseBool('reverse', 'r');
         const directory = (dirArg.value && dirArg.value.trim()) || '.';
         const basePath = path.resolve(process.cwd(), directory);
 
@@ -212,6 +303,81 @@ module.exports = async () => {
         if (projectName) Ec.waiting(`检测到 Maven 项目: ${projectName}`);
 
         const { type, targetDir } = await _detectProjectType(basePath, projectName);
+
+        if (isReverse) {
+            const dbdictDir = path.join(targetDir, ...R2MO_DBDICT_REL);
+            if (!exists(dbdictDir) || !fs.statSync(dbdictDir).isDirectory()) {
+                Ec.warn(`未找到 dbdict 目录: ${dbdictDir}`);
+                Ec.warn('逆向 -r 需要 DPA 时 -ui 下或 ONE 时当前项目下存在 .r2mo/data/dbdict');
+                process.exit(1);
+            }
+            Ec.waiting(`dbdict 输入: ${dbdictDir}`);
+
+            const yaml = _requireOptional('js-yaml', 'js-yaml');
+            if (!yaml) {
+                Ec.warn('需要 js-yaml，请执行: npm install js-yaml');
+                process.exit(1);
+            }
+            const yamlFiles = fs.readdirSync(dbdictDir).filter((f) => f.endsWith('.yaml') && (f.startsWith('dict.') || f.startsWith('tree.')));
+            if (yamlFiles.length === 0) {
+                Ec.warn(`未找到 dict.*.yaml 或 tree.*.yaml: ${dbdictDir}`);
+                process.exit(1);
+            }
+            const withMetadata = [];
+            for (const file of yamlFiles) {
+                const fullPath = path.join(dbdictDir, file);
+                const parsed = parseFile(fullPath);
+                if (!parsed || !parsed.attributes || !parsed.attributes.sqlPath) {
+                    Ec.waiting(`跳过（无 metadata）: ${file}`);
+                    continue;
+                }
+                const sqlPath = String(parsed.attributes.sqlPath || '').trim();
+                const sqlFile = String(parsed.attributes.sqlFile || path.basename(sqlPath)).trim();
+                if (!sqlPath) continue;
+                let rows;
+                try {
+                    rows = yaml.load(parsed.body || '[]');
+                } catch (e) {
+                    Ec.warn(`跳过 ${file}: 解析 body 失败 ${e.message}`);
+                    continue;
+                }
+                rows = Array.isArray(rows) ? rows : (rows && rows.items ? rows.items : []);
+                if (!rows.length) continue;
+                const isTree = file.startsWith('tree.');
+                const tableName = isTree ? TABLE_CATEGORY : TABLE_TABULAR;
+                const typeLabel = file.replace(/^(dict|tree)\.|\.yaml$/gi, '').trim() || 'default';
+                withMetadata.push({ file, fullPath, sqlFile, sqlPath, rows, tableName, typeLabel });
+            }
+            if (withMetadata.length === 0) {
+                Ec.warn('未找到含有 sqlPath 元数据的 yaml 文件，逆向跳过');
+                process.exit(0);
+            }
+            Ec.info(`检测到 ${withMetadata.length} 个 yaml 含有 SQL 路径元数据`);
+            try {
+                const answer = await Ec.ask('是否全覆盖已存在的 SQL 文件？(y/N): ');
+                if (!/^y|yes$/i.test((answer || '').trim())) {
+                    Ec.waiting('已取消覆盖');
+                    process.exit(0);
+                }
+            } catch (e) {
+                Ec.waiting('已取消');
+                process.exit(0);
+            }
+            const written = [];
+            for (const item of withMetadata) {
+                const sqlContent = _yamlRowsToInsertSql(item.rows, item.tableName, item.typeLabel);
+                await fsAsync.writeFile(item.sqlPath, sqlContent, 'utf8');
+                written.push({ rel: item.sqlFile, full: item.sqlPath });
+                Ec.waiting(`  ✓ 覆盖: ${item.sqlFile}`);
+            }
+            console.log('');
+            Ec.info('-------- 逆向已覆盖的 flyway SQL --------');
+            written.forEach(({ rel }) => Ec.info('  ' + rel));
+            Ec.info(`✅ 共覆盖 ${written.length} 个 SQL`);
+            console.log('');
+            process.exit(0);
+        }
+
         if (type === 'DPA') {
             Ec.waiting('项目类型: DPA / Domain, Provider, Api 经典架构');
             Ec.waiting(`目标目录（.r2mo/data/dbdict 落点）: ${targetDir}`);
@@ -288,17 +454,36 @@ module.exports = async () => {
             if (!yaml) {
                 process.exit(0);
             }
+            let flywaySqlDir = null;
+            if (type === 'DPA' && projectName) {
+                const domainPath = path.join(basePath, `${projectName}-domain`);
+                flywaySqlDir = _findFlywaySqlDir(domainPath);
+            }
+            if (!flywaySqlDir) flywaySqlDir = _findFlywaySqlDir(basePath);
+
             const written = [];
             for (const [typeVal, rows] of tabularByType) {
                 const safeType = typeVal || 'default';
                 const filePath = path.join(dbdictDir, `dict.${safeType}.yaml`);
-                await fsAsync.writeFile(filePath, yaml.dump(rows, { lineWidth: -1 }), 'utf8');
+                let metadata = null;
+                if (flywaySqlDir) metadata = _findMatchingSqlFile(flywaySqlDir, TABLE_TABULAR, safeType);
+                const body = yaml.dump(rows, { lineWidth: -1 });
+                const content = metadata
+                    ? '---\n' + yaml.dump({ sqlFile: metadata.sqlFile, sqlPath: metadata.sqlPath }) + '---\n' + body
+                    : body;
+                await fsAsync.writeFile(filePath, content, 'utf8');
                 written.push({ rel: `dict.${safeType}.yaml`, full: filePath });
             }
             for (const [typeVal, rows] of categoryByType) {
                 const safeType = typeVal || 'default';
                 const filePath = path.join(dbdictDir, `tree.${safeType}.yaml`);
-                await fsAsync.writeFile(filePath, yaml.dump(rows, { lineWidth: -1 }), 'utf8');
+                let metadata = null;
+                if (flywaySqlDir) metadata = _findMatchingSqlFile(flywaySqlDir, TABLE_CATEGORY, safeType);
+                const body = yaml.dump(rows, { lineWidth: -1 });
+                const content = metadata
+                    ? '---\n' + yaml.dump({ sqlFile: metadata.sqlFile, sqlPath: metadata.sqlPath }) + '---\n' + body
+                    : body;
+                await fsAsync.writeFile(filePath, content, 'utf8');
                 written.push({ rel: `tree.${safeType}.yaml`, full: filePath });
             }