zero-ai 1.0.84 → 1.0.86

package/src/commander-ai/fn.ex.api.js

@@ -1,999 +0,0 @@
-"use strict";
-
-const Ec = require("../epic");
-const fs = require("fs");
-const path = require("path");
-const Ut = require("../commander-shared");
-const yaml = require("js-yaml");
-const inquirer = require("inquirer");
-const { v4: uuidv4 } = require("uuid");
-
-const CONFIG_DIR = ".r2mo/task/command/ex-api";
-const REQUIRED_ENV_DB = ["Z_DB_TYPE", "Z_DB_HOST", "Z_DB_PORT", "Z_DBS_INSTANCE", "Z_DB_APP_USER", "Z_DB_APP_PASS"];
-const REQUIRED_ENV_APP = ["Z_APP_ID", "Z_TENANT", "Z_SIGMA"];
-const R2_BY_UUID = "9a0d5018-33ad-4c64-80bf-8ae7947c482f";
-const REFERENCE_ROLE_ID = "e501b47a-c08b-4c83-b12b-95ad82873e96";
-
-/** 全局列（开发时按 RBAC Flyway 建表固定，执行时仅 DML，不查元数据）：S_RESOURCE/S_ACTION/S_PERMISSION 写入，Excel 不写入 */
-const GLOBAL_COLUMNS = [
-    { name: "SIGMA", value: () => process.env.Z_SIGMA || "" },
-    { name: "APP_ID", value: () => process.env.Z_APP_ID || "" },
-    { name: "TENANT_ID", value: () => process.env.Z_TENANT || "" },
-    { name: "CREATED_BY", value: () => R2_BY_UUID },
-    { name: "UPDATED_BY", value: () => R2_BY_UUID },
-    { name: "CREATED_AT", value: () => new Date().toISOString().slice(0, 19).replace("T", " ") },
-    { name: "UPDATED_AT", value: () => new Date().toISOString().slice(0, 19).replace("T", " ") }
-];
-
-function getGlobalColsAndVals() {
-    const cols = GLOBAL_COLUMNS.map((c) => c.name);
-    const vals = GLOBAL_COLUMNS.map((c) => c.value());
-    return { cols, vals };
-}
-
-/**
- * 扫描 sheet 中所有 {TABLE} 区域：某行首格为 "{TABLE}" 则开启一个表，下一格为表名；紧跟 2 行为表头（中文、英文），之后为数据区；下一处 {TABLE} 或 sheet 末为数据区结束。
- * 返回 [{ tableName, tableStartRow, dataStartRow, dataEndRow, columnNames: [name], columnIndex: { name: colNum } }, ...]
- */
-function scanTableRegions(ws, maxScanRows) {
-    if (!ws) return [];
-    const regions = [];
-    const limit = maxScanRows || 5000;
-    let i = 1;
-    while (i <= limit) {
-        const row = ws.getRow(i);
-        const first = row.getCell(1).value;
-        const v = first != null ? String(first).trim() : "";
-        if (v === "{TABLE}") {
-            const tableNameCell = row.getCell(2).value;
-            const tableName = tableNameCell != null ? String(tableNameCell).trim() : "";
-            const headerRowCount = 2;
-            const dataStartRow = i + 1 + headerRowCount;
-            let dataEndRow = dataStartRow - 1;
-            let j = i + 1;
-            while (j <= limit) {
-                const nextRow = ws.getRow(j);
-                const nextFirst = nextRow.getCell(1).value;
-                const nv = nextFirst != null ? String(nextFirst).trim() : "";
-                if (nv === "{TABLE}") {
-                    dataEndRow = j - 1;
-                    break;
-                }
-                dataEndRow = j;
-                j++;
-            }
-            const enHeaderRow = ws.getRow(i + 2);
-            const columnNames = [];
-            const columnIndex = {};
-            enHeaderRow.eachCell({ includeEmpty: true }, (cell, colNumber) => {
-                const val = cell && cell.value != null ? String(cell.value).trim() : "";
-                if (val) {
-                    columnNames.push(val);
-                    columnIndex[val] = colNumber;
-                }
-            });
-            regions.push({
-                tableName,
-                tableStartRow: i,
-                dataStartRow,
-                dataEndRow,
-                columnNames,
-                columnIndex
-            });
-            i = dataEndRow + 1;
-            continue;
-        }
-        i++;
-    }
-    return regions;
-}
-
-/** 在指定 TABLE 区域内找最后一行有数据的行号（按首列非空判断），返回下一行用于追加；若无则返回 dataStartRow */
-function findAppendRowInRegion(ws, dataStartRow, dataEndRow) {
-    let last = dataStartRow - 1;
-    for (let r = dataStartRow; r <= dataEndRow; r++) {
-        const cell = ws.getRow(r).getCell(1).value;
-        if (cell != null && String(cell).trim() !== "") last = r;
-    }
-    return last + 1;
-}
-
-/** 将 uri 转为文件名安全片段：/ -> -，去首尾 -，长度限制 */
-function uriToFileNameSlug(uri) {
-    if (!uri || !String(uri).trim()) return "default";
-    return String(uri)
-        .trim()
-        .replace(/\//g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-|-$/g, "")
-        .slice(0, 120);
-}
-
-/** 无 target 时解析到 -api 项目目录（当前为父目录时取 xxx-api，已在 -api 内则用 cwd） */
-function resolveExcelRoot(cwd, target) {
-    if (target && target.root && target.module) {
-        const zeroModule = process.env.ZERO_MODULE;
-        return path.resolve(zeroModule, `zero-exmodule-${target.module}`);
-    }
-    const artifactId = getArtifactIdFromPom(cwd);
-    const apiDir = artifactId ? path.resolve(cwd, artifactId + "-api") : null;
-    if (apiDir && fs.existsSync(apiDir)) return apiDir;
-    return cwd;
-}
-
-function getArtifactIdFromPom(cwd) {
-    const pomPath = path.resolve(cwd, "pom.xml");
-    if (!fs.existsSync(pomPath)) return null;
-    let content = fs.readFileSync(pomPath, "utf-8");
-    content = content.replace(/<parent>[\s\S]*?<\/parent>/i, "");
-    const m = content.match(/<artifactId>([^<]+)<\/artifactId>/);
-    return m ? m[1].trim() : null;
-}
-
-function loadAppEnv(filePath) {
-    if (!fs.existsSync(filePath)) return false;
-    const content = fs.readFileSync(filePath, "utf-8");
-    content.split(/\r?\n/).forEach((line) => {
-        const trimmed = line.trim();
-        if (trimmed.startsWith("#") || !trimmed.startsWith("export ")) return;
-        const match = trimmed.match(/^export\s+([A-Za-z0-9_]+)=["']?([^"'\n]*)["']?/);
-        if (match) process.env[match[1]] = match[2].trim();
-    });
-    return true;
-}
-
-function resolveAppEnvPath(cwd) {
-    const primary = path.resolve(cwd, ".r2mo", "app.env");
-    if (fs.existsSync(primary)) return primary;
-    let artifactId = getArtifactIdFromPom(cwd);
-    if (!artifactId) artifactId = path.basename(cwd);
-    if (artifactId && artifactId !== ".") {
-        const apiDir = `${artifactId}-api`;
-        const nested = path.resolve(cwd, apiDir, ".r2mo", "app.env");
-        if (fs.existsSync(nested)) return nested;
-        const sibling = path.resolve(cwd, "..", apiDir, ".r2mo", "app.env");
-        if (fs.existsSync(sibling)) return sibling;
-    }
-    return null;
-}
-
-function checkEnv(keys, label) {
-    const missing = keys.filter((k) => !process.env[k] || !String(process.env[k]).trim());
-    if (missing.length > 0) {
-        Ec.error(`${label}：以下环境变量必须全部已设置。`);
-        Ec.info("当前缺失：" + missing.join(", "));
-        process.exit(1);
-    }
-}
-
-function isDpaRoot(dir) {
-    const pom = path.join(dir, "pom.xml");
-    if (!fs.existsSync(pom)) return false;
-    const id = getArtifactIdFromPom(dir);
-    if (!id) return false;
-    const apiDir = path.join(dir, `${id}-api`);
-    const domainDir = path.join(dir, `${id}-domain`);
-    return fs.existsSync(apiDir) && fs.existsSync(domainDir);
-}
-
-/** 校验 metadata.r：须为 "<METHOD> <uri>"，METHOD 常见动词，uri 以 /api 开头 */
-function validateExApiR(r) {
-    if (!r || typeof r !== "string") return { valid: false, error: "r 为空" };
-    const s = String(r).trim();
-    if (!s) return { valid: false, error: "r 为空" };
-    const parts = s.split(/\s+/);
-    if (parts.length < 2) return { valid: false, error: "r 须为 \"<METHOD> <uri>\" 两段" };
-    const method = (parts[0] || "").toUpperCase();
-    const uri = parts.slice(1).join(" ").trim();
-    const allowed = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
-    if (!allowed.includes(method)) return { valid: false, error: "METHOD 须为 " + allowed.join("/") };
-    if (!uri.startsWith("/api")) return { valid: false, error: "uri 须以 /api 为前缀" };
-    return { valid: true };
-}
-
-/** 解析 ex-api 配置目录：cwd / 上级 / 上上级 */
-function resolveExApiConfigDir(cwd) {
-    const primary = path.resolve(cwd, CONFIG_DIR);
-    if (fs.existsSync(primary) && fs.statSync(primary).isDirectory()) return primary;
-    const parent = path.resolve(cwd, "..", CONFIG_DIR);
-    if (fs.existsSync(parent) && fs.statSync(parent).isDirectory()) return parent;
-    const grand = path.resolve(cwd, "..", "..", CONFIG_DIR);
-    if (fs.existsSync(grand) && fs.statSync(grand).isDirectory()) return grand;
-    return primary;
-}
-
-/** 表格化打印 ex-api 汇总 */
-function printExApiTable(results) {
-    const rows = results.map((r) => ({
-        identifier: r.identifier || "—",
-        request: r.request || "—",
-        ok: r.ok ? "✓" : "✗",
-        error: r.error || "—"
-    }));
-    const col = (arr, key) => arr.map((x) => String(x[key] != null ? x[key] : ""));
-    const max = (arr) => Math.max(2, ...arr.map((s) => (s && s.length) || 0));
-    const wId = max(col(rows, "identifier"));
-    const wReq = Math.min(max(col(rows, "request")), 48);
-    const wErr = Math.min(max(col(rows, "error")), 32);
-    const sep = " | ";
-    Ec.info("[ex-api] 汇总：");
-    Ec.info("  " + "identifier".padEnd(wId) + sep + "request".padEnd(wReq) + sep + "ok" + sep + "error".padEnd(wErr));
-    rows.forEach((r) => Ec.info("  " + (r.identifier + "").padEnd(wId) + sep + (r.request + "").slice(0, wReq).padEnd(wReq) + sep + r.ok + sep + (r.error + "").slice(0, wErr)));
-}
-
-/** 单条 API 执行：使用 config.metadata.r 作为 request，执行 DB + Excel，返回汇总 */
-async function runOneExApi(cwd, conn, config, requestRaw, skip) {
-    const metadata = config.metadata;
-    const target = config.target;
-    let method = "";
-    let uri = "";
-    if (requestRaw && String(requestRaw).trim()) {
-        const parts = String(requestRaw).trim().split(/\s+/);
-        if (parts.length >= 2) {
-            method = parts[0].toUpperCase();
-            uri = parts.slice(1).join(" ").trim();
-        }
-    }
-    if (!skip && (!method || !uri)) {
-        return { identifier: metadata.identifier || "—", request: requestRaw || "—", ok: false, error: "缺少 metadata.r 或格式非 \"<METHOD> <uri>\"" };
-    }
-    if (!skip && uri && !uri.trim().startsWith("/api")) {
-        return { identifier: metadata.identifier || "—", request: requestRaw || "—", ok: false, error: "uri 必须以 /api 为前缀" };
-    }
-
-    try {
-    const appId = process.env.Z_APP_ID;
-        const tenantId = process.env.Z_TENANT;
-        const sigma = process.env.Z_SIGMA;
-
-        let actionId = null;
-        let resourceId = null;
-        let insertedResource = null;
-        let insertedAction = null;
-        let insertedPermission = null;
-        const insertedRolePerms = [];
-
-        if (!skip && method && uri) {
-            const level = metadata.level != null ? metadata.level : 1;
-            const brief = metadata.brief || "";
-            const identifier = metadata.identifier || "default";
-            const keyword = metadata.keyword && String(metadata.keyword).trim();
-            const resourceCode = keyword
-                ? "res." + keyword
-                : ("res_" + (metadata.resource || "api").replace(/\./g, "_") + "_" + method + "_" + uri.replace(/\//g, "_").replace(/^\s+|\s+$/g, "").slice(0, 48) || "res_api");
-            const actionCode = keyword ? "act." + keyword : "act_" + (metadata.resource || "api").replace(/\./g, "_");
-
-            // 实体表按 CODE 去重：先按 METHOD+URI 查，再按 CODE+SIGMA 查，存在则不插入
-            let [rows] = await conn.execute(
-                "SELECT ID, RESOURCE_ID FROM S_ACTION WHERE METHOD = ? AND URI = ? LIMIT 2",
-                [method, uri]
-            );
-            if (rows && rows.length > 1) {
-                [rows] = await conn.execute(
-                    "SELECT ID, RESOURCE_ID FROM S_ACTION WHERE METHOD = ? AND URI = ? AND SIGMA = ? AND APP_ID = ? AND TENANT_ID = ? LIMIT 1",
-                    [method, uri, sigma, appId, tenantId]
-                );
-            }
-            if (rows && rows.length > 0) {
-                actionId = rows[0].ID;
-                resourceId = rows[0].RESOURCE_ID;
-                Ec.info("[ex-api] 已存在 S_ACTION（METHOD+URI），ID=" + actionId);
-            } else {
-                const [actByCode] = await conn.execute("SELECT ID, RESOURCE_ID FROM S_ACTION WHERE CODE = ? AND SIGMA = ? LIMIT 1", [actionCode, sigma]);
-                if (actByCode && actByCode.length > 0) {
-                    actionId = actByCode[0].ID;
-                    resourceId = actByCode[0].RESOURCE_ID;
-                    Ec.info("[ex-api] 已存在 S_ACTION（CODE 去重），ID=" + actionId);
-                } else {
-                    const [resRows] = await conn.execute("SELECT ID FROM S_RESOURCE WHERE CODE = ? AND SIGMA = ? LIMIT 1", [resourceCode, sigma]);
-                    if (resRows && resRows[0]) {
-                        resourceId = resRows[0].ID;
-                        Ec.info("[ex-api] 已存在 S_RESOURCE（CODE 去重），ID=" + resourceId);
-                    } else {
-                        resourceId = uuidv4();
-                        const resBaseCols = ["ID", "NAME", "CODE", "IDENTIFIER", "TYPE", "LEVEL", "MODE_ROLE"];
-                        const resBaseVals = [resourceId, brief, resourceCode, identifier, metadata.resource || "resource.ambient", level, "UNION"];
-                        const resGlobal = getGlobalColsAndVals();
-                        const resCols = resBaseCols.concat(resGlobal.cols);
-                        const resVals = resBaseVals.concat(resGlobal.vals);
-                        const resPlaceholders = resCols.map(() => "?").join(", ");
-                        await conn.execute(
-                            "INSERT INTO S_RESOURCE (" + resCols.join(", ") + ") VALUES (" + resPlaceholders + ")",
-                            resVals
-                        );
-                        insertedResource = { CODE: resourceCode, NAME: brief, IDENTIFIER: identifier, TYPE: metadata.resource || "resource.ambient", LEVEL: level, MODE_ROLE: "UNION" };
-                        Ec.info("[ex-api] 已插入 S_RESOURCE，ID=" + resourceId);
-                    }
-
-                    actionId = uuidv4();
-                    const actBaseCols = ["ID", "CODE", "NAME", "RESOURCE_ID", "METHOD", "URI", "LEVEL"];
-                    const actBaseVals = [actionId, actionCode, brief, resourceId, method, uri, level];
-                    const actGlobal = getGlobalColsAndVals();
-                    const actCols = actBaseCols.concat(actGlobal.cols);
-                    const actVals = actBaseVals.concat(actGlobal.vals);
-                    const actPlaceholders = actCols.map(() => "?").join(", ");
-                    await conn.execute(
-                        "INSERT INTO S_ACTION (" + actCols.join(", ") + ") VALUES (" + actPlaceholders + ")",
-                        actVals
-                    );
-                    insertedAction = { CODE: actionCode, NAME: brief, RESOURCE_ID: resourceId, METHOD: method, URI: uri, LEVEL: level };
-                    Ec.info("[ex-api] 已插入 S_ACTION，ID=" + actionId);
-                }
-            }
-        }
-
-        let permissionId = null;
-        const permIdentifier = metadata.identifier || "default";
-        let permissionMode = "new";
-
-        if (!skip) {
-            const ans = await inquirer.prompt([
-                {
-                    type: "list",
-                    name: "permissionMode",
-                    message: "追加新权限 / 使用已有权限？",
-                    choices: [
-                        { name: "追加新权限", value: "new" },
-                        { name: "使用已有权限（按 identifier 选择）", value: "existing" }
-                    ]
-                }
-            ]);
-            permissionMode = ans.permissionMode;
-
-            if (permissionMode === "existing") {
-                const [permRows] = await conn.execute("SELECT ID, CODE, NAME FROM S_PERMISSION WHERE IDENTIFIER = ?", [permIdentifier]);
-                if (!permRows || permRows.length === 0) {
-                    Ec.info("当前 identifier 下无已有权限，将按新权限创建");
-                    permissionMode = "new";
-                } else {
-                    const { selectedPerm } = await inquirer.prompt([
-                        {
-                            type: "list",
-                            name: "selectedPerm",
-                            message: "选择要追加到的权限",
-                            choices: permRows.map((r) => ({ name: `${r.NAME} (${r.CODE})`, value: r.ID }))
-                        }
-                    ]);
-                    permissionId = selectedPerm;
-                }
-            }
-            if (permissionMode === "new" || !permissionId) {
-                const brief = metadata.brief || "";
-                const keyword = metadata.keyword && String(metadata.keyword).trim();
-                const permCode = keyword ? "perm." + keyword : ("perm_" + (metadata.resource || "api").replace(/\./g, "_").slice(0, 64));
-                const [ex] = await conn.execute("SELECT ID FROM S_PERMISSION WHERE CODE = ? AND SIGMA = ? LIMIT 1", [permCode, sigma]);
-                if (ex && ex[0]) {
-                    permissionId = ex[0].ID;
-                    Ec.info("[ex-api] 已存在 S_PERMISSION（CODE 去重），ID=" + permissionId);
-                } else {
-                    permissionId = uuidv4();
-                    const permBaseCols = ["ID", "CODE", "NAME", "IDENTIFIER", "COMMENT"];
-                    const permBaseVals = [permissionId, permCode, brief, permIdentifier, brief];
-                    const permGlobal = getGlobalColsAndVals();
-                    const permCols = permBaseCols.concat(permGlobal.cols);
-                    const permVals = permBaseVals.concat(permGlobal.vals);
-                    const permPlaceholders = permCols.map(() => "?").join(", ");
-                    await conn.execute(
-                        "INSERT INTO S_PERMISSION (" + permCols.join(", ") + ") VALUES (" + permPlaceholders + ")",
-                        permVals
-                    );
-                    insertedPermission = { CODE: permCode, NAME: brief, IDENTIFIER: permIdentifier, COMMENT: brief };
-                    Ec.info("[ex-api] 已插入 S_PERMISSION，ID=" + permissionId);
-                }
-            }
-        }
-
-        let roleIds = [];
-        let roleIdToCode = {}; // roleId -> CODE，供输出路径分流使用
-        let roleIdToName = {}; // roleId -> NAME，供汇总输出使用
-        if (!skip) {
-            const [roleRows] = await conn.execute("SELECT ID, NAME, CODE FROM S_ROLE ORDER BY NAME");
-            if (!roleRows || roleRows.length === 0) {
-                Ec.info("[ex-api] S_ROLE 中无角色，跳过授权");
-            } else {
-                // 建立 roleId -> CODE/NAME 映射（所有角色）
-                roleRows.forEach((r) => {
-                    const id = String(r.ID != null ? r.ID : r.id);
-                    roleIdToCode[id] = r.CODE || "";
-                    roleIdToName[id] = r.NAME || "";
-                });
-
-                // 过滤掉超级管理员角色（固定输出，不需要用户选择）
-                const selectableRoles = roleRows.filter((r) => {
-                    const id = String(r.ID != null ? r.ID : r.id);
-                    return id !== REFERENCE_ROLE_ID;
-                });
-
-                if (selectableRoles.length > 0) {
-                    const answer = await inquirer.prompt([
-                        {
-                            type: "checkbox",
-                            name: "selectedRoles",
-                            message: "选择要授权当前 API 的角色（可多选，超级管理员已自动包含）",
-                            choices: selectableRoles.map((r) => ({ name: `${r.NAME || r.CODE} (${r.CODE || '-'})`, value: String(r.ID != null ? r.ID : r.id) })),
-                            pageSize: 999
-                        }
-                    ]);
-                    const raw = answer.selectedRoles;
-                    if (Array.isArray(raw)) {
-                        roleIds = raw.map((id) => (id != null ? String(id) : id));
-                    } else if (raw != null && raw !== "") {
-                        roleIds = [String(raw)];
-                    } else {
-                        roleIds = [];
-                    }
-                }
-                Ec.info("[ex-api] 已选角色数（不含超级管理员）：" + roleIds.length + (roleIds.length > 0 ? "，ID=" + roleIds.slice(0, 5).join(",") + (roleIds.length > 5 ? "..." : "") : ""));
-            }
-        }
-
-        if (!skip && permissionId && roleIds.length > 0) {
-            for (const roleId of roleIds) {
-                await conn.execute(
-                    "INSERT IGNORE INTO R_ROLE_PERM (ROLE_ID, PERM_ID) VALUES (?, ?)",
-                    [roleId, permissionId]
-                );
-                insertedRolePerms.push({ ROLE_ID: roleId, PERM_ID: permissionId });
-            }
-            Ec.info("[ex-api] 已同步 R_ROLE_PERM，角色数：" + roleIds.length);
-        }
-
-        // 汇总与 Excel 写入前：查询已有记录，供 Excel 填充（本次未插入时也写出当前 resource/role-perm）
-        let existingResource = null;
-        let existingAction = null;
-        let existingPermission = null;
-        if (resourceId && !insertedResource) {
-            const [rows] = await conn.execute("SELECT ID, CODE, NAME, IDENTIFIER, TYPE, LEVEL, MODE_ROLE FROM S_RESOURCE WHERE ID = ? LIMIT 1", [resourceId]);
-            if (rows && rows[0]) existingResource = rows[0];
-        }
-        if (actionId && !insertedAction) {
-            const [rows] = await conn.execute("SELECT ID, CODE, NAME, RESOURCE_ID, METHOD, URI, LEVEL FROM S_ACTION WHERE ID = ? LIMIT 1", [actionId]);
-            if (rows && rows[0]) existingAction = rows[0];
-        }
-        if (permissionId && !insertedPermission) {
-            const [rows] = await conn.execute("SELECT ID, CODE, NAME, IDENTIFIER, COMMENT FROM S_PERMISSION WHERE ID = ? LIMIT 1", [permissionId]);
-            if (rows && rows[0]) existingPermission = rows[0];
-        }
-        let existingRolePerms = [];
-        if (permissionId && insertedRolePerms.length === 0 && (!roleIds || roleIds.length === 0)) {
-            try {
-                const [rpRows] = await conn.execute("SELECT ROLE_ID, PERM_ID FROM R_ROLE_PERM WHERE PERM_ID = ?", [permissionId]);
-                if (rpRows && rpRows.length > 0) {
-                    Ec.info("[ex-api] R_ROLE_PERM 从库中提取 " + rpRows.length + " 条（PERM_ID=" + permissionId + "）");
-                    existingRolePerms = rpRows.map((r) => ({
-                        ROLE_ID: r.ROLE_ID != null ? r.ROLE_ID : r.role_id,
-                        PERM_ID: r.PERM_ID != null ? r.PERM_ID : r.perm_id
-                    }));
-                }
-            } catch (e) {
-                Ec.info("[ex-api] R_ROLE_PERM 查询失败: " + e.message);
-            }
-        }
-
-                Ec.info("[ex-api] R_ROLE_PERM 查询失败: " + e.message);
-            }
-        }
-        // 四张表行数据（Excel 列名与模板英文表头一致）；S_PERM_SET 的 name/type 来自配置 pname/ptype
-        const resRow = resourceId && (insertedResource || existingResource) ? (insertedResource || existingResource) : null;
-        const actRow = actionId && (insertedAction || existingAction) ? (insertedAction || existingAction) : null;
-        const permRow = permissionId && (insertedPermission || existingPermission) ? (insertedPermission || existingPermission) : null;
-        const rowS_RESOURCE = resRow
-            ? {
-                key: resourceId,
-                name: resRow.NAME,
-                modeRole: resRow.MODE_ROLE || "UNION",
-                code: resRow.CODE,
-                identifier: resRow.IDENTIFIER,
-                type: resRow.TYPE,
-                level: resRow.LEVEL,
-                modeGroup: "",
-                modeTree: ""
-            }
-            : null;
-        const rowS_ACTION = actRow && resourceId && permissionId
-            ? {
-                key: actionId,
-                resourceId,
-                permissionId,
-                code: actRow.CODE,
-                method: actRow.METHOD,
-                uri: actRow.URI,
-                name: actRow.NAME,
-                level: actRow.LEVEL,
-                renewalCredit: ""
-            }
-            : null;
-        const rowS_PERMISSION = permRow
-            ? {
-                key: permissionId,
-                name: permRow.NAME,
-                comment: permRow.COMMENT,
-                code: permRow.CODE,
-                identifier: permRow.IDENTIFIER
-            }
-            : null;
-        // S_PERM_SET：name/type 必须从配置 pname/ptype 提取，key 与资源一致，code 与权限一致
-        const rowS_PERM_SET = resourceId && resRow && permRow
-            ? {
-                key: resourceId,
-                code: permRow.CODE,
-                name: (metadata.pname != null && metadata.pname !== "") ? metadata.pname : resRow.NAME,
-                type: (metadata.ptype != null && metadata.ptype !== "") ? metadata.ptype : resRow.TYPE
-            }
-            : null;
-        // 写入 Excel 的数据（仅用于写 Excel，不写库）：
-        // 1. 超级管理员角色（REFERENCE_ROLE_ID）始终包含（如果有 permissionId）
-        // 2. 用户选中的其他角色
-        let rolePermsToWrite = [];
-
-        // 始终添加超级管理员角色
-        if (permissionId) {
-            rolePermsToWrite.push({ ROLE_ID: REFERENCE_ROLE_ID, PERM_ID: permissionId });
-        }
-
-        // 添加用户选中的角色
-        if (permissionId && roleIds && roleIds.length > 0) {
-            roleIds.forEach((rid) => {
-                rolePermsToWrite.push({ ROLE_ID: rid, PERM_ID: permissionId });
-            });
-        }
-
-        // 如果本次有插入记录（R_ROLE_PERM），也合并进来（去重）
-        if (insertedRolePerms.length > 0) {
-            insertedRolePerms.forEach((rp) => {
-                const rid = rp.ROLE_ID != null ? String(rp.ROLE_ID) : String(rp.role_id);
-                const pid = rp.PERM_ID != null ? String(rp.PERM_ID) : String(rp.perm_id);
-                const exists = rolePermsToWrite.some((p) => String(p.ROLE_ID) === rid && String(p.PERM_ID) === pid);
-                if (!exists) {
-                    rolePermsToWrite.push({ ROLE_ID: rid, PERM_ID: pid });
-                }
-            });
-        }
-
-        // 如果库中已有记录（existingRolePerms），也合并进来（去重）
-        if (existingRolePerms.length > 0) {
-            existingRolePerms.forEach((rp) => {
-                const rid = rp.ROLE_ID != null ? String(rp.ROLE_ID) : String(rp.role_id);
-                const pid = rp.PERM_ID != null ? String(rp.PERM_ID) : String(rp.perm_id);
-                const exists = rolePermsToWrite.some((p) => String(p.ROLE_ID) === rid && String(p.PERM_ID) === pid);
-                if (!exists) {
-                    rolePermsToWrite.push({ ROLE_ID: rid, PERM_ID: pid });
-                }
-            });
-        }
-
-        rolePermsToWrite = rolePermsToWrite.map((p) => ({
-            ROLE_ID: p.ROLE_ID != null ? p.ROLE_ID : p.role_id,
-            PERM_ID: p.PERM_ID != null ? p.PERM_ID : p.perm_id
-        }));
-
-        Ec.info("[ex-api] 📋 R_ROLE_PERM 写入前数据：");
-        Ec.info("[ex-api]   insertedRolePerms.length = " + insertedRolePerms.length);
-        Ec.info("[ex-api]   existingRolePerms.length = " + existingRolePerms.length);
-        Ec.info("[ex-api]   permissionId = " + (permissionId || "—"));
-        Ec.info("[ex-api]   roleIds.length = " + (roleIds ? roleIds.length : 0));
-        Ec.info("[ex-api]   rolePermsToWrite.length = " + rolePermsToWrite.length);
-        if (rolePermsToWrite.length > 0) {
-            rolePermsToWrite.slice(0, 10).forEach((p, i) => {
-                Ec.info("[ex-api]   rolePermsToWrite[" + i + "] = { ROLE_ID: " + (p.ROLE_ID != null ? p.ROLE_ID : "undefined") + ", PERM_ID: " + (p.PERM_ID != null ? p.PERM_ID : "undefined") + " }");
-            });
-            if (rolePermsToWrite.length > 10) Ec.info("[ex-api]   ... 共 " + rolePermsToWrite.length + " 条");
-        }
-
-        // Excel 输出：有 target 时为 DPA zero-exmodule-{module}；无 target 时输出到 -api 项目；文件名固化 identifier-method-uri
-        const excelRoot = resolveExcelRoot(cwd, target);
-        const domainName = target && target.module ? `zero-exmodule-${target.module}-domain` : null;
-        const pluginsBase = domainName
-            ? path.join(excelRoot, domainName, "src", "main", "resources", "plugins")
-            : path.join(excelRoot, "src", "main", "resources", "plugins");
-        const pluginId = domainName ? `zero-exmodule-${target.module}` : "zero-launcher-configuration";
-        const rbacResourceDir = path.join(pluginsBase, pluginId, "security", "RBAC_RESOURCE");
-        const rbacRoleDir = path.join(pluginsBase, pluginId, "security", "RBAC_ROLE", "ADMIN.SUPER");
-
-        if (!fs.existsSync(rbacResourceDir)) fs.mkdirSync(rbacResourceDir, { recursive: true });
-        if (!fs.existsSync(rbacRoleDir)) fs.mkdirSync(rbacRoleDir, { recursive: true });
-
-        const identifierSlug = (metadata.identifier || "api").replace(/[^a-zA-Z0-9._-]/g, "_");
-        const methodSlug = (method || "GET").toUpperCase();
-        const uriSlug = uriToFileNameSlug(uri);
-        const defaultFileName = `${identifierSlug}-${methodSlug}-${uriSlug}.xlsx`;
-
-        const fileName = defaultFileName;
-        const ExcelJS = require("exceljs");
-        // 模板目录取自 r2mo-init 包内（__dirname），非当前项目 cwd，保证任意项目执行 ai ex-api 都能找到模板
-        const templateDir = path.resolve(__dirname, "..", "_template", "EXCEL", "ex-api");
-        const templateDefPath = path.join(templateDir, "template-def.json");
-        let templateDef = {
-            RBAC_RESOURCE: { templateFile: "template-RBAC_RESOURCE.xlsx", sheetName: "DATA-PERM", tableName: "S_PERM_SET", columns: ["key", "code", "name", "type"] },
-            RBAC_ROLE: { templateFile: "template-RBAC_ROLE.xlsx", sheetName: "DATA-PERM", tableName: "R_ROLE_PERM", columns: ["roleId", "permId"] }
-        };
-        if (fs.existsSync(templateDefPath)) {
-            try {
-                const defJson = JSON.parse(fs.readFileSync(templateDefPath, "utf-8"));
-                if (defJson.RBAC_RESOURCE) templateDef.RBAC_RESOURCE = { ...templateDef.RBAC_RESOURCE, ...defJson.RBAC_RESOURCE };
-                if (defJson.RBAC_ROLE) templateDef.RBAC_ROLE = { ...templateDef.RBAC_ROLE, ...defJson.RBAC_ROLE };
-            } catch (_) {
-                Ec.info("[ex-api] 模版定义解析失败，使用内置格式");
-            }
-        }
-
-        const defRes = templateDef.RBAC_RESOURCE;
-        const defRole = templateDef.RBAC_ROLE;
-        const tableNameRole = defRole.tableName || "R_ROLE_PERM";
-
-        const templateResPath = path.join(templateDir, defRes.templateFile || "template-RBAC_RESOURCE.xlsx");
-        const templateRolePath = path.join(templateDir, defRole.templateFile || "template-RBAC_ROLE.xlsx");
-
-        // 四张表行数据 keyed by 模板中的 tableName（与 scanTableRegions 返回一致）
-        const tableRowData = {
-            S_RESOURCE: rowS_RESOURCE,
-            S_ACTION: rowS_ACTION,
-            S_PERMISSION: rowS_PERMISSION,
-            S_PERM_SET: rowS_PERM_SET
-        };
-
-        let workbook;
-        if (fs.existsSync(templateResPath)) {
-            workbook = await new ExcelJS.Workbook().xlsx.readFile(templateResPath);
-            const wsRes = workbook.getWorksheet(defRes.sheetName || "DATA-PERM") || workbook.worksheets[0];
-            if (wsRes) {
-                const regions = scanTableRegions(wsRes);
-                regions.forEach((region) => {
-                    const dataRow = tableRowData[region.tableName];
-                    if (!dataRow || !region.columnIndex) return;
-                    const row = wsRes.getRow(region.dataStartRow);
-                    Object.keys(dataRow).forEach((col) => {
-                        const colNum = region.columnIndex[col];
-                        if (colNum != null && dataRow[col] != null && dataRow[col] !== "") {
-                            row.getCell(colNum).value = dataRow[col];
-                        }
-                    });
-                });
-            }
-        } else {
-            Ec.info("[ex-api] 未找到模板 " + templateResPath + "，使用固定表头格式（可被解析）");
-            workbook = new ExcelJS.Workbook();
-            const wsRes = workbook.addWorksheet(defRes.sheetName || "DATA-PERM");
-            wsRes.addRow([]);
-            wsRes.addRow([]);
-            ["S_PERM_SET", "S_PERMISSION", "S_ACTION", "S_RESOURCE"].forEach((tname) => {
-                const data = tableRowData[tname];
-                if (tname === "S_PERM_SET" && data) {
-                    wsRes.addRow(["{TABLE}", tname, "", "", ""]);
-                    wsRes.addRow(["权限集主键", "权限代码", "权限集名称", "权限集类型"]);
-                    wsRes.addRow(["key", "code", "name", "type"]);
-                    wsRes.addRow([data.key, data.code, data.name, data.type]);
-                } else if (tname === "S_RESOURCE" && data) {
-                    wsRes.addRow(["{TABLE}", tname, "", "", ""]);
-                    wsRes.addRow(["主键", "名称", "MODE_ROLE", "CODE", "IDENTIFIER", "TYPE", "LEVEL"]);
-                    wsRes.addRow(["key", "name", "modeRole", "code", "identifier", "type", "level"]);
-                    wsRes.addRow([data.key, data.name, data.modeRole, data.code, data.identifier, data.type, data.level]);
-                } else if (tname === "S_ACTION" && data) {
-                    wsRes.addRow(["{TABLE}", tname, "", "", ""]);
-                    wsRes.addRow(["主键", "RESOURCE_ID", "PERMISSION_ID", "CODE", "METHOD", "URI", "NAME", "LEVEL"]);
-                    wsRes.addRow(["key", "resourceId", "permissionId", "code", "method", "uri", "name", "level"]);
-                    wsRes.addRow([data.key, data.resourceId, data.permissionId, data.code, data.method, data.uri, data.name, data.level]);
-                } else if (tname === "S_PERMISSION" && data) {
-                    wsRes.addRow(["{TABLE}", tname, "", "", ""]);
-                    wsRes.addRow(["主键", "名称", "备注", "CODE", "IDENTIFIER"]);
-                    wsRes.addRow(["key", "name", "comment", "code", "identifier"]);
-                    wsRes.addRow([data.key, data.name, data.comment, data.code, data.identifier]);
-                }
-            });
-        }
-        const outResPath = path.join(rbacResourceDir, fileName);
-        await workbook.xlsx.writeFile(outResPath);
-        Ec.info("[ex-api] 已写入 RBAC_RESOURCE：" + outResPath);
-
-        const roleFileName = "falcon-" + fileName;
-        const roleWritePaths = [];
-
-        // 固定参考角色输出：维持原目录规则
-        const hasReferenceRole = rolePermsToWrite.some((p) => String(p.ROLE_ID) === REFERENCE_ROLE_ID);
-        if (hasReferenceRole) {
-            const refPerms = rolePermsToWrite.filter((p) => String(p.ROLE_ID) === REFERENCE_ROLE_ID);
-            if (refPerms.length > 0) {
-                let refWorkbook;
-                if (fs.existsSync(templateRolePath)) {
-                    refWorkbook = await new ExcelJS.Workbook().xlsx.readFile(templateRolePath);
-                    const wsRole = refWorkbook.getWorksheet(defRole.sheetName || "DATA-PERM") || refWorkbook.worksheets[0];
-                    if (wsRole) {
-                        const regionsRole = scanTableRegions(wsRole);
-                        const region = regionsRole.find((r) => String(r.tableName).trim() === String(tableNameRole).trim());
-                        if (region) {
-                            const colRole = region.columnIndex["roleId"] || region.columnIndex["ROLE_ID"] || 1;
-                            const colPerm = region.columnIndex["permId"] || region.columnIndex["PERM_ID"] || 2;
-                            refPerms.forEach((pair, idx) => {
-                                const row = wsRole.getRow(region.dataStartRow + idx);
-                                row.getCell(colRole).value = pair.ROLE_ID;
-                                row.getCell(colPerm).value = pair.PERM_ID;
-                            });
-                        }
-                    }
-                } else {
-                    refWorkbook = new ExcelJS.Workbook();
-                    const wsRole = refWorkbook.addWorksheet(defRole.sheetName || "DATA-PERM");
-                    wsRole.addRow([]);
-                    wsRole.addRow([]);
-                    wsRole.addRow(["{TABLE}", tableNameRole, "角色和权限关系", "", ""]);
-                    wsRole.addRow(["角色ID", "权限ID"]);
-                    wsRole.addRow(["roleId", "permId"]);
-                    refPerms.forEach((p) => wsRole.addRow([p.ROLE_ID, p.PERM_ID]));
-                }
-                const outRefRolePath = path.join(rbacRoleDir, roleFileName);
-                await refWorkbook.xlsx.writeFile(outRefRolePath);
-                roleWritePaths.push(outRefRolePath);
-                Ec.info("[ex-api] 已写入 RBAC_ROLE/ADMIN.SUPER（参考角色）:" + outRefRolePath);
-            }
-        }
-
-        // 其他角色输出：当前工作目录下 src/main/resources/init/oob/role/{CODE}/ 目录
-        const nonReferenceRoleIds = roleIds.filter((rid) => String(rid) !== REFERENCE_ROLE_ID);
-        for (const rid of nonReferenceRoleIds) {
-            const code = roleIdToCode[String(rid)] || "";
-            if (!code) {
-                Ec.info("[ex-api] ⚠️ 警告：角色 ID=" + rid + " 缺少 CODE，跳过输出");
-                continue;
-            }
-            const targetRoleDir = path.join(cwd, "src", "main", "resources", "init", "oob", "role", code);
-            if (!fs.existsSync(targetRoleDir)) {
-                Ec.info("[ex-api] ⚠️ 警告：未找到输出目录 " + targetRoleDir + "，跳过输出");
-                continue;
-            }
-
-            const oneRolePerms = rolePermsToWrite.filter((p) => String(p.ROLE_ID) === String(rid));
-            if (oneRolePerms.length === 0) continue;
-
-            let oneRoleWorkbook;
-            if (fs.existsSync(templateRolePath)) {
-                oneRoleWorkbook = await new ExcelJS.Workbook().xlsx.readFile(templateRolePath);
-                const wsRole = oneRoleWorkbook.getWorksheet(defRole.sheetName || "DATA-PERM") || oneRoleWorkbook.worksheets[0];
-                if (wsRole) {
-                    const regionsRole = scanTableRegions(wsRole);
-                    const region = regionsRole.find((r) => String(r.tableName).trim() === String(tableNameRole).trim());
-                    if (region) {
-                        const colRole = region.columnIndex["roleId"] || region.columnIndex["ROLE_ID"] || 1;
-                        const colPerm = region.columnIndex["permId"] || region.columnIndex["PERM_ID"] || 2;
-                        oneRolePerms.forEach((pair, idx) => {
-                            const row = wsRole.getRow(region.dataStartRow + idx);
-                            row.getCell(colRole).value = pair.ROLE_ID;
-                            row.getCell(colPerm).value = pair.PERM_ID;
-                        });
-                    }
-                }
-            } else {
-                oneRoleWorkbook = new ExcelJS.Workbook();
-                const wsRole = oneRoleWorkbook.addWorksheet(defRole.sheetName || "DATA-PERM");
-                wsRole.addRow([]);
-                wsRole.addRow([]);
-                wsRole.addRow(["{TABLE}", tableNameRole, "角色和权限关系", "", ""]);
-                wsRole.addRow(["角色ID", "权限ID"]);
-                wsRole.addRow(["roleId", "permId"]);
-                oneRolePerms.forEach((p) => wsRole.addRow([p.ROLE_ID, p.PERM_ID]));
-            }
-
-            const outOneRolePath = path.join(targetRoleDir, roleFileName);
-            await oneRoleWorkbook.xlsx.writeFile(outOneRolePath);
-            roleWritePaths.push(outOneRolePath);
-            Ec.info("[ex-api] 已写入角色目录（" + code + "）:" + outOneRolePath);
-        }
-
-        if (roleWritePaths.length === 0) {
-            Ec.info("[ex-api] RBAC_ROLE 未输出任何文件（可能角色未选中或目标目录不存在）");
-        }
-
-        Ec.info("[ex-api] ✅ 执行完成（幂等）");
-        Ec.info("[ex-api] 📋 汇总：");
-        Ec.info("[ex-api]   🔑 ACTION_ID     = " + (actionId || "—"));
-        Ec.info("[ex-api]   🔑 RESOURCE_ID  = " + (resourceId || "—"));
-        Ec.info("[ex-api]   🔑 PERMISSION_ID = " + (permissionId || "—"));
-        Ec.info("[ex-api]   👥 授权角色总数 = " + (rolePermsToWrite.length > 0 ? rolePermsToWrite.length : 0));
-
-        // 固定输出：超级管理员角色
-        const refRoleName = roleIdToName[REFERENCE_ROLE_ID] || "超级管理员";
-        const refRoleCode = roleIdToCode[REFERENCE_ROLE_ID] || "ADMIN.SUPER";
-        Ec.info("[ex-api]   🔒 固定输出角色：");
-        Ec.info("[ex-api]      [1] " + refRoleName + " (CODE: " + refRoleCode + ", ID: " + REFERENCE_ROLE_ID + ")");
-
-        // 用户选择的角色
-        if (roleIds && roleIds.length > 0) {
-            Ec.info("[ex-api]   👤 用户选择角色：");
-            roleIds.forEach((rid, idx) => {
-                const code = roleIdToCode[rid] || "—";
-                const name = roleIdToName[rid] || "—";
-                Ec.info("[ex-api]      [" + (idx + 1) + "] " + name + " (CODE: " + code + ", ID: " + rid + ")");
-            });
-        } else {
-            Ec.info("[ex-api]   👤 用户选择角色：无");
-        }
-
-        Ec.info("[ex-api]   📁 RBAC_RESOURCE = " + outResPath);
-        roleWritePaths.forEach((p) => Ec.info("[ex-api]   📁 RBAC_ROLE     = " + p));
-        if (insertedResource) {
-            Ec.info("[ex-api]   📦 S_RESOURCE 本次插入字段：");
-            Object.keys(insertedResource).forEach((k) => Ec.info("[ex-api]      " + k + " = " + (insertedResource[k] != null ? insertedResource[k] : "—")));
-        }
-        if (existingResource) {
-            Ec.info("[ex-api]   📄 S_RESOURCE 已有记录（有值属性）：");
-            Object.keys(existingResource).forEach((k) => {
-                const v = existingResource[k];
-                if (v != null && v !== "") Ec.info("[ex-api]      " + k + " = " + v);
-            });
-        }
-        if (insertedAction) {
-            Ec.info("[ex-api]   📦 S_ACTION 本次插入字段：");
-            Object.keys(insertedAction).forEach((k) => Ec.info("[ex-api]      " + k + " = " + (insertedAction[k] != null ? insertedAction[k] : "—")));
-        }
-        if (existingAction) {
-            Ec.info("[ex-api]   📄 S_ACTION 已有记录（有值属性）：");
-            Object.keys(existingAction).forEach((k) => {
-                const v = existingAction[k];
-                if (v != null && v !== "") Ec.info("[ex-api]      " + k + " = " + v);
-            });
-        }
-        if (insertedPermission) {
-            Ec.info("[ex-api]   📦 S_PERMISSION 本次插入字段：");
-            Object.keys(insertedPermission).forEach((k) => Ec.info("[ex-api]      " + k + " = " + (insertedPermission[k] != null ? insertedPermission[k] : "—")));
-        }
-        if (existingPermission) {
-            Ec.info("[ex-api]   📄 S_PERMISSION 已有记录（有值属性）：");
-            Object.keys(existingPermission).forEach((k) => {
-                const v = existingPermission[k];
-                if (v != null && v !== "") Ec.info("[ex-api]      " + k + " = " + v);
-            });
-        }
-        if (insertedRolePerms.length > 0) {
-            Ec.info("[ex-api]   📦 R_ROLE_PERM 本次写入（ROLE_ID, PERM_ID）：");
-            insertedRolePerms.forEach((r, i) => Ec.info("[ex-api]      [" + (i + 1) + "] " + r.ROLE_ID + ", " + r.PERM_ID));
-        }
-        return {
-            identifier: metadata.identifier || "—",
-            request: requestRaw || "—",
-            actionId: actionId || "—",
-            resourceId: resourceId || "—",
-            permissionId: permissionId || "—",
-            roleCount: roleIds ? roleIds.length : 0,
-            outResPath: outResPath || "—",
-            outRolePaths: roleWritePaths || [],
-            ok: true
-        };
-    } catch (err) {
-        Ec.error("[ex-api] 执行失败：" + (err && err.message));
-        return {
-            identifier: (metadata && metadata.identifier) || "—",
-            request: requestRaw || "—",
-            actionId: "—",
-            resourceId: "—",
-            permissionId: "—",
-            roleCount: 0,
-            outResPath: "—",
-            outRolePath: "—",
-            ok: false,
-            error: (err && err.message) || String(err)
-        };
-    }
-}
-
-module.exports = async (options) => {
-    const cwd = process.cwd();
-    const configDir = resolveExApiConfigDir(cwd);
-    if (!fs.existsSync(configDir)) {
-        fs.mkdirSync(configDir, { recursive: true });
-        const templatePath = path.join(configDir, "ex-api.yaml");
-        const template = `# ai ex-api 使用此配置，请按项目修改
-metadata:
-  r: "GET /api/ambient"
-  identifier: "核心标识符"
-  brief: "接口描述"
-  resource: "resource.ambient"
-  level: 1
-  ptype: "权限集 S_PERM_SET 类型"
-  pname: "权限集 S_PERM_SET 名称"
-  # keyword 可选
-# target 可选；存在时需 ZERO_MODULE 与 zero-exmodule-{module}
-# target:
-#   root: "ZERO_MODULE"
-#   module: "ambient"
-`;
-        fs.writeFileSync(templatePath, template, "utf-8");
-        Ec.info("配置目录缺失，已创建并写入模板：" + templatePath);
-        Ec.info("请编辑后重新执行：  ai ex-api");
-        process.exit(1);
-    }
-
-    const backupDir = path.join(configDir, "backup");
-    const allEntries = fs.readdirSync(configDir, { withFileTypes: true });
-    const yamlFiles = allEntries.filter((e) => !e.isDirectory() && e.isFile() && (e.name.endsWith(".yaml") || e.name.endsWith(".yml")));
-    const entries = [];
-    for (const e of yamlFiles) {
-        const f = e.name;
-        const full = path.join(configDir, f);
-        try {
-            const config = yaml.load(fs.readFileSync(full, "utf-8"));
-            if (!config || !config.metadata) continue;
-            const r = config.metadata.r != null ? String(config.metadata.r).trim() : "";
-            if (!r) {
-                Ec.info("[ex-api] 跳过（无 metadata.r）：" + f);
-                continue;
-            }
-            const valid = validateExApiR(r);
-            if (!valid.valid) {
-                Ec.info("[ex-api] 警告（r 不合法，已跳过）：" + f + "，" + (valid.error || ""));
-                continue;
-            }
-            const label = (config.metadata.identifier || f) + " | " + (config.metadata.brief || r);
-            entries.push({ path: full, config, label });
-        } catch (_) {}
-    }
-
-    if (entries.length === 0) {
-        Ec.error("[ex-api] 无有效配置：请在 " + configDir + " 下添加含 metadata.r 的 yaml");
-        process.exit(1);
-    }
-
-    const answer = await inquirer.prompt([
-        { type: "checkbox", name: "selected", message: "选择要执行的 API（多选）", choices: entries.map((e) => ({ name: e.label, value: e.path })) }
-    ]);
-    const selectedPaths = answer && answer.selected && Array.isArray(answer.selected) ? answer.selected : [];
-    if (selectedPaths.length === 0) {
-        Ec.info("未选择任何项，退出");
-        process.exit(0);
-    }
-
-    const appEnvPath = resolveAppEnvPath(cwd);
-    if (!appEnvPath) {
-        Ec.error(".r2mo/app.env 不存在；DPA 下也未找到 {id}-api/.r2mo/app.env");
-        process.exit(1);
-    }
-    loadAppEnv(appEnvPath);
-    checkEnv(REQUIRED_ENV_DB, "数据库环境变量");
-    checkEnv(REQUIRED_ENV_APP, "应用环境变量（Z_APP_ID / Z_TENANT / Z_SIGMA）");
-
-    const dbConfig = {
-        host: process.env.Z_DB_HOST || "localhost",
-        port: parseInt(process.env.Z_DB_PORT || "3306", 10),
-        user: process.env.Z_DB_APP_USER,
-        password: process.env.Z_DB_APP_PASS,
-        database: process.env.Z_DBS_INSTANCE
-    };
-    const parsed = Ut.parseArgument(options);
-    const skip = parsed.skip === true || process.argv.includes("-s") || process.argv.includes("--skip");
-
-    const mysql = require("mysql2/promise");
-    let conn;
-    try {
-        conn = await mysql.createConnection(dbConfig);
-        Ec.info("[ex-api] 数据库已连接，执行 " + selectedPaths.length + " 条 API");
-        const results = [];
-        for (const configPath of selectedPaths) {
-            const config = yaml.load(fs.readFileSync(configPath, "utf-8"));
-            const requestRaw = config.metadata && config.metadata.r != null ? String(config.metadata.r).trim() : "";
-            if (!requestRaw) {
-                results.push({ identifier: config.metadata?.identifier || "—", request: "—", ok: false, error: "无 metadata.r" });
-                continue;
-            }
-            const valid = validateExApiR(requestRaw);
-            if (!valid.valid) {
-                Ec.info("[ex-api] 警告（r 不合法，跳过执行）：" + path.basename(configPath) + "，" + (valid.error || ""));
-                results.push({ identifier: config.metadata?.identifier || "—", request: requestRaw, ok: false, error: valid.error || "r 不合法" });
-                continue;
-            }
-            Ec.info("[ex-api] 处理：" + (config.metadata.identifier || path.basename(configPath)) + " (" + requestRaw + ")");
-            const one = await runOneExApi(cwd, conn, config, requestRaw, skip);
-            results.push(one);
-            if (one.ok) {
-                if (!fs.existsSync(backupDir)) fs.mkdirSync(backupDir, { recursive: true });
-                const bakPath = path.join(backupDir, path.basename(configPath) + ".bak");
-                try {
-                    fs.renameSync(configPath, bakPath);
-                    Ec.info("[ex-api] 已备份：" + path.basename(configPath) + " -> backup/" + path.basename(configPath) + ".bak");
-                } catch (errBak) {
-                    Ec.info("[ex-api] 备份失败（已忽略）：" + configPath + "，" + (errBak && errBak.message));
-                }
-            }
-        }
-        printExApiTable(results);
-    } finally {
-        if (conn) await conn.end();
-    }
-};