weaver-e10-builder 1.6.14 → 1.6.16

package/dist/services/form-layout-source/preview.js

@@ -46,4 +46,3 @@ export function layoutPreview(artifact) {
     }
     return `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'unsafe-inline'"><title>布局结构核对</title><style>body{font:14px sans-serif;margin:24px;color:#222}h2{font-size:18px}.note{background:#fff3cd;padding:12px;line-height:1.7}section{overflow:auto;margin:20px 0}img{max-width:none}.grid{position:relative;background:white}.cell{position:absolute;display:flex;box-sizing:border-box;padding:3px;overflow:hidden}.cell span{width:100%}.placeholder{color:#666;font:12px sans-serif}</style><h1>布局结构核对</h1><p class="note">本页核对列宽比例、行高、合并、标签和网格边框。字段值用占位符；控件尺寸、字体和输入框实际效果仍需 E10 运行态验收。此预览不是平台截图，pixelVerified=false。${artifact.source.imageStyles?.geometry ? ' 已提供原图像素边界，仍须核对观察是否正确。' : ' 未提供原图像素边界，当前尺寸仅来自观察稿；不得据此宣称与原图一致。'}</p>${image}<section><h2>编译结构（按源尺寸估算）</h2><div class="grid" style="width:${xs[xs.length - 1]}px;height:${ys[ys.length - 1]}px">${boxes}</div></section></html>`;
 }
-//# sourceMappingURL=preview.js.map

package/dist/services/form-layout-source/review.js

@@ -51,4 +51,3 @@ export function reviewSourceLayout(artifact, current) {
         mutationStarted: false,
     };
 }
-//# sourceMappingURL=review.js.map

package/dist/services/form-layout-source/schema.js

@@ -146,4 +146,3 @@ export function validateSpec(spec, source) {
     }
     return sheet;
 }
-//# sourceMappingURL=schema.js.map

package/dist/services/form-layout-source/source-grid.js

@@ -58,4 +58,3 @@ export function bindCell(sheet, comp, p, sourceCell) {
     if (!matches.length)
         sheet.cells.push(cell);
 }
-//# sourceMappingURL=source-grid.js.map

package/dist/services/form-layout-source/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/services/form-layout-source/verify.js

@@ -223,4 +223,3 @@ export async function applySourceLayout(client, baseUrl, artifact) {
     }
     return { saved: report.verified, saveAccepted, mutationStarted: true, recoveredAfterUnknownResult: !!error && report.verified, report, ...(error ? { error } : {}) };
 }
-//# sourceMappingURL=verify.js.map

package/dist/services/form-layout-template-advanced.js

@@ -1450,4 +1450,3 @@ function verifyAdvancedStylePatch(expectedLayout, savedLayout) {
     };
     visit(expected, saved, 'styleConfig');
 }
-//# sourceMappingURL=form-layout-template-advanced.js.map

package/dist/services/form-layout-template-catalog.js

@@ -24,4 +24,3 @@ export async function listTemplateCatalog(client, baseUrl, kind = 'all') {
     }
     return rows;
 }
-//# sourceMappingURL=form-layout-template-catalog.js.map

package/dist/services/form-layout-template-easy.js

@@ -156,4 +156,3 @@ export class EasyTemplateService {
         return { ids, verified: true };
     }
 }
-//# sourceMappingURL=form-layout-template-easy.js.map

package/dist/services/form-layout-template-flow.js

@@ -96,4 +96,3 @@ export class FlowTemplateService {
         return { id: String(saved.id), name, enabled: Boolean(options.enabled), verified: true };
     }
 }
-//# sourceMappingURL=form-layout-template-flow.js.map

package/dist/services/form-layout-template-verification.js

@@ -121,4 +121,3 @@ export function verifyAppliedTemplate(evidence, formLayout) {
     }
     return issues;
 }
-//# sourceMappingURL=form-layout-template-verification.js.map

package/dist/services/form-linkage-condition.js

@@ -356,4 +356,3 @@ export function readLinkageConfig(input) {
 export async function addLinkage(client, baseUrl, appId, formId, payload) {
     return client.post(`${baseUrl}${ADD_PATH}?apid=${appId}`, payload, { ebbusinessid: formId });
 }
-//# sourceMappingURL=form-linkage-condition.js.map

package/dist/services/form-list-columns.js

@@ -244,4 +244,3 @@ export class ListColumnsService {
         return { success: true, verified: true, listId: this.listId, terminal, otherTerminalPreserved: otherPreserved, columns: after.tableField };
     }
 }
-//# sourceMappingURL=form-list-columns.js.map

package/dist/services/form-list-config.js

@@ -366,4 +366,3 @@ export async function setExtendArea(client, baseUrl, appId, objId, listId, optio
     }
     return { success: true, listId, unchanged: false, extendArea: saved };
 }
-//# sourceMappingURL=form-list-config.js.map

package/dist/services/form-list-fields.js

@@ -258,4 +258,3 @@ export function normalizeFieldAttrs(raw) {
     }
     return attrs;
 }
-//# sourceMappingURL=form-list-fields.js.map

package/dist/services/form-list-filter-http.js

@@ -134,4 +134,3 @@ export async function getHttpCondition(client, baseUrl, appId, objId, listId) {
         filterIsNull: pc.filterIsNull,
     };
 }
-//# sourceMappingURL=form-list-filter-http.js.map

package/dist/services/form-list-filter-sql.js

@@ -203,4 +203,3 @@ export async function getSqlCondition(client, baseUrl, appId, objId, listId) {
         dialects: keys.map((key) => ({ key, label: dialectLabel(key), sql: String(sourceSql[key] ?? '') })),
     };
 }
-//# sourceMappingURL=form-list-filter-sql.js.map

package/dist/services/form-list-search-custom.js

@@ -95,4 +95,3 @@ export function buildCustomSearchEntry(config, kind, ids, existing) {
         },
     };
 }
-//# sourceMappingURL=form-list-search-custom.js.map

package/dist/services/form-list-search-group.js

@@ -354,4 +354,3 @@ export function listGroupFilters(listConfig) {
     const arr = listConfig?.searchConditions?.groupFilters;
     return Array.isArray(arr) ? arr : [];
 }
-//# sourceMappingURL=form-list-search-group.js.map

package/dist/services/form-list-search.js

@@ -225,4 +225,3 @@ export function buildSearchFilterEntry(col, existing, opts = {}) {
 export function buildQuickPlaceholder(text) {
     return { nameAlias: String(text ?? '') };
 }
-//# sourceMappingURL=form-list-search.js.map

package/dist/services/form-list-stats.js

@@ -408,4 +408,3 @@ export class ListStatsService {
             statistics: (after.listStatistics?.statisticsList || []).filter((s) => added.includes(String(s.id))) };
     }
 }
-//# sourceMappingURL=form-list-stats.js.map

package/dist/services/form-list-table-fields.js

@@ -262,4 +262,3 @@ export async function setFieldEventGroup(client, baseUrl, appId, objId, listId,
     }
     return { success: true, fieldId, eventGroup: savedField.eventGroup };
 }
-//# sourceMappingURL=form-list-table-fields.js.map

package/dist/services/form-log-setting.js

@@ -0,0 +1,107 @@
+import { DEFAULT_EBUILDER_ROUTE } from './special-route.js';
+import { getFormObj, patchFormObj } from './form-obj-meta.js';
+export const LOG_TYPE_OPTIONS = [
+    { value: '1', label: '查阅情况' },
+    { value: '2', label: '操作日志' },
+    { value: '3', label: '表单修改日志' },
+    { value: '4', label: '打印日志' },
+];
+export const FORM_LOG_SHOW_OPTIONS = [
+    { value: 'group', label: '分组' },
+    { value: 'tile', label: '平铺' },
+];
+/** `dataLogShowType` 目前只确认了 `single`=单个展示，另一档等抓包后再补。 */
+export const DATA_LOG_SHOW_OPTIONS = [
+    { value: 'single', label: '单个展示' },
+];
+function parseLogTypes(value) {
+    let raw = value;
+    if (typeof raw === 'string') {
+        try {
+            raw = JSON.parse(raw);
+        }
+        catch {
+            raw = [];
+        }
+    }
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        const v = String(item);
+        if (LOG_TYPE_OPTIONS.some((o) => o.value === v) && !out.includes(v))
+            out.push(v);
+    }
+    return LOG_TYPE_OPTIONS.filter((o) => out.includes(o.value)).map((o) => o.value);
+}
+/** 读取日志设置。 */
+export async function readFormLogSetting(client, baseUrl, appId, objId, route = DEFAULT_EBUILDER_ROUTE) {
+    const obj = await getFormObj(client, baseUrl, appId, objId, route);
+    return {
+        enableLog: Number(obj.enableLog ?? 0) === 1,
+        logTypes: parseLogTypes(obj.logTypes),
+        formLogShowType: String(obj.formLogShowType ?? ''),
+        dataLogShowType: String(obj.dataLogShowType ?? ''),
+    };
+}
+const sameList = (a, b) => a.length === b.length && a.every((v, i) => v === b[i]);
+/** 修改日志设置：只改点名的项，其余字段原样回写，保存后回读校验。 */
+export async function setFormLogSetting(client, baseUrl, appId, objId, patch, route = DEFAULT_EBUILDER_ROUTE) {
+    const before = await readFormLogSetting(client, baseUrl, appId, objId, route);
+    const changes = [];
+    const payload = {};
+    if (patch.enableLog !== undefined) {
+        if (before.enableLog !== patch.enableLog) {
+            changes.push({ field: 'enableLog', label: '卡片详情页显示日志', from: before.enableLog, to: patch.enableLog });
+            payload.enableLog = patch.enableLog ? 1 : 0;
+        }
+    }
+    if (patch.logTypes !== undefined) {
+        const next = LOG_TYPE_OPTIONS.filter((o) => patch.logTypes.includes(o.value)).map((o) => o.value);
+        if (!sameList(before.logTypes, next)) {
+            changes.push({ field: 'logTypes', label: '日志记录类型', from: before.logTypes, to: next });
+            payload.logTypes = JSON.stringify(next);
+        }
+    }
+    if (patch.formLogShowType !== undefined && before.formLogShowType !== patch.formLogShowType) {
+        changes.push({ field: 'formLogShowType', label: '表单修改日志显示方式', from: before.formLogShowType, to: patch.formLogShowType });
+        payload.formLogShowType = patch.formLogShowType;
+    }
+    if (patch.dataLogShowType !== undefined && before.dataLogShowType !== patch.dataLogShowType) {
+        changes.push({ field: 'dataLogShowType', label: '日志展示模式', from: before.dataLogShowType, to: patch.dataLogShowType });
+        payload.dataLogShowType = patch.dataLogShowType;
+    }
+    if (!changes.length)
+        return { before, after: before, changed: false, changes: [] };
+    await patchFormObj(client, baseUrl, appId, objId, payload, route);
+    const after = await readFormLogSetting(client, baseUrl, appId, objId, route);
+    for (const change of changes) {
+        if (change.field === 'logTypes') {
+            if (!sameList(after.logTypes, change.to)) {
+                throw new Error(`已保存，但回读 logTypes 不一致：期望 ${JSON.stringify(change.to)}，实际 ${JSON.stringify(after.logTypes)}`);
+            }
+        }
+        else if (after[change.field] !== change.to) {
+            throw new Error(`已保存，但回读 ${change.field} 不一致：期望 ${JSON.stringify(change.to)}，实际 ${JSON.stringify(after[change.field])}`);
+        }
+    }
+    return { before, after, changed: true, changes };
+}
+/** 把用户输入的 chip（名称或数字，逗号/空格分隔）转成 logTypes 值列表。`none` 表示清空。 */
+export function parseLogTypeInput(values) {
+    const list = Array.isArray(values) ? values : [values];
+    const tokens = list.flatMap((v) => String(v).split(/[,，\s]+/)).map((s) => s.trim()).filter(Boolean);
+    if (tokens.length === 1 && tokens[0].toLowerCase() === 'none')
+        return [];
+    const out = [];
+    for (const token of tokens) {
+        const byValue = LOG_TYPE_OPTIONS.find((o) => o.value === token);
+        const byLabel = LOG_TYPE_OPTIONS.find((o) => o.label === token);
+        const hit = byValue || byLabel;
+        if (!hit) {
+            throw new Error(`未知日志类型「${token}」，可用：${LOG_TYPE_OPTIONS.map((o) => `${o.label}(${o.value})`).join(' / ')}，清空用 none`);
+        }
+        out.push(hit.value);
+    }
+    return LOG_TYPE_OPTIONS.filter((o) => out.includes(o.value)).map((o) => o.value);
+}

package/dist/services/form-message.js

@@ -619,4 +619,3 @@ export async function setTriggerEnabled(client, baseUrl, appId, triggerId, objId
     if (res?.code !== 200)
         throw new Error(`${enabled ? '启用' : '停用'}提醒失败: ${res?.msg || '未知错误'}`);
 }
-//# sourceMappingURL=form-message.js.map

package/dist/services/form-nlist-field-attrs.js

@@ -167,4 +167,3 @@ export function normalizeNListFieldAttrs(raw) {
         attrs.style = style;
     return attrs;
 }
-//# sourceMappingURL=form-nlist-field-attrs.js.map

package/dist/services/form-nlist.js

@@ -605,4 +605,3 @@ export async function addNListDisplayFields(client, baseUrl, objId, appId, listI
 export async function removeNListDisplayFields(client, baseUrl, objId, appId, listId, fieldIds, options = {}) {
     return mutateNListFields(client, baseUrl, objId, appId, listId, fieldIds, 'remove', options);
 }
-//# sourceMappingURL=form-nlist.js.map

package/dist/services/form-obj-lang.js

@@ -0,0 +1,126 @@
+import { DEFAULT_EBUILDER_ROUTE } from './special-route.js';
+import { formNameLabelId, formNameText, getFormObj, saveFormObjName, } from './form-obj-meta.js';
+/** 前台多语言接口（目前只有 fs 这一套路由，普通表单也用这条）。 */
+export const FORM_ML_GETDATA_PATH = '/api/ebuilder/form/fs/multilangset/getdata';
+export const FORM_ML_SAVEDATA_PATH = '/api/ebuilder/form/fs/multilangset/savedata';
+/** 请求里写的 module；服务端读回时会归一成 `ebuilder_form`。 */
+export const FORM_ML_MODULE = 'ebuilder/form';
+export const FORM_ML_TABLEFIELD = '';
+function requireSuccess(response, operation) {
+    if (response?.code !== 200 || response?.status === false || response?.success === false || response?.fail === true) {
+        throw new Error(response?.msg || `${operation} 未确认成功`);
+    }
+    return response;
+}
+function rowValue(rows, langtype) {
+    return String(rows.find((row) => row.langtype === langtype)?.value ?? '');
+}
+/** 读各语言行。`targetId` 为空时平台返回空白模板行（value 为空、行 id 每次重生成）。 */
+export async function readFormNameLangRows(client, baseUrl, appId, targetId) {
+    const res = requireSuccess(await client.post(`${baseUrl}${FORM_ML_GETDATA_PATH}`, { module: FORM_ML_MODULE, tablefield: FORM_ML_TABLEFIELD, targetId: targetId || '', versionEnable: false }, { ebbusinessid: appId }), '读取表单名称多语言');
+    return (res.data?.usernamePerLangs || []);
+}
+/** 查看表单名称的多语言配置。未配置时 `configured=false`。 */
+export async function readFormNameLang(client, baseUrl, appId, objId, route = DEFAULT_EBUILDER_ROUTE) {
+    const obj = await getFormObj(client, baseUrl, appId, objId, route);
+    const labelId = formNameLabelId(obj.name);
+    const rows = labelId ? await readFormNameLangRows(client, baseUrl, appId, labelId) : [];
+    return {
+        objId,
+        appId,
+        configured: Boolean(labelId),
+        labelId,
+        zh: rowValue(rows, 'zh_CN') || formNameText(obj.name),
+        en: rowValue(rows, 'en_US'),
+        rows,
+    };
+}
+/**
+ * 设置表单名称的中英文。
+ *
+ * - 已有标签：savedata 原地更新；
+ * - 没有标签：getdata 取空白模板 → savedata 让平台分配 targetId；
+ * - 两种情况都用 name map 回写表单对象，保证默认名称与标签绑定同步。
+ */
+export async function setFormNameLang(client, baseUrl, appId, objId, patch, route = DEFAULT_EBUILDER_ROUTE) {
+    if (patch.zh === undefined && patch.en === undefined) {
+        throw new Error('至少要给 --zh 或 --en 之一');
+    }
+    const obj = await getFormObj(client, baseUrl, appId, objId, route);
+    const labelId = formNameLabelId(obj.name);
+    const rows = await readFormNameLangRows(client, baseUrl, appId, labelId);
+    const zhRow = rows.find((row) => row.langtype === 'zh_CN');
+    const enRow = rows.find((row) => row.langtype === 'en_US');
+    if (!zhRow)
+        throw new Error('当前环境未返回简体中文语言行，无法设置表单名称多语言');
+    const nextZh = String(patch.zh ?? (rowValue(rows, 'zh_CN') || formNameText(obj.name))).trim();
+    if (!nextZh)
+        throw new Error('表单名称（简体中文）不能为空');
+    const nextEn = patch.en !== undefined ? String(patch.en) : rowValue(rows, 'en_US');
+    const nextValues = { zh_CN: nextZh, en_US: nextEn };
+    const tableData = rows.map((row) => ({
+        id: row.id,
+        langid: row.langid,
+        langtype: row.langtype,
+        langName: row.langName,
+        value: nextValues[row.langtype] ?? String(row.value ?? ''),
+        content: row.langName,
+    }));
+    const enForCurrent = enRow ?? rows[0];
+    const saved = requireSuccess(await client.post(`${baseUrl}${FORM_ML_SAVEDATA_PATH}`, {
+        dialogVisible: true,
+        checkboxVisible: false,
+        checkboxOptionValue: rows.map((row) => row.langtype),
+        checkboxValue: rows.map((row) => row.langtype),
+        tableData,
+        valueChanged: false,
+        tabTextLastValue: '',
+        value: nextZh,
+        loading: true,
+        versionOptions: [],
+        versionValue: '1',
+        versionInfo: {},
+        windowIsEnableMultiLang: true,
+        usernamePerLangs: rows.map((row) => ({
+            langName: row.langName, langtype: row.langtype, id: row.id, langid: row.langid, value: '',
+        })),
+        targetId: labelId || '',
+        module: FORM_ML_MODULE,
+        tablefield: FORM_ML_TABLEFIELD,
+        tabMenuValue: zhRow.id,
+        currentData: {
+            id: enForCurrent?.id, langid: enForCurrent?.langid, langtype: enForCurrent?.langtype,
+            langName: enForCurrent?.langName, value: '', content: enForCurrent?.langName,
+        },
+        versionEnable: false,
+    }, { ebbusinessid: appId }), '保存表单名称多语言');
+    const savedLabelId = String(saved.data?.targetId || saved.data?.new_targetId || labelId || '');
+    if (!savedLabelId || savedLabelId === '-1') {
+        throw new Error('保存表单名称多语言后未返回 targetId');
+    }
+    // 把标签挂回表单对象（整对象回写），同时让 obj.name 与默认语言保持一致。
+    await saveFormObjName(client, baseUrl, appId, objId, { nameAlias: nextZh, nameAliasLabelId: savedLabelId }, route);
+    const afterRows = await readFormNameLangRows(client, baseUrl, appId, savedLabelId);
+    for (const [langtype, expected] of Object.entries(nextValues)) {
+        if (expected === undefined)
+            continue;
+        const actual = rowValue(afterRows, langtype);
+        if (actual !== expected) {
+            throw new Error(`表单名称多语言回读不一致（${langtype}）：期望「${expected}」，实际「${actual}」`);
+        }
+    }
+    const afterObj = await getFormObj(client, baseUrl, appId, objId, route);
+    if (formNameLabelId(afterObj.name) !== savedLabelId) {
+        throw new Error('表单对象回读的 nameAliasLabelId 与保存的标签 id 不一致');
+    }
+    return {
+        objId,
+        appId,
+        configured: true,
+        labelId: savedLabelId,
+        zh: rowValue(afterRows, 'zh_CN'),
+        en: rowValue(afterRows, 'en_US'),
+        rows: afterRows,
+        changed: true,
+    };
+}

package/dist/services/form-obj-meta.js

@@ -34,32 +34,61 @@ export async function getFormObj(client, baseUrl, appId, objId, route = DEFAULT_
     }
     return data;
 }
+/** 读接口里的 `name` 可能是纯文本，也可能是多语言对象 `{nameAlias, nameAliasLabelId}`。 */
+export function formNameText(name) {
+    if (name && typeof name === 'object' && !Array.isArray(name)) {
+        return String(name.nameAlias ?? '');
+    }
+    return String(name ?? '');
+}
+/** `name` 是多语言对象时返回它的标签 id；纯文本或没有标签时返回空串。 */
+export function formNameLabelId(name) {
+    if (!name || typeof name !== 'object' || Array.isArray(name))
+        return '';
+    const id = String(name.nameAliasLabelId ?? '');
+    return id && id !== '-1' ? id : '';
+}
+/** 读回的整体对象 → 可回写底稿（剔除标题字段与只读/派生字段）。 */
+export function buildFormObjPayload(before) {
+    const payload = {};
+    for (const [key, value] of Object.entries(before)) {
+        if (FORM_TITLE_FIELDS.includes(key))
+            continue;
+        if (NON_WRITABLE_FIELDS.includes(key))
+            continue;
+        payload[key] = value;
+    }
+    return payload;
+}
+/** `obj/saveOrUpdate` 是整对象覆盖：读回完整对象 → 换 `name` → 整体回写。 */
+export async function saveFormObjName(client, baseUrl, appId, objId, name, route = DEFAULT_EBUILDER_ROUTE) {
+    const payload = buildFormObjPayload(await getFormObj(client, baseUrl, appId, objId, route));
+    payload.name = name;
+    requireSuccess(await client.post(ebuilderFormUrl(baseUrl, route, 'obj', 'saveOrUpdate', objQuery(appId, objId)), payload, { ebbusinessid: appId }), '保存表单名称');
+}
 /**
  * 修改**表单名称**（`name`）。
  *
  * `obj/saveOrUpdate` 是整对象覆盖 —— 只发 `{id, name}` 会把其余字段清空，
  * 因此流程固定为：读回完整对象 → 剔除标题字段与只读字段 → 换 `name` → 整体回写 → 回读校验。
+ *
+ * 已配置多语言时，`name` 是对象：保留 `nameAliasLabelId`，只换 `nameAlias`（默认语言文本），
+ * 否则整对象回写会把多语言绑定丢掉。
  */
 export async function renameFormObj(client, baseUrl, appId, objId, newName, route = DEFAULT_EBUILDER_ROUTE) {
     const name = String(newName ?? '').trim();
     if (!name)
         throw new Error('新表单名称不能为空');
     const before = await getFormObj(client, baseUrl, appId, objId, route);
-    const oldName = String(before.name ?? '');
+    const oldName = formNameText(before.name);
     if (oldName === name)
         return { objId, appId, oldName, name, changed: false };
-    const payload = {};
-    for (const [key, value] of Object.entries(before)) {
-        if (FORM_TITLE_FIELDS.includes(key))
-            continue;
-        if (NON_WRITABLE_FIELDS.includes(key))
-            continue;
-        payload[key] = value;
-    }
-    payload.name = name;
-    requireSuccess(await client.post(ebuilderFormUrl(baseUrl, route, 'obj', 'saveOrUpdate', objQuery(appId, objId)), payload, { ebbusinessid: appId }), '修改表单名称');
+    const nameValue = before.name && typeof before.name === 'object' && !Array.isArray(before.name)
+        ? { ...before.name, nameAlias: name }
+        : name;
+    await saveFormObjName(client, baseUrl, appId, objId, nameValue, route);
     const after = await getFormObj(client, baseUrl, appId, objId, route);
-    const actual = String(after.name ?? '');
+    const actual = formNameText(after.name);
     if (actual !== name)
         throw new Error(`表单名称回读不一致：期望「${name}」，实际「${actual || '(空)'}」`);
     return { objId, appId, oldName, name, changed: true };
@@ -100,4 +129,43 @@ export async function setFormTitle(client, baseUrl, appId, objId, patch, route =
     }
     return { before, after, changed: JSON.stringify(before) !== JSON.stringify(after) };
 }
-//# sourceMappingURL=form-obj-meta.js.map
+/** 读取**表单说明**（`description`，表单基本信息里的说明文字）。 */
+export async function getFormDescription(client, baseUrl, appId, objId, route = DEFAULT_EBUILDER_ROUTE) {
+    const obj = await getFormObj(client, baseUrl, appId, objId, route);
+    return String(obj.description ?? '');
+}
+/**
+ * 修改**表单说明**（`description`）。空串表示清空。
+ *
+ * 与改名同一套整对象覆盖规则：读回完整对象 → 剔除标题字段与只读字段 → 换 `description` → 整体回写 → 回读校验。
+ */
+export async function setFormDescription(client, baseUrl, appId, objId, description, route = DEFAULT_EBUILDER_ROUTE) {
+    const next = String(description ?? '');
+    const before = await getFormObj(client, baseUrl, appId, objId, route);
+    const oldDescription = String(before.description ?? '');
+    if (oldDescription === next) {
+        return { objId, appId, oldDescription, description: next, changed: false };
+    }
+    const payload = buildFormObjPayload(before);
+    payload.description = next;
+    requireSuccess(await client.post(ebuilderFormUrl(baseUrl, route, 'obj', 'saveOrUpdate', objQuery(appId, objId)), payload, { ebbusinessid: appId }), '保存表单说明');
+    const after = await getFormObj(client, baseUrl, appId, objId, route);
+    const actual = String(after.description ?? '');
+    if (actual !== next) {
+        throw new Error(`表单说明回读不一致：期望「${next || '(空)'}」，实际「${actual || '(空)'}」`);
+    }
+    return { objId, appId, oldDescription, description: next, changed: true };
+}
+/**
+ * 整对象回写若干字段：读回 → 合并 → 回写 → 回读。
+ *
+ * `obj/saveOrUpdate` 是整对象覆盖，所以任何「只改一个字段」的命令都必须走这里，
+ * 不要手拼小报文。返回回读后的完整对象。
+ */
+export async function patchFormObj(client, baseUrl, appId, objId, patch, route = DEFAULT_EBUILDER_ROUTE) {
+    const before = await getFormObj(client, baseUrl, appId, objId, route);
+    const payload = buildFormObjPayload(before);
+    Object.assign(payload, patch);
+    requireSuccess(await client.post(ebuilderFormUrl(baseUrl, route, 'obj', 'saveOrUpdate', objQuery(appId, objId)), payload, { ebbusinessid: appId }), '保存表单对象');
+    return getFormObj(client, baseUrl, appId, objId, route);
+}

package/dist/services/form-permission-archive.js

@@ -443,4 +443,3 @@ export function archiveRowKey(row) {
 export function needsRebuild(row) {
     return Number(row?.isShowRebuild) === 2;
 }
-//# sourceMappingURL=form-permission-archive.js.map

package/dist/services/form-permission-edit.js

@@ -549,4 +549,3 @@ export function applyPermissionSettings(permission, settings) {
     }
     return [...new Set(changed)];
 }
-//# sourceMappingURL=form-permission-edit.js.map

package/dist/services/form-physical-table.js

@@ -189,4 +189,3 @@ export async function saveFormTable(client, baseUrl, appId, scope, table) {
 export async function deleteFormTables(client, baseUrl, appId, scope, formTableIds) {
     return client.post(`${baseUrl}${FIELD_MANAGE}/deleteFormTable?apid=${encodeURIComponent(appId)}`, buildDeleteFormTablePayload(scope, formTableIds), { ebbusinessid: scope.formId });
 }
-//# sourceMappingURL=form-physical-table.js.map

package/dist/services/form-style-template.js

@@ -108,4 +108,3 @@ export async function resolveStyleTemplateId(client, baseUrl, formId, layoutType
         + (fuzzy.length ? `\n  相近的: ${fuzzy.map((t) => `${t.name}(${t.id})`).join(' / ')}` : '')
         + listAvailable(all));
 }
-//# sourceMappingURL=form-style-template.js.map

package/dist/services/form-sub-detail.js

@@ -383,4 +383,3 @@ export class FormSubDetailService {
         return { ...readback, response: res };
     }
 }
-//# sourceMappingURL=form-sub-detail.js.map

package/dist/services/form-table-view.js

@@ -884,4 +884,3 @@ export async function configureFormTableViewSearchField(client, baseUrl, appId,
     }
     return actual;
 }
-//# sourceMappingURL=form-table-view.js.map

package/dist/services/form-view-linkage-functions.js

@@ -87,4 +87,3 @@ export function assertViewLinkageFormulaFunctions(expression, categories) {
     if (invalid.length)
         throw new Error(`显示属性联动函数条件不可使用：${invalid.join('、')}。请先运行 e10-cli form formula functions --scene form-view-linkage 查询当前环境可选函数`);
 }
-//# sourceMappingURL=form-view-linkage-functions.js.map

package/dist/services/form-view-permission.js

@@ -205,4 +205,3 @@ export async function setFormViewPermission(client, baseUrl, appId, objId, right
         persisted: true,
     };
 }
-//# sourceMappingURL=form-view-permission.js.map

package/dist/services/form-view-populate.js

@@ -175,4 +175,3 @@ export function diffExistingComps(before, after) {
     }
     return { missingIds, movedIds };
 }
-//# sourceMappingURL=form-view-populate.js.map

package/dist/services/form-view.js

@@ -459,4 +459,3 @@ export async function populateFormViewFields(client, baseUrl, appId, objId, targ
         warnings: cellWarnings,
     };
 }
-//# sourceMappingURL=form-view.js.map

package/dist/services/form-virtual.js

@@ -333,4 +333,3 @@ export class VirtualFormService {
         return { objId, formId, added: fields.map(field => ({ fieldId: field.fieldId, name: field.title, dataKey: field.dataKey })) };
     }
 }
-//# sourceMappingURL=form-virtual.js.map

package/dist/services/formula-detail.js

@@ -311,4 +311,3 @@ export async function buildFormulaParameters(client, baseUrl, objId, appId, form
         mainFields, detailTables, moduleColumns, formId, module: 'ebuilderform', appId,
     });
 }
-//# sourceMappingURL=formula-detail.js.map

package/dist/services/icon-path.js

@@ -77,4 +77,3 @@ export function buildDigitalPanelIcon(spec) {
         iconDisplayType: spec.display === 'fill' ? 'fill' : 'line',
     };
 }
-//# sourceMappingURL=icon-path.js.map

package/dist/services/matrix-condition.js

@@ -564,4 +564,3 @@ export function summarizeMatrixCondition(raw) {
     });
     return parts.join(String(tree.relationship) === '0' ? ' 或 ' : ' 且 ');
 }
-//# sourceMappingURL=matrix-condition.js.map

package/dist/services/matrix-fields.js

@@ -99,4 +99,3 @@ export function pickCustomBrowser(payload, name) {
 export function customBrowserCandidates(payload, limit = 8) {
     return customBrowserRows(payload).slice(0, limit).map((b) => `${b?.name}(${b?.id})`);
 }
-//# sourceMappingURL=matrix-fields.js.map

package/dist/services/matrix-maintainer.js

@@ -139,4 +139,3 @@ export function verifyMaintainerDetail(payload, detail) {
     }
     return issues;
 }
-//# sourceMappingURL=matrix-maintainer.js.map