weaver-e10-builder 1.1.9 → 1.2.3

package/dist/commands/report.js

@@ -0,0 +1,666 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { AuthSession } from '../core/auth.js';
+import { ApiClient } from '../core/client.js';
+import { ReportHttp } from '../services/report/http.js';
+import { buildFromSpec } from '../services/report/build.js';
+import { findFormInApp, resolveFormWithPrompt, suggestFormsInApp } from '../services/report/forms.js';
+import { renderReport } from '../services/report/render.js';
+import { createReport, getBaseInfo, getReportDevInfo, listReportModels, listReports } from '../services/report/reports.js';
+import { deleteDataset, getAggregation, getSort, isDatasetUsed, listDatasets, previewDataset, renameDataset, resolveDataset, replaceDataset, saveAggregation, saveSort, } from '../services/report/dataset.js';
+import { fieldKeyOf } from '../services/report/workbook.js';
+import { LEGACY_FILTER_TYPES, LEFT_FILTER_TYPES } from '../services/report/sources.js';
+/**
+ * 建 ReportHttp 并执行。
+ *
+ * `new ApiClient(auth, 1)` —— **写接口不自动重试**。报表的建表/落库都不是幂等操作，
+ * 网络层失败后重放会直接多出一张报表或一份重复配置。
+ */
+export async function withReport(program, appId, fn) {
+    const opts = program.opts();
+    const auth = await AuthSession.fromOptions(opts);
+    if (!auth) {
+        console.error('无法加载认证信息');
+        process.exitCode = 1;
+        return undefined;
+    }
+    const client = new ApiClient(auth, 1);
+    return fn(new ReportHttp(client, appId), !!opts.json);
+}
+function out(json, text, payload) {
+    if (json && payload !== undefined)
+        console.log(JSON.stringify(payload, null, 2));
+    else
+        console.log(text);
+}
+export function registerReportCommands(program) {
+    const report = program.command('report').description('设计器报表（数据集 / 布局 / 查询条件 / 权限 / 版本）');
+    // ── 建表 ──────────────────────────────────────────────────
+    report
+        .command('build')
+        .description('按声明式 spec 一步建表：定源 → 字段预检 → 建表 → 挂数据集 → 落库 → 回读')
+        .requiredOption('--spec <file>', 'spec JSON 文件路径')
+        .option('--dry-run', '只做定源与字段预检，不建表')
+        .option('--form-confirmed', '用户已确认表名（允许模糊命中）')
+        .option('--source-id <id>', '用户已确认的表单 id')
+        .option('--field-confirmed [titles]', '确认「文案与字段真实显示名不同但有意如此」的列；不带值 = 全部确认')
+        .action(async (raw) => {
+        let spec;
+        try {
+            spec = JSON.parse(readFileSync(raw.spec, 'utf-8'));
+        }
+        catch (e) {
+            console.error(`读取 spec 失败：${e.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        const fc = raw.fieldConfirmed;
+        const fieldConfirmed = fc === true
+            ? true
+            : typeof fc === 'string'
+                ? fc.split(/[,，]/).map((s) => s.trim()).filter(Boolean)
+                : undefined;
+        await withReport(program, String(spec.appId || ''), async (http, json) => {
+            const outcome = await buildFromSpec(http, {
+                spec,
+                sourceId: raw.sourceId,
+                formConfirmed: !!raw.formConfirmed,
+                fieldConfirmed,
+                dryRun: !!raw.dryRun,
+            });
+            renderBuildOutcome(outcome, json);
+        });
+    });
+    report
+        .command('find')
+        .description('应用内查找表单（定源）；非完全精准匹配会列出候选让用户确认')
+        .argument('<appId>', '应用 ID')
+        .argument('[name]', '表单名')
+        .option('--list', '列出应用内全部表单')
+        .option('--suggest <keywords>', '按关键词给候选')
+        .option('--json', 'JSON 输出')
+        .action(async (appId, name, raw) => {
+        await withReport(program, appId, async (http, json) => {
+            const r = raw.list || (!name && !raw.suggest)
+                ? await suggestFormsInApp(http, appId, raw.suggest ? [raw.suggest] : [])
+                : raw.suggest
+                    ? await suggestFormsInApp(http, appId, [raw.suggest])
+                    : await findFormInApp(http, appId, name);
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+                return;
+            }
+            if (r.id && !r.needConfirm) {
+                console.log(`命中：${r.name}  sourceId=${r.id}`);
+                return;
+            }
+            console.log(`${r.message || '需要确认'}`);
+            for (const c of r.candidates || [])
+                console.log(`  - ${c.name}  (${c.id})`);
+            process.exitCode = r.id ? 0 : 3;
+        });
+    });
+    // ── 创建模式 ──────────────────────────────────────────────
+    const create = report.command('create').description('新建报表（空白 / 模板 / 快速构建）');
+    create
+        .command('models')
+        .description('列出可用的报表模板')
+        .action(async () => {
+        await withReport(program, '', async (http, json) => {
+            const models = await listReportModels(http);
+            if (json)
+                console.log(JSON.stringify(models, null, 2));
+            else
+                models.forEach((m) => console.log(`${m.id}\t${m.name}`));
+        });
+    });
+    create
+        .command('blank')
+        .description('新建空白报表')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .requiredOption('--name <name>', '报表名')
+        .action(async (raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const id = await createReport(http, { appId: raw.appId, name: raw.name });
+            out(json, `已创建：${raw.name}\n设计器地址：${http.designerUrl(id)}`, {
+                ok: true,
+                reportId: id,
+                designerUrl: http.designerUrl(id),
+            });
+        });
+    });
+    create
+        .command('template')
+        .description('按模板新建报表')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .requiredOption('--name <name>', '报表名')
+        .requiredOption('--model-id <id>', '模板 ID（report models 可查）')
+        .action(async (raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const id = await createReport(http, {
+                appId: raw.appId,
+                name: raw.name,
+                reportModel: String(raw.modelId),
+            });
+            out(json, `已按模板创建：${raw.name}\n设计器地址：${http.designerUrl(id)}`, {
+                ok: true,
+                reportId: id,
+                designerUrl: http.designerUrl(id),
+            });
+        });
+    });
+    create
+        .command('quick')
+        .description('快速构建（列表式）：按 quicklyParam 生成')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .requiredOption('--name <name>', '报表名')
+        .requiredOption('--quickly-file <file>', 'quicklyParam JSON 文件')
+        .action(async (raw) => {
+        const quicklyParam = JSON.parse(readFileSync(raw.quicklyFile, 'utf-8'));
+        delete quicklyParam._comment;
+        await withReport(program, raw.appId, async (http, json) => {
+            const id = await createReport(http, { appId: raw.appId, name: raw.name, quicklyParam });
+            out(json, `已创建：${raw.name}\n设计器地址：${http.designerUrl(id)}`, {
+                ok: true,
+                reportId: id,
+                designerUrl: http.designerUrl(id),
+            });
+        });
+    });
+    // ── 读取 ──────────────────────────────────────────────────
+    report
+        .command('read')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .option('--fields', '只列字段记录')
+        .description('读报表基础信息与设计数据')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http, json) => {
+            const base = await getBaseInfo(http, reportId);
+            const appId = raw.appId || String(base.appId || '');
+            const dev = await getReportDevInfo(http, reportId);
+            const datasets = appId ? await listDatasets(http, reportId, appId) : [];
+            if (json) {
+                console.log(JSON.stringify({ base, datasets, fields: dev.fields }, null, 2));
+                return;
+            }
+            console.log(`报表：${base.name}  (${reportId})`);
+            console.log(`应用：${appId}  分组：${base.groupId}`);
+            console.log(`数据集：${datasets.length}`);
+            datasets.forEach((d) => console.log(`  - ${d.name}  datasetId=${d.id}  sourceId=${d.sourceId}`));
+            if (raw.fields) {
+                console.log(`字段记录：${(dev.fields || []).length}`);
+                (dev.fields || []).forEach((f) => console.log(`  (${f.x},${f.y}) ${f.cellType}\t${f.text ?? ''}\t${f.name ?? ''}`));
+            }
+            console.log(`设计器地址：${http.designerUrl(reportId)}`);
+        });
+    });
+    report
+        .command('list')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .option('--page-size <n>', '每页条数', '200')
+        .description('列出应用内的报表')
+        .action(async (raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const rows = await listReports(http, raw.appId, { pageSize: Number(raw.pageSize) });
+            if (json)
+                console.log(JSON.stringify(rows, null, 2));
+            else
+                rows.forEach((r) => console.log(`${r.id ?? r.reportId}\t${r.name ?? r.reportName}`));
+        });
+    });
+    report
+        .command('render')
+        .argument('<reportId>', '报表 ID')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .option('--page-row-count <n>', '每页行数（会被自动压到安全上限）')
+        .option('--condition <json>', '查询条件 JSON', '{}')
+        .option('--dump <file>', '把渲染出的 workbook 写到文件（排查版面问题用）')
+        .option('--timeout <ms>', '超时毫秒', '60000')
+        .description('渲染报表并回读展开后的行列数（证明真跑得出来；撞 5 万格上限会给出收敛建议）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const r = await renderReport(http, {
+                reportId,
+                appId: raw.appId,
+                pageRowCount: raw.pageRowCount ? Number(raw.pageRowCount) : undefined,
+                condition: raw.condition,
+                timeoutMs: Number(raw.timeout) || 60000,
+                withWorkbook: !!raw.dump,
+            });
+            if (raw.dump && r.workbook) {
+                writeFileSync(raw.dump, JSON.stringify(r.workbook, null, 2), 'utf8');
+            }
+            if (json) {
+                const { workbook: _drop, ...rest } = r;
+                console.log(JSON.stringify(rest, null, 2));
+            }
+            else if (r.ok) {
+                console.log(`渲染成功：${r.rowCount} 行 × ${r.colCount} 列` +
+                    (r.pageRowCount ? `（每页 ${r.pageRowCount} 行${r.pageRowCountCapped ? '，已封顶' : ''}）` : '') +
+                    `  ${r.ms}ms`);
+                if (raw.dump)
+                    console.log(`workbook 已写入 ${raw.dump}`);
+            }
+            else {
+                console.error(`渲染失败：${r.msg || '无响应'}${r.code ? `（code=${r.code}）` : ''}`);
+                if (r.hint)
+                    console.error(`  ${r.hint}`);
+            }
+            if (!r.ok)
+                process.exitCode = 1;
+        });
+    });
+    report
+        .command('delete')
+        .argument('<reportId>', '报表 ID')
+        .option('--app-id <id>', '应用 ID')
+        .description('删除报表（进回收站，可还原）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId || '', async (http) => {
+            const { deleteReport } = await import('../services/report/reports.js');
+            const r = await deleteReport(http, reportId, raw.appId);
+            if (r?.code !== 200) {
+                console.error(`删除失败：${r?.msg || '无响应'}`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(`已删除报表 ${reportId}（可在回收站还原）`);
+        });
+    });
+    // ── 关联字段推断 / 预聚合 ──────────────────────────────────
+    report
+        .command('join-suggest')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .option('--parent-source <id>', '主表 sourceId')
+        .option('--child-source <id>', '子表 sourceId')
+        .option('--parent-form <name>', '主表名（与 --parent-source 二选一）')
+        .option('--child-form <name>', '子表名（与 --child-source 二选一）')
+        .option('--top <n>', '候选个数', '5')
+        .description('推断两张表之间的关联字段（结果必须由用户确认）')
+        .action(async (raw) => {
+        const { suggestJoinFields } = await import('../services/report/analyze.js');
+        await withReport(program, raw.appId, async (http, json) => {
+            const resolve = async (idOpt, nameOpt) => {
+                if (idOpt)
+                    return String(idOpt);
+                if (!nameOpt)
+                    throw new Error('需要 --parent-source/--child-source 或 --parent-form/--child-form');
+                const hit = await findFormInApp(http, raw.appId, String(nameOpt));
+                if (!hit.id) {
+                    throw new Error(`未找到表单「${nameOpt}」${hit.candidates?.length ? `；候选：${hit.candidates.map((c) => c.name).join('、')}` : ''}`);
+                }
+                return hit.id;
+            };
+            const p = await resolve(raw.parentSource, raw.parentForm);
+            const c = await resolve(raw.childSource, raw.childForm);
+            const r = await suggestJoinFields(http, raw.appId, p, c, { top: Number(raw.top) });
+            if (json) {
+                console.log(JSON.stringify(r, null, 2));
+                return;
+            }
+            console.log(r.message);
+            r.candidates.forEach((x, i) => console.log(`  ${i + 1}. ${x.parent.text}(${x.parent.name})  ↔  ${x.child.text}(${x.child.name})  [${x.score}] ${x.reason}`));
+            if (r.ambiguous)
+                console.log('⚠️ 前两名分差很小，务必让用户选择，不要替用户拿主意。');
+            if (!r.candidates.length)
+                process.exitCode = 3;
+        });
+    });
+    const py = report.command('py').description('分析类辅助（原为 Python，已内置）');
+    py.command('left-filter')
+        .requiredOption('--parent-ds <id>', '父侧 datasetId')
+        .requiredOption('--parent-src <id>', '父侧 sourceId')
+        .requiredOption('--parent-field <name>', '父侧字段系统名（field_xxx）')
+        .requiredOption('--child-ds <id>', '子侧 datasetId')
+        .requiredOption('--child-src <id>', '子侧 sourceId')
+        .requiredOption('--child-field <name>', '子侧字段系统名（field_xxx）')
+        .option('--type <t>', '比较方式（TitleCase，默认 Equals）', 'Equals')
+        .description('算跨数据集父格筛选：输出 subordination + leftFilterField（设计器按三段式 fieldKey 回显）')
+        .action((raw) => {
+        const type = String(raw.type || 'Equals');
+        if (LEGACY_FILTER_TYPES.has(type)) {
+            console.error(`type「${type}」是简写，平台不认；请用 TitleCase（Equals / NotContain / Null…）。`);
+            process.exitCode = 1;
+            return;
+        }
+        if (!LEFT_FILTER_TYPES.has(type)) {
+            console.error(`type「${type}」不在白名单内。有效值：${[...LEFT_FILTER_TYPES].join(' / ')}`);
+            process.exitCode = 1;
+            return;
+        }
+        const pk = fieldKeyOf(raw.parentDs, raw.parentSrc, raw.parentField);
+        const ck = fieldKeyOf(raw.childDs, raw.childSrc, raw.childField);
+        const payload = {
+            subordination: [pk, ck],
+            leftFilterField: [{ parentField: pk, currentField: ck, type, id: ck }],
+        };
+        console.log(JSON.stringify(payload, null, 2));
+    });
+    py.command('preagg')
+        .option('--fields <file>', '字段 JSON（数组，或含 fieldsKey/fields 的对象）')
+        .option('--layout <file>', '布局单元格 JSON（可选）')
+        .option('--report-id <id>', '直接从线上报表读字段与布局')
+        .option('--app-id <id>', '应用 ID')
+        .description('判断预聚合能否开启（命中任一阻断条件即建议关闭）')
+        .action(async (raw) => {
+        const { checkPreaggregate } = await import('../services/report/analyze.js');
+        const normalize = (j) => {
+            if (Array.isArray(j))
+                return j;
+            for (const k of ['fieldsKey', 'originFields', 'fields', 'data']) {
+                if (Array.isArray(j?.[k]))
+                    return j[k];
+            }
+            return [];
+        };
+        let fields = [];
+        let layout = [];
+        if (raw.reportId) {
+            await withReport(program, raw.appId || '', async (http, json) => {
+                const dev = await getReportDevInfo(http, raw.reportId);
+                const r = checkPreaggregate(dev.fields || [], dev.fields || []);
+                if (json)
+                    console.log(JSON.stringify(r, null, 2));
+                else {
+                    console.log(`建议 dataPreAgg = ${r.dataPreAgg}`);
+                    r.reasons.forEach((x) => console.log(`  阻断：${x}`));
+                    console.log(`sheetConfig = ${r.sheetConfig}`);
+                }
+                if (!r.dataPreAgg)
+                    process.exitCode = 2;
+            });
+            return;
+        }
+        if (raw.fields)
+            fields = normalize(JSON.parse(readFileSync(raw.fields, 'utf-8')));
+        if (raw.layout)
+            layout = normalize(JSON.parse(readFileSync(raw.layout, 'utf-8')));
+        const r = checkPreaggregate(fields, layout);
+        console.log(JSON.stringify(r, null, 2));
+        if (!r.dataPreAgg)
+            process.exitCode = 2;
+    });
+    registerDatasetCommands(report, program);
+    return report;
+}
+/** 把 build 的四类结果翻译成输出与退出码。 */
+function renderBuildOutcome(o, json) {
+    if (o.kind === 'need-form') {
+        if (json)
+            console.log(JSON.stringify(o, null, 2));
+        else {
+            console.log(`【需要确认表】${o.message}`);
+            if (o.confirmPrompt)
+                console.log(o.confirmPrompt);
+            o.candidates.forEach((c) => console.log(`  - ${c.name}  (${c.id})`));
+            console.log(`未创建任何报表。确认后复跑：${o.next.cli}`);
+        }
+        process.exitCode = 3;
+        return;
+    }
+    if (o.kind === 'need-field') {
+        if (json)
+            console.log(JSON.stringify(o, null, 2));
+        else {
+            console.log(`【需要指定字段】${o.message}`);
+            if (o.sourceKey)
+                console.log(`  未命中的源：${o.sourceKey}（${o.formName}）`);
+            o.unmatched.forEach((u) => {
+                console.log(`  - 列「${u.column}」${u.reason}`);
+                if (u.candidates?.length) {
+                    console.log(`    候选：${u.candidates.map((c) => `${c.text}(${c.name})`).join('、')}`);
+                }
+            });
+            console.log(`确认后复跑：${o.next.cli}`);
+        }
+        process.exitCode = 4;
+        return;
+    }
+    if (o.kind === 'dry-run') {
+        if (json)
+            console.log(JSON.stringify(o, null, 2));
+        else {
+            console.log(`[预演] 表单：${o.formName}  sourceId=${o.sourceId}  (${o.match})`);
+            (o.sources || []).slice(1).forEach((s2) => console.log(`       子源 [${s2.key}] ${s2.formName}  sourceId=${s2.sourceId}  · ${s2.columns.length} 列`));
+            (o.crossFilters || []).forEach((cf) => console.log(`       跨源：列「${cf.column}」${cf.child} ← ${cf.parent}`));
+            (o.bindings || []).forEach((b) => console.log(`  ${b.column} → ${b.displayText} [${b.field}]`));
+            console.log('未写入任何数据。');
+        }
+        return;
+    }
+    if (json) {
+        console.log(JSON.stringify(o, null, 2));
+    }
+    else {
+        console.log(`报表：${o.name}  (${o.reportId})`);
+        const srcs = o.sources?.length ? o.sources : null;
+        if (srcs) {
+            console.log(`数据源：${srcs.length} 个`);
+            srcs.forEach((s2, i) => console.log(`  ${i === 0 ? '父' : '子'} [${s2.key || '主表'}] ${s2.formName} → 数据集 ${s2.datasetName} (${s2.datasetId})` +
+                `${s2.datasetReused ? ' [复用]' : ''} · ${s2.columns.length} 列`));
+        }
+        else {
+            console.log(`数据源：${o.formName} → 数据集 ${o.datasetName} (${o.datasetId})${o.datasetReused ? ' [复用]' : ''}`);
+        }
+        if (o.crossFilters?.length) {
+            console.log(`跨源父格筛选：${o.crossFilters.length} 处`);
+            o.crossFilters.forEach((cf) => console.log(`  (${cf.cell}) ${cf.child} ← ${cf.parent}  ${cf.type}`));
+            console.log(`带缓存保存：${o.cacheSave === 'ok' ? '已完成（预聚合已关）' : o.cacheSave === 'failed' ? '失败（见警告）' : '跳过'}`);
+        }
+        console.log(`绑定：${o.fieldBindings.length} 列 · 字段记录 ${o.fields} 条`);
+        o.fieldBindings.forEach((b) => console.log(`  ${b.column} → ${b.displayText} [${b.field}]${b.mismatchConfirmed ? '（文案已确认）' : ''}`));
+        for (const w of o.warnings)
+            console.error(`注意：${w}`);
+        console.log(`设计器地址：${o.designerUrl}`);
+    }
+    if (o.warnings.length)
+        process.exitCode = 2;
+}
+function registerDatasetCommands(report, program) {
+    const ds = report.command('dataset').description('数据集侧栏操作（重命名 / 聚合 / 排序 / 替换 / 移除 / 预览）');
+    ds.command('list')
+        .argument('<reportId>', '报表 ID')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .description('列出报表已挂载的数据集')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            const rows = await listDatasets(http, reportId, raw.appId);
+            if (json)
+                console.log(JSON.stringify(rows, null, 2));
+            else
+                rows.forEach((d) => console.log(`${d.id}\t${d.name}\tsourceId=${d.sourceId}`));
+        });
+    });
+    ds.command('add')
+        .argument('<reportId>', '报表 ID')
+        .requiredOption('--app-id <id>', '应用 ID')
+        .option('--form <name>', '表单名（精确匹配才自动绑定）')
+        .option('--source-id <id>', '已确认的表单 ID（与 --form 二选一）')
+        .option('--source-type <type>', '注册契约：LOGIC（普通应用，默认）/ form（共享表）/ ETEAMS（SQL 视图）')
+        .option('--source-group <g>', '注册分组，默认 weaver-ebuilder-form-service')
+        .option('--source-name <name>', '数据集显示名（缺后缀会自动补）')
+        .option('--form-confirmed', '已确认表名（允许模糊命中）')
+        .description('给已有报表**再挂一个数据源**（同源只挂一次；挂完在数据源面板里手动布局或用 report build 的多源 spec）')
+        .action(async (reportId, raw) => {
+        await withReport(program, raw.appId, async (http, json) => {
+            if (!raw.form && !raw.sourceId) {
+                console.error('需要 --form 或 --source-id。');
+                process.exitCode = 1;
+                return;
+            }
+            const gate = await resolveFormWithPrompt(http, raw.appId, String(raw.form || ''), {
+                sourceId: raw.sourceId,
+                confirmedSourceId: raw.sourceId,
+                formConfirmed: !!raw.formConfirmed,
+                suggestOnly: !raw.form && !raw.sourceId,
+            });
+            if (gate.needConfirm) {
+                if (json)
+                    console.log(JSON.stringify({ action: 'confirm_form', ...gate }, null, 2));
+                else {
+                    console.log(`【需要确认表名】${gate.message || gate.reason}`);
+                    (gate.candidates || []).forEach((c) => console.log(`  - ${c.name} (${c.id})`));
+                }
+                process.exitCode = 3;
+                return;
+            }
+            const sourceId = String(gate.form.id);
+            const ds = await resolveDataset(http, {
+                reportId,
+                appId: raw.appId,
+                sourceId,
+                sourceType: raw.sourceType,
+                sourceGroup: raw.sourceGroup,
+                sourceName: raw.sourceName || gate.form.name,
+            });
+            if (json)
+                console.log(JSON.stringify({ form: gate.form, dataset: ds }, null, 2));
+            else {
+                console.log(`已挂载：${gate.form.name} → 数据集 ${ds.name} (${ds.id})` +
+                    `${ds.reused ? ' [复用已有]' : ' [新建]'}`);
+                if (ds.duplicates?.length) {
+                    console.log(`注意：同源存在重复挂载 ${ds.duplicates.join(', ')}，建议清理。`);
+                }
+                console.log(`设计器地址：${http.designerUrl(reportId)}`);
+            }
+        });
+    });
+    ds.command('rename')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .requiredOption('--name <name>', '新显示名')
+        .option('--name-label-id <id>', '多语言 ID', '-1')
+        .description('改数据集显示名')
+        .action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            const r = await renameDataset(http, raw.datasetId, raw.name, raw.nameLabelId);
+            if (r?.code !== 200) {
+                console.error(`重命名失败：${r?.msg || '无响应'}`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(`已重命名：${raw.name}`);
+        });
+    });
+    ds.command('preview')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .description('预览数据集数据')
+        .action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            console.log(JSON.stringify(await previewDataset(http, raw.datasetId), null, 2));
+        });
+    });
+    ds.command('check-used')
+        .requiredOption('--report-id <id>', '报表 ID')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .description('检查数据集是否仍被画布引用')
+        .action(async (raw) => {
+        await withReport(program, '', async (http, json) => {
+            const used = await isDatasetUsed(http, raw.reportId, raw.datasetId);
+            out(json, used ? '仍被引用，不能直接移除' : '未被引用，可以移除', { used, canDelete: !used });
+            if (used)
+                process.exitCode = 1;
+        });
+    });
+    ds.command('delete')
+        .requiredOption('--report-id <id>', '报表 ID')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .option('--force', '跳过引用检查，强制移除')
+        .description('从报表移除数据集')
+        .action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            if (!raw.force) {
+                const used = await isDatasetUsed(http, raw.reportId, raw.datasetId);
+                if (used) {
+                    console.error('数据集仍被画布引用，无法移除。先清掉单元格上的字段引用，或用 --force 强制移除。');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            const r = await deleteDataset(http, raw.reportId, raw.datasetId);
+            if (r?.code !== 200) {
+                console.error(`移除失败：${r?.msg || '无响应'}`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(`已移除数据集 ${raw.datasetId}`);
+        });
+    });
+    const agg = ds.command('agg').description('数据集预聚合');
+    agg.command('get').requiredOption('--dataset-id <id>', '数据集 ID').action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            console.log(JSON.stringify(await getAggregation(http, raw.datasetId), null, 2));
+        });
+    });
+    agg
+        .command('save')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .requiredOption('--file <file>', '聚合配置 JSON')
+        .action(async (raw) => {
+        const data = JSON.parse(readFileSync(raw.file, 'utf-8'));
+        await withReport(program, '', async (http) => {
+            const r = await saveAggregation(http, raw.datasetId, data);
+            if (r?.code !== 200) {
+                console.error(`保存失败：${r?.msg || '无响应'}`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log('已保存聚合配置');
+        });
+    });
+    agg
+        .command('clear')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            await saveAggregation(http, raw.datasetId, []);
+            console.log('已清空聚合配置');
+        });
+    });
+    const sort = ds.command('sort').description('数据集排序');
+    sort.command('get').requiredOption('--dataset-id <id>', '数据集 ID').action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            console.log(JSON.stringify(await getSort(http, raw.datasetId), null, 2));
+        });
+    });
+    sort
+        .command('save')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .requiredOption('--file <file>', '排序配置 JSON')
+        .action(async (raw) => {
+        const data = JSON.parse(readFileSync(raw.file, 'utf-8'));
+        await withReport(program, '', async (http) => {
+            const r = await saveSort(http, raw.datasetId, data);
+            if (r?.code !== 200) {
+                console.error(`保存失败：${r?.msg || '无响应'}`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log('已保存排序配置');
+        });
+    });
+    sort
+        .command('clear')
+        .requiredOption('--dataset-id <id>', '数据集 ID')
+        .action(async (raw) => {
+        await withReport(program, '', async (http) => {
+            await saveSort(http, raw.datasetId, []);
+            console.log('已清空排序配置');
+        });
+    });
+    ds.command('replace')
+        .requiredOption('--file <file>', '替换配置 JSON（含 fieldMap）')
+        .description('替换数据集（整表换源）')
+        .action(async (raw) => {
+        const body = JSON.parse(readFileSync(raw.file, 'utf-8'));
+        await withReport(program, '', async (http) => {
+            const id = await replaceDataset(http, body);
+            console.log(`已替换数据集，新 datasetId=${id}`);
+        });
+    });
+}
+// commander 的父命令引用（registerDatasetCommands 里复用全局 program 选项）
+let program;
+export function bindReportProgram(p) {
+    program = p;
+}
+//# sourceMappingURL=report.js.map