weaver-e10-builder 1.7.0 → 1.7.2

package/dist/services/esb-interface/connector-lock.js

@@ -0,0 +1,79 @@
+/**
+ * 连接器（连接系统 systemPool）封存 / 解封。
+ *
+ * 对齐后端 EsbSytemPoolController（weaver-esb-setting）：
+ * - POST /api/bs/esb/setting/systemPool/lockByIds    批量封存（status → LOCKED=1）
+ * - POST /api/bs/esb/setting/systemPool/unlockByIds  批量解封（status → AVAILABLE=0）
+ *   请求体 EsbBatchIDsVO：{ ids: "id1,id2" } —— 逗号分隔字符串，不是数组。
+ *   后端对每个 id 校验存在性与编辑权限；若封存的是主系统，会级联设置其全部子系统。
+ * - GET  /api/bs/esb/setting/systemPool/getPage  分页列表（current/pageSize/name/showDefalt），
+ *   返回 WeaTable：{ displayData, current, total, pageSize, ... }
+ */
+const SYSTEM_POOL_BASE = '/api/bs/esb/setting/systemPool';
+/** 封存 / 解封 / 列表三个路径共用同一常量，禁止各写一份 */
+export const SYSTEM_POOL_PAGE_PATH = `${SYSTEM_POOL_BASE}/getPage`;
+export const SYSTEM_POOL_LOCK_PATH = `${SYSTEM_POOL_BASE}/lockByIds`;
+export const SYSTEM_POOL_UNLOCK_PATH = `${SYSTEM_POOL_BASE}/unlockByIds`;
+/** 连接系统状态（EsbStatusEnum）：0 正常 / 1 封存 / 2 禁用 */
+export const SYSTEM_POOL_STATUS = { AVAILABLE: 0, LOCKED: 1, FORBIDDEN: 2 };
+/** 归一化 id 入参：去掉空白项与重复项，保留出现顺序 */
+export function normalizeIds(input) {
+    const seen = new Set();
+    const result = [];
+    for (const raw of input) {
+        const id = String(raw ?? '').trim();
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        result.push(id);
+    }
+    return result;
+}
+/** 逗号拼接为后端 EsbBatchIDsVO.ids 的字符串格式 */
+export function joinIds(ids) {
+    return ids.join(',');
+}
+/** 分页查询连接器（连接系统）列表，返回后端 WeaTable 原始结构 */
+export async function listConnectors(client, query = {}) {
+    const params = new URLSearchParams();
+    params.set('current', String(query.current ?? 1));
+    params.set('pageSize', String(query.pageSize ?? 10));
+    if (query.name)
+        params.set('name', query.name);
+    params.set('showDefalt', String(query.showDefalt ?? true));
+    return client.get(`${client.getBaseUrl()}${SYSTEM_POOL_PAGE_PATH}?${params.toString()}`);
+}
+/**
+ * 批量封存连接器（级联子系统由后端处理）。
+ * 空列表直接抛错——发一个 `ids: ""` 的请求等于什么都没封，还制造一条成功假象。
+ */
+export async function lockConnectors(client, ids) {
+    return toggleLock(client, ids, true);
+}
+/** 批量解封连接器 */
+export async function unlockConnectors(client, ids) {
+    return toggleLock(client, ids, false);
+}
+async function toggleLock(client, ids, lock) {
+    const normalized = normalizeIds(ids);
+    if (normalized.length === 0) {
+        throw new Error(`ids 必填且不能为空：${lock ? '封存' : '解封'}至少需要一个连接器 id`);
+    }
+    return client.post(`${client.getBaseUrl()}${lock ? SYSTEM_POOL_LOCK_PATH : SYSTEM_POOL_UNLOCK_PATH}`, { ids: joinIds(normalized) });
+}
+/**
+ * 按名称解析连接器 id：先按 name 精确匹配，唯一命中直接返回；
+ * 多个或零个命中时改用「id 直接就是数字」的兜底（调用方通常也允许直接传 id）。
+ * 返回 { matched: 命中的 displayData 项 }，调用方据此决定是否继续。
+ */
+export async function findConnectorsByName(client, name) {
+    const keyword = name.trim();
+    if (!keyword)
+        return [];
+    const res = await listConnectors(client, { name: keyword, current: 1, pageSize: 50 });
+    const table = res?.data ?? res ?? {};
+    const rows = Array.isArray(table.displayData) ? table.displayData : [];
+    const exact = rows.filter((row) => String(row?.name ?? '').trim() === keyword);
+    return exact.length > 0 ? exact : rows;
+}
+//# sourceMappingURL=connector-lock.js.map

package/dist/services/esb-interface/connector-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-lock.js","sourceRoot":"","sources":["../../../src/services/esb-interface/connector-lock.ts"],"names":[],"mappings":"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"}

package/dist/services/esb-interface/connector-update.d.ts

@@ -0,0 +1,34 @@
+import type { ApiClient } from '../../core/client.js';
+/** 编辑 / 列表路径共用同一常量，禁止各写一份 */
+export declare const SYSTEM_POOL_UPDATE_PATH = "/api/bs/esb/setting/systemPool/updateById";
+export type ConnectorUpdateClient = Pick<ApiClient, 'post' | 'getBaseUrl'>;
+/** 允许通过编辑接口提交的字段（白名单），与前端编辑表单对齐 */
+export declare const CONNECTOR_EDITABLE_FIELDS: readonly ["name", "company", "website", "product", "productWebsite", "edition", "description", "icon", "connectorType"];
+export type ConnectorEditableField = (typeof CONNECTOR_EDITABLE_FIELDS)[number];
+export interface ConnectorUpdateInput {
+    /** 连接器 id，必填 */
+    id: string | number;
+    name?: string;
+    company?: string;
+    website?: string;
+    product?: string;
+    productWebsite?: string;
+    edition?: string;
+    description?: string;
+    icon?: string;
+    connectorType?: string;
+}
+/**
+ * 组装 updateById 请求体的纯函数（可单测）：
+ * - id 必填且不能为空白
+ * - 至少带一个可编辑字段（否则等于空更新，制造成功假象）
+ * - name 若提供则不能为空白（前端表单必填，后端多语言同步也依赖它）
+ * - 丢弃白名单之外的字段，避免把临时/展示字段发上去
+ */
+export declare function buildUpdatePayload(input: ConnectorUpdateInput): {
+    id: string;
+    [key: string]: unknown;
+};
+/** 编辑连接器信息（对应后端 updateById，单条操作） */
+export declare function updateConnector(client: ConnectorUpdateClient, input: ConnectorUpdateInput): Promise<any>;
+//# sourceMappingURL=connector-update.d.ts.map

package/dist/services/esb-interface/connector-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-update.d.ts","sourceRoot":"","sources":["../../../src/services/esb-interface/connector-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AActD,6BAA6B;AAC7B,eAAO,MAAM,uBAAuB,8CAAmC,CAAC;AAExE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;AAE3E,mCAAmC;AACnC,eAAO,MAAM,yBAAyB,yHAU5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,GAC1B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAmBxC;AAED,oCAAoC;AACpC,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,GAAG,CAAC,CAMd"}

package/dist/services/esb-interface/connector-update.js

@@ -0,0 +1,58 @@
+/**
+ * 连接器（连接系统 systemPool）信息编辑。
+ *
+ * 对齐后端 EsbSytemPoolController（weaver-esb-setting）：
+ * - POST /api/bs/esb/setting/systemPool/updateById
+ *   请求体为 EsbSystemPoolEntity JSON（id 必填，**不是** EsbBatchIDsVO）。
+ *   后端逐条校验存在性与编辑权限；name/company/product/description 会同步多语言默认值；
+ *   categoryBrowser[0] 会覆盖 category（为空时后端默认 99999）；parentId 沿用原值，改不了。
+ */
+const SYSTEM_POOL_BASE = '/api/bs/esb/setting/systemPool';
+/** 编辑 / 列表路径共用同一常量，禁止各写一份 */
+export const SYSTEM_POOL_UPDATE_PATH = `${SYSTEM_POOL_BASE}/updateById`;
+/** 允许通过编辑接口提交的字段（白名单），与前端编辑表单对齐 */
+export const CONNECTOR_EDITABLE_FIELDS = [
+    'name',
+    'company',
+    'website',
+    'product',
+    'productWebsite',
+    'edition',
+    'description',
+    'icon',
+    'connectorType',
+];
+/**
+ * 组装 updateById 请求体的纯函数（可单测）：
+ * - id 必填且不能为空白
+ * - 至少带一个可编辑字段（否则等于空更新，制造成功假象）
+ * - name 若提供则不能为空白（前端表单必填，后端多语言同步也依赖它）
+ * - 丢弃白名单之外的字段，避免把临时/展示字段发上去
+ */
+export function buildUpdatePayload(input) {
+    const id = String(input?.id ?? '').trim();
+    if (!id)
+        throw new Error('id 必填且不能为空');
+    const payload = { id };
+    let fieldCount = 0;
+    for (const field of CONNECTOR_EDITABLE_FIELDS) {
+        const value = input[field];
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === 'string' && !value.trim()) {
+            throw new Error(`字段 ${field} 不能为空白字符串（不修改就不要传）`);
+        }
+        payload[field] = value;
+        fieldCount++;
+    }
+    if (fieldCount === 0) {
+        throw new Error(`至少需要提供一个要修改的字段（${CONNECTOR_EDITABLE_FIELDS.join('/')}）`);
+    }
+    return payload;
+}
+/** 编辑连接器信息（对应后端 updateById，单条操作） */
+export async function updateConnector(client, input) {
+    const payload = buildUpdatePayload(input);
+    return client.post(`${client.getBaseUrl()}${SYSTEM_POOL_UPDATE_PATH}`, payload);
+}
+//# sourceMappingURL=connector-update.js.map

package/dist/services/esb-interface/connector-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-update.js","sourceRoot":"","sources":["../../../src/services/esb-interface/connector-update.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AAE1D,6BAA6B;AAC7B,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,gBAAgB,aAAa,CAAC;AAIxE,mCAAmC;AACnC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,SAAS;IACT,aAAa;IACb,MAAM;IACN,eAAe;CACP,CAAC;AAkBX;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA2B;IAE3B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAEvC,MAAM,OAAO,GAA4B,EAAE,EAAE,EAAE,CAAC;IAChD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,yBAAyB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAI,KAA4C,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,oBAAoB,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACvB,UAAU,EAAE,CAAC;IACf,CAAC;IACD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kBAAkB,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAiD,CAAC;AAC3D,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA6B,EAC7B,KAA2B;IAE3B,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAChB,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,uBAAuB,EAAE,EAClD,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/services/form-association.d.ts

@@ -1,5 +1,5 @@
 import type { ApiClient } from '../core/client.js';
-type Client = Pick<ApiClient, 'get' | 'post'>;
+type Client = Pick<ApiClient, 'get' | 'post'> & Partial<Pick<ApiClient, 'postForm'>>;
 export declare const ASSOCIATION_BASE = "/api/bs/ebuilder/form/association";
 export interface AssociationMapping {
     targetField: string;
@@ -15,7 +15,17 @@ export interface AssociationOptions {
     mappings?: AssociationMapping[];
     permissions?: any[];
     action?: string;
+    order?: number;
+    selected?: boolean;
+    group?: string | null;
 }
+/** 分组名称支持多语言对象；命令行统一取可读文本。 */
+export declare function groupNameText(value: unknown): string;
+/** 校验 0~100 的安全级别范围。 */
+export declare function parseSeclevel(range: string): {
+    minShowlevel: string;
+    maxShowlevel: string;
+};
 export declare function associationLayouts(values: string[]): string;
 export declare function associationTerminals(values: string[]): string[];
 /** 详情返回明文条件，所有写操作均需压缩；不能因只改布局而损坏原权限条件。 */
@@ -80,6 +90,23 @@ export declare class AssociationService {
         target: any[];
     }>;
     private mapped;
+    listGroups(): Promise<any[]>;
+    private findGroupIndex;
+    resolveGroup(selector: string): Promise<any | null>;
+    private saveGroups;
+    addGroup(name: string, order?: number): Promise<any>;
+    updateGroup(selector: string, patch: {
+        name?: string;
+        order?: number;
+    }): Promise<any>;
+    deleteGroup(selector: string): Promise<any>;
+    /** 按给定 ID 顺序重排全部页签（updateOrderV2 会把顺序写成 1..N）。 */
+    reorder(ids: string[]): Promise<any>;
+    /** 修改单条权限的安全级别（读整行 → 改 levelScope → saveOrUpdate → 回读）。 */
+    setSecurityLevel(id: string, permSelector: string, scope: {
+        minShowlevel: string;
+        maxShowlevel: string;
+    }): Promise<any>;
     create(options: AssociationOptions): Promise<any>;
     update(id: string, options: AssociationOptions): Promise<any>;
 }

package/dist/services/form-association.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-association.d.ts","sourceRoot":"","sources":["../../src/services/form-association.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-association.d.ts","sourceRoot":"","sources":["../../src/services/form-association.ts"],"names":[],"mappings":"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"}

package/dist/services/form-association.js

@@ -1,6 +1,39 @@
 import { randomInt } from 'node:crypto';
 import { lzwCompress } from '../core/lzw.js';
 export const ASSOCIATION_BASE = '/api/bs/ebuilder/form/association';
+/** 分组名称支持多语言对象；命令行统一取可读文本。 */
+export function groupNameText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object') {
+        const record = value;
+        for (const key of ['name', 'zh', 'cn', 'default', 'nameAlias']) {
+            if (typeof record[key] === 'string' && record[key])
+                return String(record[key]);
+        }
+        return JSON.stringify(value);
+    }
+    return value === undefined || value === null ? '' : String(value);
+}
+/** 校验 0~100 的安全级别范围。 */
+export function parseSeclevel(range) {
+    const match = /^(\d{1,3})\s*-\s*(\d{1,3})$/.exec(String(range).trim());
+    if (!match)
+        throw new Error('--seclevel 格式应为 min-max，如 30-100');
+    const min = Number(match[1]);
+    const max = Number(match[2]);
+    if (min > max)
+        throw new Error('--seclevel 最小值不能大于最大值');
+    if (min < 0 || max > 100)
+        throw new Error('--seclevel 范围须在 0~100');
+    return { minShowlevel: String(min), maxShowlevel: String(max) };
+}
+function groupIdOf(group) {
+    if (group === undefined || group === null)
+        return '';
+    const id = typeof group === 'object' ? group.id : group;
+    return id === undefined || id === null || String(id) === '0' ? '' : String(id);
+}
 function data(response, operation) {
     if (response?.code !== 200 || response?.status === false || response?.fail === true || response?.data == null)
         throw new Error(`${operation}失败: ${response?.msg || '返回数据无效'}`);
@@ -312,6 +345,168 @@ export class AssociationService {
         const fields = await this.fields(view);
         return buildAssociationMappings(mappings, fields.source, fields.target);
     }
+    // ── 分组 ──────────────────────────────────────────────
+    async listGroups() {
+        const result = data(await this.client.get(`${this.base}${ASSOCIATION_BASE}/getAssociationGroupList/${this.objId}?apid=${this.appId}`, this.headers()), '读取关联分组');
+        if (!Array.isArray(result))
+            throw new Error('关联分组接口返回结构无效');
+        return result;
+    }
+    findGroupIndex(groups, selector) {
+        const key = String(selector ?? '').trim();
+        if (!key)
+            throw new Error('请指定分组 ID 或名称');
+        const byId = groups.findIndex(g => String(g.id) === key);
+        if (byId >= 0)
+            return byId;
+        const byName = groups.filter(g => groupNameText(g.groupName) === key);
+        if (byName.length === 1)
+            return groups.findIndex(g => groupNameText(g.groupName) === key);
+        if (byName.length > 1)
+            throw new Error(`分组名称「${key}」有 ${byName.length} 条，请改用分组 ID`);
+        const existing = groups.map(g => `${groupNameText(g.groupName) || '(未命名)'}(${g.id})`).join('、');
+        throw new Error(`没有 ID 或名称匹配「${key}」的关联分组${existing ? `。现有：${existing}` : ''}`);
+    }
+    async resolveGroup(selector) {
+        if (selector === null || ['none', '无', '0', ''].includes(String(selector).trim()))
+            return null;
+        const groups = await this.listGroups();
+        return groups[this.findGroupIndex(groups, selector)];
+    }
+    async saveGroups(groups) {
+        const payload = groups.map(g => ({
+            id: g.id === undefined || g.id === null ? '' : String(g.id),
+            groupName: g.groupName,
+        }));
+        if (!this.client.postForm)
+            throw new Error('当前客户端不支持表单提交，无法保存关联分组');
+        const query = new URLSearchParams({ apid: this.appId, tpaid: this.objId }).toString();
+        const form = new URLSearchParams({ objId: this.objId, groups: JSON.stringify(payload) }).toString();
+        const response = await this.client.postForm(`${this.base}${ASSOCIATION_BASE}/save?${query}`, form, this.headers());
+        if (response?.code !== 200 || response?.status === false || response?.fail === true) {
+            throw new Error(`保存关联分组失败: ${response?.msg || '返回数据无效'}`);
+        }
+        return this.listGroups();
+    }
+    async addGroup(name, order) {
+        const groupName = String(name ?? '').trim();
+        if (!groupName)
+            throw new Error('分组名称不能为空');
+        const groups = await this.listGroups();
+        if (groups.some(g => groupNameText(g.groupName) === groupName))
+            throw new Error(`分组「${groupName}」已存在`);
+        const index = order === undefined ? groups.length : order - 1;
+        if (!Number.isInteger(index) || index < 0 || index > groups.length) {
+            throw new Error(`--order 需在 1~${groups.length + 1}（当前分组数 ${groups.length}）`);
+        }
+        const next = [...groups];
+        next.splice(index, 0, { id: '', groupName });
+        const after = await this.saveGroups(next);
+        const created = after.filter(g => groupNameText(g.groupName) === groupName);
+        if (created.length !== 1)
+            throw new Error('分组保存后回读不到唯一的新分组');
+        return { success: true, verified: true, group: created[0], groups: after };
+    }
+    async updateGroup(selector, patch) {
+        if (patch.name === undefined && patch.order === undefined)
+            throw new Error('请至少指定 --name 或 --order');
+        const groups = await this.listGroups();
+        const index = this.findGroupIndex(groups, selector);
+        const current = groups[index];
+        const group = { ...current };
+        if (patch.name !== undefined) {
+            const name = String(patch.name).trim();
+            if (!name)
+                throw new Error('分组名称不能为空');
+            if (groups.some((g, i) => i !== index && groupNameText(g.groupName) === name)) {
+                throw new Error(`分组「${name}」已存在`);
+            }
+            group.groupName = name;
+        }
+        let next = groups.map((g, i) => (i === index ? group : g));
+        if (patch.order !== undefined) {
+            if (!Number.isInteger(patch.order) || patch.order < 1 || patch.order > groups.length) {
+                throw new Error(`--order 需在 1~${groups.length}`);
+            }
+            next = next.filter((_, i) => i !== index);
+            next.splice(patch.order - 1, 0, group);
+        }
+        const after = await this.saveGroups(next);
+        const saved = after.find(g => String(g.id) === String(current.id));
+        if (!saved)
+            throw new Error('分组保存后回读不到目标分组');
+        if (patch.name !== undefined && groupNameText(saved.groupName) !== String(patch.name).trim()) {
+            throw new Error('分组名称回读不一致');
+        }
+        return { success: true, verified: true, group: saved, groups: after };
+    }
+    async deleteGroup(selector) {
+        const groups = await this.listGroups();
+        const index = this.findGroupIndex(groups, selector);
+        const target = groups[index];
+        const after = await this.saveGroups(groups.filter((_, i) => i !== index));
+        if (after.some(g => String(g.id) === String(target.id)))
+            throw new Error(`分组 ${target.id} 仍在列表里，删除未生效`);
+        return { success: true, verified: true, groupId: String(target.id), groupName: groupNameText(target.groupName), groups: after };
+    }
+    /** 按给定 ID 顺序重排全部页签（updateOrderV2 会把顺序写成 1..N）。 */
+    async reorder(ids) {
+        const unique = ids.map(String).filter(Boolean);
+        if (!unique.length)
+            throw new Error('至少指定一个关联页签 ID');
+        if (new Set(unique).size !== unique.length)
+            throw new Error('关联页签 ID 不能重复');
+        const before = await this.list();
+        const known = new Set(before.map(a => String(a.id)));
+        const missing = unique.filter(id => !known.has(id));
+        if (missing.length)
+            throw new Error(`以下关联页签不属于本表单: ${missing.join(', ')}`);
+        const uncovered = before.map(a => String(a.id)).filter(id => !unique.includes(id));
+        if (uncovered.length)
+            throw new Error(`排序必须给出全部页签 ID，缺少: ${uncovered.join(', ')}`);
+        const response = await this.client.post(`${this.base}${ASSOCIATION_BASE}/updateOrderV2?apid=${this.appId}`, { orderIds: unique }, this.headers());
+        if (response?.code !== 200 || response?.status === false || response?.fail === true) {
+            throw new Error(`保存关联排序失败: ${response?.msg || '返回数据无效'}`);
+        }
+        const after = await this.list();
+        const sorted = [...after].sort((a, b) => Number(a.order) - Number(b.order));
+        const got = sorted.map(a => String(a.id));
+        if (got.join(',') !== unique.join(',')) {
+            throw new Error(`排序已提交，但回读顺序不一致 —— 期望 ${unique.join(',')}，回读 ${got.join(',')}`);
+        }
+        return { success: true, verified: true, orderIds: unique };
+    }
+    /** 修改单条权限的安全级别（读整行 → 改 levelScope → saveOrUpdate → 回读）。 */
+    async setSecurityLevel(id, permSelector, scope) {
+        const draft = structuredClone(await this.get(id));
+        const perms = draft.associationPermissions || [];
+        if (!perms.length)
+            throw new Error('该关联无权限条目');
+        let index;
+        if (/^\d+$/.test(permSelector)) {
+            index = Number(permSelector) - 1;
+            if (index < 0 || index >= perms.length)
+                throw new Error(`--perm 序号 ${permSelector} 越界（共 ${perms.length} 条权限）`);
+        }
+        else {
+            index = perms.findIndex(p => p.selectedType === permSelector);
+            if (index < 0)
+                throw new Error(`未找到 selectedType="${permSelector}" 的权限`);
+        }
+        draft.associationPermissions = perms.map((p, i) => i === index
+            ? { ...p, levelScope: { ...(p.levelScope || {}), ...scope } }
+            : p);
+        data(await this.client.post(`${this.base}${ASSOCIATION_BASE}/saveOrUpdate?${this.query()}`, serializeAssociation(draft), this.headers()), '更新权限安全级别');
+        const after = await this.get(id);
+        const saved = after.associationPermissions?.[index];
+        if (!saved)
+            throw new Error('已提交，但回读不到目标权限');
+        if (String(saved.levelScope?.minShowlevel ?? '') !== scope.minShowlevel
+            || String(saved.levelScope?.maxShowlevel ?? '') !== scope.maxShowlevel) {
+            throw new Error('权限安全级别回读不一致');
+        }
+        return { success: true, verified: true, permIndex: index + 1, selectedType: saved.selectedType, levelScope: saved.levelScope };
+    }
     async create(options) {
         if (!options.name?.trim() || !options.view)
             throw new Error('创建需指定页签名称和目标视图');
@@ -320,15 +515,22 @@ export class AssociationService {
         const before = await this.list();
         if (before.some(a => a.pageName === options.name))
             throw new Error('同名页签已存在，请按 ID 修改，避免重复创建');
+        if (options.order !== undefined && (!Number.isInteger(options.order) || options.order < 1)) {
+            throw new Error('--order 需为 1 或正整数');
+        }
+        const group = options.group !== undefined ? await this.resolveGroup(options.group ?? 'none') : undefined;
         const view = await this.resolveView(options.view, options.targetApp);
         const link = { openMode: '1', name: view.name, autoFillParams: true,
             icon: { path: '#icon-eBuilder-o', style: { color: '#5d9cec', fillType: 'borderColor', borderColor: '#5d9cec' } },
             page: { pageId: view.id, parentId: `Form_${view.objId}`, openMode: '1', pageName: view.name, pageType: 'VIEWPORT', appid: view.appId, pageViewType: view.viewType, dsDataset: {} },
             params: await this.mapped(options.mappings || [], view) };
         const draft = {
-            objId: this.objId, pageName: options.name, open: options.enabled ?? true, selected: false, confirm: 0,
+            objId: this.objId, pageName: options.name, open: options.enabled ?? true,
+            selected: options.selected ?? false, confirm: options.selected ? 1 : 0,
             showLayout: associationLayouts(options.layouts || ['显示']), applicable: associationTerminals(options.terminals || ['PC', 'MOBILE']),
             associationPermissions: options.permissions, customTips: { tipsSql: '', tipsCustomApi: '' },
+            ...(options.order !== undefined ? { order: options.order } : {}),
+            ...(options.group !== undefined ? { group: group ? { id: String(group.id) } : null } : {}),
             associationActions: [{ name: view.name, conditionTxt: '', id: `-${Date.now()}${randomInt(1000)}`, enable: 1,
                     actionType: 'openpage', buttonId: '', windowSize: 30, executeSelectedDatas: 0, url: JSON.stringify(link), openType: '1', index: 0,
                     interfacePath: '', desc: '', urlType: '0', urlFieldId: '', interfaceType: '', confirmTitle: '', ecode: '', littlecardName: '自定义小卡片', littlecardJson: '',
@@ -366,6 +568,26 @@ export class AssociationService {
             draft.showLayout = associationLayouts(options.layouts);
         if (options.terminals)
             draft.applicable = associationTerminals(options.terminals);
+        if (options.order !== undefined) {
+            if (!Number.isInteger(options.order) || options.order < 1)
+                throw new Error('--order 需为 1 或正整数');
+            draft.order = options.order;
+        }
+        if (options.selected !== undefined) {
+            draft.selected = options.selected;
+            // confirm=1 时平台会先把本表单其它页签全部置为未选中，再保存本页签。
+            draft.confirm = options.selected ? 1 : 0;
+        }
+        if (options.permissions !== undefined) {
+            if (!Array.isArray(options.permissions) || !options.permissions.length) {
+                throw new Error('--permissions 需为非空数组（整组替换；清空权限请勿用此参数）');
+            }
+            draft.associationPermissions = options.permissions;
+        }
+        if (options.group !== undefined) {
+            const group = await this.resolveGroup(options.group ?? 'none');
+            draft.group = group ? { id: String(group.id) } : null;
+        }
         const enabled = options.enabled;
         if (options.targetApp && !options.view)
             throw new Error('--target-app 必须同时指定 --view');
@@ -401,8 +623,13 @@ export function verifyAssociation(expected, actual) {
     const canonical = (value) => JSON.stringify(value, (_key, v) => v && typeof v === 'object' && !Array.isArray(v) ? Object.fromEntries(Object.keys(v).sort().map(k => [k, v[k]])) : v);
     const equal = (a, b, label) => { if (canonical(a) !== canonical(b))
         throw new Error(`已保存，但 ${label} 回读不一致`); };
-    for (const key of ['objId', 'pageName', 'open', 'selected', 'confirm'])
+    // confirm 只是本次请求的“重置其它页签选中状态”信号，平台不持久化；不要拿它做回读断言。
+    for (const key of ['objId', 'pageName', 'open', 'selected'])
         equal(expected[key], actual[key], key);
+    if (expected.order !== undefined)
+        equal(Number(expected.order), Number(actual.order), 'order');
+    if (expected.group !== undefined)
+        equal(groupIdOf(expected.group), groupIdOf(actual.group), '分组');
     equal(String(expected.showLayout || '').split(',').sort(), String(actual.showLayout || '').split(',').sort(), '布局');
     equal([...(expected.applicable || [])].sort(), [...(actual.applicable || [])].sort(), '适用终端');
     equal(expected.associationActions.length, actual.associationActions?.length, '动作数量');
@@ -420,6 +647,9 @@ export function verifyAssociation(expected, actual) {
         const after = actual.associationPermissions[i];
         for (const key of ['selectedType', 'dataid'])
             equal(permission[key], after[key], `权限 ${key}`);
+        if (permission.levelScope !== undefined) {
+            equal([String(permission.levelScope?.minShowlevel ?? ''), String(permission.levelScope?.maxShowlevel ?? '')], [String(after.levelScope?.minShowlevel ?? ''), String(after.levelScope?.maxShowlevel ?? '')], '权限安全级别');
+        }
         const root = (p) => p.condition?.rootdata ? JSON.parse(p.condition.rootdata) : null;
         equal(root(permission), root(after), '原权限条件');
     });