weaver-e10-builder 1.1.8 → 1.2.2

package/dist/commands/report-validate.js

@@ -0,0 +1,719 @@
+import { readFileSync } from 'node:fs';
+import { withReport } from './report.js';
+import { getBaseInfo, getReportDevInfo, saveReportDevInfo } from '../services/report/reports.js';
+import { listDatasets, fieldsKeyOf } from '../services/report/dataset.js';
+import { checkCellLimit, validateScrollPage, validateShowLocation, validateSnapshotPatch, validateWorkbookGridline, validateSheetPropGridLine, } from '../services/report/guard.js';
+import { mergeWorkbookSafe, fieldToCell, fieldStyle } from '../services/report/safe-save.js';
+import { checkCrossFilters, checkTableNameContract, readCrossFilters, verifyAll, verifyFieldBind, } from '../services/report/verify.js';
+import { hrefCatalog, mapNaturalPhrase, normalizeFont, normalizeGroupType, normalizeHref, normalizeNumberFormat, normalizeTransform, styleCatalog, validateBaseMeta, validateCellPatch, validateConditionRule, FORMAT_CATALOG, GROUP_TYPE_ALIAS, } from '../services/report/validate.js';
+function readInput(raw) {
+    if (raw.inline)
+        return JSON.parse(raw.inline);
+    if (raw.file)
+        return JSON.parse(readFileSync(raw.file, 'utf-8').replace(/^/, ''));
+    return null;
+}
+function printValidation(r, json, payload) {
+    if (json) {
+        console.log(JSON.stringify(payload ?? r, null, 2));
+        return;
+    }
+    r.errors.forEach((e) => console.log(`[错误] ${e.message}`));
+    r.warnings.forEach((e) => console.log(`[警告] ${e.message}`));
+    r.infos.forEach((e) => console.log(`[提示] ${e.message}`));
+    if (r.ok && !r.warnings.length)
+        console.log('通过。');
+    if (!r.ok)
+        process.exitCode = 1;
+}
+/** 取报表的字段记录 + 应用 id。 */
+async function loadDev(http, reportId, appIdArg) {
+    const base = await getBaseInfo(http, reportId);
+    const appId = appIdArg || String(base.appId || base.appid || '');
+    const dev = await getReportDevInfo(http, reportId);
+    return { base, appId, dev, fields: (dev.fields || []) };
+}
+export function registerReportValidateCommands(report, program) {
+    const validate = report.command('validate').description('写入前校验（本地规则，不落库）');
+    validate
+        .command('base')
+        .requiredOption('--name <name>', '报表名')
+        .option('--name-label-id <id>', '多语言 ID', '-1')
+        .option('--group-id <id>', '分组 ID', '0')
+        .option('--show-order <n>', '排序', '1')
+        .description('校验报表名/分组等基础字段的写入规范')
+        .action(async (raw) => {
+        const r = validateBaseMeta({
+            name: raw.name,
+            nameLabelId: raw.nameLabelId,
+            groupId: raw.groupId,
+            showOrder: raw.showOrder,
+        });
+        printValidation(r, false, r.normalized);
+    });
+    validate
+        .command('condition')
+        .option('--file <file>', '规则 JSON 文件')
+        .option('--inline <json>', '规则 JSON 字符串')
+        .option('--map <phrase>', '自然语言，如 "介于 1 5" / "数据条" / "图标集"')
+        .option('--report-id <id>', '按线上报表的实际条件格式校验')
+        .option('--app-id <id>', '应用 ID')
+        .description('校验条件格式规则（白名单 / 冲突）')
+        .action(async (raw) => {
+        if (raw.map) {
+            const r = mapNaturalPhrase(raw.map);
+            printValidation(r, false, r.normalized);
+            return;
+        }
+        if (raw.reportId) {
+            await withReport(program, raw.appId || '', async (http, json) => {
+                const dev = await getReportDevInfo(http, raw.reportId);
+                const r = { ok: true, errors: [], warnings: [], infos: [] };
+                (dev.fields || []).forEach((f) => {
+                    const rule = fieldStyle(f).cellType?.conditionRule || f.conditionRule;
+                    if (!rule || !Object.keys(rule).length)
+                        return;
+                    const sub = validateConditionRule(rule, `(${f.x},${f.y}) ${f.text ?? ''}`);
+                    r.errors.push(...sub.errors);
+                    r.warnings.push(...sub.warnings);
+                });
+                if (r.errors.length)
+                    r.ok = false;
+                printValidation(r, json);
+            });
+            return;
+        }
+        const input = readInput(raw);
+        if (!input) {
+            console.error('需要 --file / --inline / --map / --report-id 之一');
+            process.exitCode = 2;
+            return;
+        }
+        const r = validateConditionRule(input);
+        printValidation(r, false, r.normalized);
+    });
+    validate
+        .command('format')
+        .option('--list', '列出数字格式目录')
+        .option('--map <label>', '中文名，如 货币 / 短日期')
+        .option('--file <file>', '单元格配置 JSON')
+        .option('--inline <json>', '单元格配置 JSON 字符串')
+        .description('校验数字格式 / 日期分组 / 字号字体')
+        .action(async (raw) => {
+        if (raw.list) {
+            console.log(JSON.stringify(FORMAT_CATALOG, null, 2));
+            return;
+        }
+        const r = { ok: true, errors: [], warnings: [], infos: [] };
+        const norm = {};
+        if (raw.map) {
+            const f = normalizeNumberFormat({ map: raw.map });
+            const g = normalizeGroupType(raw.map);
+            Object.assign(r, {
+                errors: [...f.errors, ...g.errors],
+                warnings: [...f.warnings, ...g.warnings],
+            });
+            norm.format = f.normalized;
+            if (g.normalized)
+                norm.groupType = g.normalized;
+        }
+        else {
+            const input = readInput(raw);
+            if (!input) {
+                console.error('需要 --map / --file / --inline / --list 之一');
+                process.exitCode = 2;
+                return;
+            }
+            const patchChk = validateCellPatch(input);
+            r.errors.push(...patchChk.errors);
+            const f = normalizeNumberFormat(input);
+            const g = normalizeGroupType(input.groupType);
+            const font = normalizeFont(input.font);
+            r.errors.push(...f.errors, ...g.errors, ...font.errors);
+            r.warnings.push(...f.warnings, ...g.warnings, ...font.warnings);
+            norm.format = f.normalized;
+            norm.groupType = g.normalized;
+            norm.font = font.normalized;
+        }
+        if (r.errors.length)
+            r.ok = false;
+        printValidation(r, false, norm);
+    });
+    validate
+        .command('transform')
+        .option('--list', '列出转换类型速查')
+        .option('--map <label>', '中文名，如 人员 / 部门全路径 / 二维码')
+        .option('--file <file>', '单元格配置 JSON')
+        .option('--inline <json>', '单元格配置 JSON 字符串')
+        .description('校验转换面板设置')
+        .action(async (raw) => {
+        if (raw.list) {
+            const { TRANS_MAP, QR_MAP, DIR_MAP } = await import('../services/report/validate.js');
+            console.log(JSON.stringify({ TRANS_MAP, QR_MAP, DIR_MAP }, null, 2));
+            return;
+        }
+        const input = raw.map ? { transType: String(raw.map) } : readInput(raw);
+        if (!input) {
+            console.error('需要 --map / --file / --inline / --list 之一');
+            process.exitCode = 2;
+            return;
+        }
+        const r = normalizeTransform(input);
+        printValidation(r, false, r.normalized);
+    });
+    validate
+        .command('href')
+        .option('--list', '列出打开方式与写法规则')
+        .option('--map <label>', '中文名，如 弹出页 / 当前页 / 执行js代码')
+        .option('--file <file>', '单元格配置 JSON')
+        .option('--inline <json>', '单元格配置 JSON 字符串')
+        .option('--fix', '把全角 ？/＆ 自动替换为 ASCII')
+        .description('校验事件超链接写法')
+        .action(async (raw) => {
+        if (raw.list) {
+            console.log(JSON.stringify(hrefCatalog(), null, 2));
+            return;
+        }
+        const input = raw.map ? { map: String(raw.map) } : readInput(raw);
+        if (!input) {
+            console.error('需要 --map / --file / --inline / --list 之一');
+            process.exitCode = 2;
+            return;
+        }
+        const r = normalizeHref(input, { fix: !!raw.fix });
+        printValidation(r, false, r.normalized);
+    });
+    validate
+        .command('gridline')
+        .option('--file <file>', 'workbook 或补丁 JSON')
+        .option('--inline <json>', 'workbook 或补丁 JSON 字符串')
+        .description('校验网格线（workbook 里出现 gridline 键会让保存 500）')
+        .action(async (raw) => {
+        const input = readInput(raw);
+        if (!input) {
+            console.error('需要 --file 或 --inline');
+            process.exitCode = 2;
+            return;
+        }
+        const r = { ok: true, errors: [], warnings: [], infos: [] };
+        const wbChk = validateWorkbookGridline(input);
+        r.errors.push(...wbChk.errors);
+        for (const [i, sp] of (input.sheetProps || []).entries()) {
+            const g = validateSheetPropGridLine(`sheetProps[${i}].gridLine`, sp?.gridLine);
+            r.errors.push(...g.errors);
+            r.warnings.push(...g.warnings);
+            if (g.normalized === 1) {
+                r.warnings.push({ message: `sheetProps[${i}].gridLine=1：网格线默认关闭，未点名开启时请写 0` });
+            }
+        }
+        if (r.errors.length)
+            r.ok = false;
+        printValidation(r, false);
+    });
+    validate
+        .command('blank')
+        .option('--file <file>', '补丁 JSON')
+        .option('--inline <json>', '补丁 JSON 字符串')
+        .description('校验会导致设计区空白的写法')
+        .action(async (raw) => {
+        const input = readInput(raw);
+        if (!input) {
+            console.error('需要 --file 或 --inline');
+            process.exitCode = 2;
+            return;
+        }
+        const r = { ok: true, errors: [], warnings: [], infos: [] };
+        const loc = validateShowLocation(input.showLocation ?? input.sheetProps?.[0]?.showLocation);
+        r.errors.push(...loc.errors);
+        const scroll = validateScrollPage(input.split ?? input.pageSetting?.[0]?.split);
+        r.errors.push(...scroll.errors);
+        if (input.snapshot?.enableSnapshot) {
+            const snap = validateSnapshotPatch(input.snapshot, String(input.reportId || ''), input.name);
+            r.errors.push(...snap.errors);
+            r.warnings.push(...snap.warnings);
+        }
+        if (r.errors.length)
+            r.ok = false;
+        printValidation(r, false);
+    });
+    validate
+        .command('query')
+        .option('--map-show-where <phrase>', '把「顶部筛选」这类说法映射成内部值')
+        .option('--file <file>', '带 showWhere 的条件 JSON')
+        .option('--inline <json>', '带 showWhere 的条件 JSON 字符串')
+        .description('显示方式说法映射 / 条件显示方式规范化')
+        .action(async (raw) => {
+        const { resolveShowWhere, normalizeShowWhere, resolveQueryType } = await import('../services/report/query.js');
+        if (raw.mapShowWhere) {
+            const v = resolveShowWhere(raw.mapShowWhere);
+            if (!v) {
+                console.error(`无法映射显示方式「${raw.mapShowWhere}」。支持：高级搜索 / 筛选（advancedSearch / filter）`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(`${raw.mapShowWhere} → ${v}  (落库 queryType = ${resolveQueryType(v)})`);
+            return;
+        }
+        const input = readInput(raw);
+        if (!input) {
+            console.error('需要 --map-show-where 或 --file / --inline');
+            process.exitCode = 2;
+            return;
+        }
+        const r = normalizeShowWhere(input, raw.showWhere);
+        if (!r.ok) {
+            console.error(r.error);
+            process.exitCode = 1;
+            return;
+        }
+        console.log(`显示方式 = ${r.showWhere}  (落库 queryType = ${resolveQueryType(r.showWhere)})`);
+    });
+    validate
+        .command('style')
+        .option('--list', '列出默认分层样式与目录')
+        .option('--inline <json>', 'spec 片段，看会解析出哪层样式')
+        .description('默认表头样式（标题蓝底 + 表头灰底）')
+        .action(async (raw) => {
+        if (raw.inline) {
+            const { resolveLayerStyles } = await import('../services/report/constants.js');
+            console.log(JSON.stringify(resolveLayerStyles(JSON.parse(raw.inline)), null, 2));
+            return;
+        }
+        console.log(JSON.stringify(styleCatalog(), null, 2));
+    });
+    // ── 体检 ──────────────────────────────────────────────────
+    const verify = report.command('verify').description('落库自检（读回真实数据再断言）');
+    verify
+        .command('bind')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--strict', '把「需用户确认」也当作失败（退出码 2）')
+        .description('字段绑定体检')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const r = await verifyFieldBind(http, reportId, raw.appId, { strict: !!raw.strict });
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+            }
+            else {
+                r.errors.forEach((e) => console.log(`[FAIL] ${e.message}`));
+                r.warnings.forEach((e) => console.log(`[WARN] ${e.message}`));
+                r.confirmations.forEach((e) => console.log(`[待确认] ${e.message}`));
+                console.log(r.summary);
+            }
+            if (r.exitCode)
+                process.exitCode = r.exitCode;
+        });
+    });
+    verify
+        .command('all')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--strict', '把「需用户确认」也当作失败')
+        .description('综合自检：绑定 + 单元格结构 + tableName 契约')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const r = await verifyAll(http, reportId, raw.appId, { strict: !!raw.strict });
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+            }
+            else {
+                r.errors.forEach((e) => console.log(`[FAIL] ${e.message}`));
+                r.warnings.forEach((e) => console.log(`[WARN] ${e.message}`));
+                r.confirmations.forEach((e) => console.log(`[待确认] ${e.message}`));
+                console.log(r.summary);
+            }
+            if (r.exitCode)
+                process.exitCode = r.exitCode;
+        });
+    });
+    verify
+        .command('contract')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('tableName 契约体检（只读）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { fields } = await loadDev(http, reportId, raw.appId);
+            const r = checkTableNameContract(fields);
+            if (json)
+                console.log(JSON.stringify({ ...r, ...r.stats }, null, 2));
+            else {
+                r.warnings.forEach((w) => console.log(`[WARN] ${w.message}`));
+                if (r.ok)
+                    console.log(`PASS — ${r.stats.fieldCells} 个字段格的 tableName 齐全`);
+            }
+            if (!r.ok)
+                process.exitCode = 1;
+        });
+    });
+    verify
+        .command('parents')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('跨数据源父格体检：区域入口格唯一、fieldKey 三段式、id=currentField、算子白名单、锚点落在真实父格')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { fields } = await loadDev(http, reportId, raw.appId);
+            const items = checkCrossFilters(fields);
+            const errors = items.filter((x) => x.level === 'error');
+            const warnings = items.filter((x) => x.level !== 'error');
+            const sources = new Set(fields.filter((f) => f.cellType === 'Field').map((f) => String(f.dataSetId || '')));
+            const cross = fields.filter((f) => f.cellType === 'Field' && (readCrossFilters(f).leftFilterField?.length || 0) > 0).length;
+            if (json) {
+                console.log(JSON.stringify({ datasets: sources.size, crossFilters: cross, items }, null, 2));
+            }
+            else {
+                console.log(`数据集 ${sources.size} 个 · 跨源父格筛选 ${cross} 处`);
+                errors.forEach((e) => console.log(`[FAIL] ${e.message}`));
+                warnings.forEach((w) => console.log(`[WARN] ${w.message}`));
+                if (!errors.length) {
+                    console.log(sources.size > 1
+                        ? 'PASS — 跨源父格配置合规'
+                        : 'PASS — 单数据集，无跨源父格配置');
+                }
+            }
+            if (errors.length)
+                process.exitCode = 1;
+        });
+    });
+    verify
+        .command('meta')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('报表基础信息体检（防列表页 500）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { base } = await loadDev(http, reportId, raw.appId);
+            const r = validateBaseMeta({
+                name: String(base.name ?? ''),
+                nameLabelId: String(base.nameLabelId ?? ''),
+                groupId: String(base.groupId ?? ''),
+                showOrder: String(base.showOrder ?? ''),
+            });
+            if (json)
+                console.log(JSON.stringify({ base, ...r }, null, 2));
+            else
+                printValidation(r, false, r.normalized);
+        });
+    });
+    verify
+        .command('condition')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('线上条件格式体检（非法算子会静默不生成规则）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { fields } = await loadDev(http, reportId, raw.appId);
+            const r = { ok: true, errors: [], warnings: [], infos: [] };
+            fields.forEach((f) => {
+                const rule = fieldStyle(f).cellType?.conditionRule || f.conditionRule;
+                if (!rule || !Object.keys(rule).length)
+                    return;
+                const sub = validateConditionRule(rule, `(${f.x},${f.y}) ${f.text ?? ''}`);
+                r.errors.push(...sub.errors);
+                r.warnings.push(...sub.warnings);
+            });
+            if (r.errors.length)
+                r.ok = false;
+            printValidation(r, json);
+        });
+    });
+    verify
+        .command('format')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('线上单元格格式体检（回显断裂 / 错误货币串）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { fields } = await loadDev(http, reportId, raw.appId);
+            const r = { ok: true, errors: [], warnings: [], infos: [] };
+            fields.forEach((f) => {
+                const cellType = fieldStyle(f).cellType || {};
+                const fmtr = fieldStyle(f).formatter;
+                if (fmtr && !FORMAT_CATALOG.some((c) => c.formatter === fmtr)) {
+                    r.warnings.push({
+                        message: `(${f.x},${f.y}) formatter 非目录全等值「${fmtr}」→ 设计器工具栏可能显示「其他/常规」`,
+                    });
+                }
+                if (/^[¥￥]#,##0/.test(String(fmtr))) {
+                    r.errors.push({ message: `(${f.x},${f.y}) 疑似错误货币串 ${fmtr}，应使用目录货币 formatter` });
+                }
+                const g = cellType.groupType;
+                if (g && g !== 'none' && !Object.values(GROUP_TYPE_ALIAS).includes(g)) {
+                    r.errors.push({ message: `(${f.x},${f.y}) 未知 groupType=${g}` });
+                }
+                if (g === 'yearAndMonth') {
+                    r.errors.push({ message: `(${f.x},${f.y}) groupType=yearAndMonth 应为落库值 yearmonth` });
+                }
+            });
+            if (r.errors.length)
+                r.ok = false;
+            printValidation(r, json);
+        });
+    });
+    verify
+        .command('blank')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('线上设计区空白体检')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { dev, fields } = await loadDev(http, reportId, raw.appId);
+            const r = { ok: true, errors: [], warnings: [], infos: [] };
+            if (!fields.length) {
+                r.errors.push({ message: '字段记录为 0：设计区没有单元格（真清空），优先用历史版本回滚恢复' });
+            }
+            for (const [i, sp] of (dev.sheetProps || []).entries()) {
+                const loc = validateShowLocation(sp?.showLocation);
+                if (!loc.ok)
+                    r.errors.push({ message: `sheetProps[${i}] ${loc.errors[0].message}` });
+                const scroll = validateScrollPage(sp);
+                r.errors.push(...scroll.errors);
+            }
+            const snap = dev.snapshot;
+            if (snap?.enableSnapshot) {
+                if (typeof snap.sheetId === 'number') {
+                    r.errors.push({
+                        message: `线上 snapshot.sheetId 是 number：疑似曾被 Number() 写入，易致设计区空白。请改成字符串重配`,
+                    });
+                }
+                else if (String(snap.sheetId) !== String(reportId)) {
+                    r.errors.push({ message: `snapshot.sheetId=${snap.sheetId} 与 reportId=${reportId} 不一致` });
+                }
+                if (!String(snap.snapshotName || '').trim()) {
+                    r.warnings.push({ message: `snapshotName 为空，建议用默认值` });
+                }
+            }
+            if (r.errors.length)
+                r.ok = false;
+            printValidation(r, json);
+        });
+    });
+    verify
+        .command('gridline')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('线上网格线体检（workbook 里出现 gridline 键会让保存 500）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { dev } = await loadDev(http, reportId, raw.appId);
+            const wbChk = validateWorkbookGridline({ sheets: dev.workbookProps?.sheets });
+            printValidation(wbChk, json);
+        });
+    });
+    verify
+        .command('limit')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--rows <n>', '显式指定行数')
+        .option('--cols <n>', '显式指定列数')
+        .option('--date-values <n>', '日期展开的取值个数')
+        .description('渲染规模预检（只算不渲染）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { appId, fields } = await loadDev(http, reportId, raw.appId);
+            const r = await checkCellLimit(http, reportId, appId, {
+                rows: raw.rows ? Number(raw.rows) : undefined,
+                cols: raw.cols ? Number(raw.cols) : undefined,
+                dateValues: raw.dateValues ? Number(raw.dateValues) : undefined,
+                fields,
+            });
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+            }
+            else {
+                console.log(`设计期 ${r.designedColumns} 列 / ${r.fieldCells} 个字段格`);
+                r.advice.forEach((a) => console.log(`  ${a}`));
+            }
+            if (r.verdict === 'over_limit')
+                process.exitCode = 1;
+        });
+    });
+    // ── 定点修复 ──────────────────────────────────────────────
+    const fix = report.command('fix').description('定点修复（默认只读预演，需 --apply 才落库）');
+    fix
+        .command('echo')
+        .argument('<reportId>', '报表 ID')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .description('同 query fix-echo：把显示方式恢复成设计器认的数组短码')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const { fixQueryItems } = await import('../services/report/query-checks.js');
+            const r = await fixQueryItems(http, reportId);
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+                return;
+            }
+            r.changed.forEach((c) => console.log(`已修 ${c.itemText || c.itemId}：${c.actions.join('、')}`));
+            r.skipped.forEach((s) => console.log(`跳过 ${s.itemText || s.itemId}：${s.reason}`));
+            if (!r.changed.length)
+                console.log('没有需要修的条件。');
+        });
+    });
+    fix
+        .command('table-name')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--apply', '真的落库')
+        .description('补齐 Field 单元格的 tableName（数据源不显示模块类型后缀时用）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { base, appId, dev, fields } = await loadDev(http, reportId, raw.appId);
+            const datasets = await listDatasets(http, reportId, appId);
+            const main = datasets.find((d) => d.sourceId && !d.sourceId.startsWith(reportId.slice(0, 6)));
+            const label = main?.name || datasets[0]?.name || '';
+            let tableName = label;
+            if (main) {
+                try {
+                    const fk = await fieldsKeyOf(http, main.id, reportId, appId, { label, sourceType: main.sourceType });
+                    tableName = String(fk[0]?.datasetName || label);
+                }
+                catch {
+                    /* 用 label 兜底 */
+                }
+            }
+            const before = fields.map((f) => ({ x: f.x, y: f.y, tableName: f.tableName }));
+            const patched = fields.map((f) => {
+                if (f.cellType !== 'Field' || f.tableName)
+                    return f;
+                const cell = fieldToCell(f);
+                cell.style.cellType.tableName = tableName;
+                return { ...f, tableName };
+            });
+            const missingBefore = before.filter((b) => !b.tableName).length;
+            if (json) {
+                console.log(JSON.stringify({ applied: !!raw.apply, missingBefore, tableName, fields: patched.length }, null, 2));
+            }
+            else {
+                console.log(`缺 tableName 的字段格：${missingBefore} 个；将写为「${tableName}」`);
+            }
+            if (!raw.apply) {
+                if (!json)
+                    console.log('（预演，未落库。加 --apply 执行）');
+                return;
+            }
+            const wb = mergeWorkbookSafe({ ...dev, fields: patched }, {
+                patchFn: (w) => {
+                    for (const sheet of Object.values(w.sheets || {})) {
+                        const dt = sheet?.data?.dataTable || {};
+                        for (const f of patched) {
+                            const ct = dt[String(f.x)]?.[String(f.y)]?.style?.cellType;
+                            if (ct && ct.cellType === 'Field')
+                                ct.tableName = tableName;
+                        }
+                    }
+                },
+            });
+            const fresh = await getReportDevInfo(http, reportId);
+            await saveReportDevInfo(http, {
+                appId,
+                reportId,
+                name: String(base.name || ''),
+                workbook: wb,
+                designKey: String(fresh.designKey || ''),
+                groupId: String(base.groupId ?? '0'),
+                nameLabelId: String(base.nameLabelId ?? '-1'),
+            });
+            const after = await getReportDevInfo(http, reportId);
+            const stillMissing = checkTableNameContract(after.fields || []).stats.missingTableName;
+            console.log(`已落库。剩余缺 tableName：${stillMissing} 个`);
+            if (stillMissing)
+                process.exitCode = 2;
+        });
+    });
+    fix
+        .command('freeze')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--anchor <x,y>', '冻结锚点（0 基）；默认首个数据行 + 第 0 列，即只冻结表头')
+        .option('--apply', '真的落库')
+        .description('冻结单元格（锚点上方的行 + 左侧的列）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const { base, appId, dev, fields } = await loadDev(http, reportId, raw.appId);
+            // 重复坐标会让重建悄悄丢格 —— 先拦（退出码 3）
+            const seen = new Map();
+            for (const f of fields) {
+                const k = `${f.x},${f.y}`;
+                seen.set(k, (seen.get(k) || 0) + 1);
+            }
+            const dup = [...seen.entries()].filter(([, n]) => n > 1);
+            if (dup.length) {
+                console.error(`存在重复坐标，重建会丢格，已拒绝：${dup.map(([k, n]) => `${k}×${n}`).join(' ')}`);
+                process.exitCode = 3;
+                return;
+            }
+            let ax;
+            let ay;
+            if (raw.anchor) {
+                const [x, y] = String(raw.anchor).split(',').map((s) => Number(s.trim()));
+                ax = x;
+                ay = y;
+            }
+            else {
+                const vertical = fields.filter((f) => f.expandType === 'Vertical');
+                ax = vertical.length
+                    ? Math.min(...vertical.map((f) => Number(f.x)))
+                    : Math.max(...fields.map((f) => Number(f.x)));
+                ay = 0;
+            }
+            if (!Number.isFinite(ax) || !Number.isFinite(ay)) {
+                throw new Error('--anchor 需为 x,y 形式，例如 --anchor 1,0');
+            }
+            const target = fields.find((f) => Number(f.x) === ax && Number(f.y) === ay);
+            if (!target) {
+                console.error(`锚点格 (${ax},${ay}) 上没有单元格，无法冻结。`);
+                process.exitCode = 1;
+                return;
+            }
+            const prev = fields.filter((f) => f.fixed === 1 || f.tag?.fixed).map((f) => `(${f.x},${f.y})`);
+            console.log(`冻结锚点 (${ax},${ay})；原有锚点：${prev.length ? prev.join(' ') : '无'}`);
+            if (!raw.apply) {
+                console.log('（预演，未落库。加 --apply 执行）');
+                return;
+            }
+            // 重建工作簿：先清掉所有旧 fixed，再打新锚点
+            const patched = fields.map((f) => ({ ...f, fixed: 0 }));
+            const wb = mergeWorkbookSafe({ ...dev, fields: patched }, {
+                patchFn: (w) => {
+                    for (const sheet of Object.values(w.sheets || {})) {
+                        const dt = sheet?.data?.dataTable || {};
+                        for (const row of Object.values(dt)) {
+                            for (const cell of Object.values(row)) {
+                                if (cell?.tag)
+                                    cell.tag.fixed = false;
+                            }
+                        }
+                        const cell = dt[String(ax)]?.[String(ay)];
+                        if (cell?.tag)
+                            cell.tag.fixed = true;
+                        // 下面两个只影响设计器显示，真正持久化的只有 cell.tag.fixed
+                        sheet.frozenRowCount = ax;
+                        sheet.frozenColCount = ay;
+                        sheet.tag = { ...(sheet.tag || {}), fixedCell: { x: ax, y: ay } };
+                    }
+                },
+            });
+            const fresh = await getReportDevInfo(http, reportId);
+            await saveReportDevInfo(http, {
+                appId,
+                reportId,
+                name: String(base.name || ''),
+                workbook: wb,
+                designKey: String(fresh.designKey || ''),
+                groupId: String(base.groupId ?? '0'),
+                nameLabelId: String(base.nameLabelId ?? '-1'),
+            });
+            const after = await getReportDevInfo(http, reportId);
+            const fixedNow = (after.fields || []).filter((f) => Number(f.fixed) === 1);
+            const ok = fixedNow.length === 1 && Number(fixedNow[0].x) === ax && Number(fixedNow[0].y) === ay;
+            console.log(ok
+                ? `已冻结：锚点 (${ax},${ay}) 生效`
+                : `⚠️ 回读校验不通过：当前 fixed 格 ${fixedNow.map((f) => `(${f.x},${f.y})`).join(' ') || '无'}`);
+            if (!ok)
+                process.exitCode = 2;
+        });
+    });
+}
+//# sourceMappingURL=report-validate.js.map