@befly-addon/admin 1.4.1 → 1.5.0

package/adminViews/config/dict/index.vue

@@ -83,7 +83,7 @@ import ILucideChevronDown from "~icons/lucide/chevron-down";
 import EditDialog from "./components/edit.vue";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/config/dictType/index.vue

@@ -80,7 +80,7 @@ import ILucideChevronDown from "~icons/lucide/chevron-down";
 import EditDialog from "./components/edit.vue";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/config/system/index.vue

@@ -91,7 +91,7 @@ import ILucideChevronDown from "~icons/lucide/chevron-down";
 import EditDialog from "./components/edit.vue";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/log/email/index.vue

@@ -90,7 +90,7 @@ import ILucideSend from "~icons/lucide/send";
 import ILucideCheckCircle from "~icons/lucide/check-circle";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/log/login/index.vue

@@ -54,7 +54,7 @@ import { Button as TButton, Table as TTable, Tag as TTag, Pagination as TPaginat
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/log/operate/index.vue

@@ -74,7 +74,7 @@ import { Button as TButton, Table as TTable, Tag as TTag, Pagination as TPaginat
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/login_1/index.vue

@@ -70,7 +70,7 @@ import ILucideUser from "~icons/lucide/user";
 import ILucideLock from "~icons/lucide/lock";
 import { $Http } from "@/plugins/http";
 import { $Storage } from "@/plugins/storage";
-import { hashPassword } from "../../utils/hashPassword";
+import { hashPassword } from "../../../utils/hashPassword";
 
 definePage({
     meta: {

package/adminViews/people/admin/components/edit.vue

@@ -47,8 +47,8 @@ import {
     MessagePlugin
 } from "tdesign-vue-next";
 import { $Http } from "@/plugins/http";
-import { fieldClear } from "@/../utils/fieldClear";
-import { hashPassword } from "@/../utils/hashPassword";
+import { fieldClear } from "../../../../utils/fieldClear";
+import { hashPassword } from "../../../../utils/hashPassword";
 
 const $Prop = defineProps({
     modelValue: {

package/adminViews/people/admin/index.vue

@@ -79,7 +79,7 @@ import ILucideChevronDown from "~icons/lucide/chevron-down";
 import EditDialog from "./components/edit.vue";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/permission/api/index.vue

@@ -54,9 +54,9 @@
 import { Button as TButton, Table as TTable, Tag as TTag, Input as TInput, MessagePlugin } from "tdesign-vue-next";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import ILucideSearch from "~icons/lucide/search";
-import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
 import DetailPanel from "@/components/DetailPanel.vue";
+import { $Http } from "@/plugins/http";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/permission/menu/index.vue

@@ -44,8 +44,8 @@ import { Button as TButton, Table as TTable, Tag as TTag, MessagePlugin } from "
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { arrayToTree } from "@/utils/arrayToTree";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { arrayToTree } from "../../../utils/arrayToTree";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/adminViews/permission/role/components/edit.vue

@@ -43,7 +43,7 @@ import {
     MessagePlugin
 } from "tdesign-vue-next";
 import { $Http } from "@/plugins/http";
-import { fieldClear } from "@/../utils/fieldClear";
+import { fieldClear } from "../../../../utils/fieldClear";
 
 const $Prop = defineProps({
     modelValue: {

package/adminViews/permission/role/components/menu.vue

@@ -44,7 +44,7 @@
 import { Dialog as TDialog, CheckboxGroup as TCheckboxGroup, Checkbox as TCheckbox, Button as TButton, Input as TInput, MessagePlugin } from "tdesign-vue-next";
 import ILucideSearch from "~icons/lucide/search";
 import { $Http } from "@/plugins/http";
-import { arrayToTree } from "@/../utils/arrayToTree";
+import { arrayToTree } from "../../../../utils/arrayToTree";
 
 const $Prop = defineProps({
     modelValue: {

package/adminViews/permission/role/index.vue

@@ -102,7 +102,7 @@ import MenuDialog from "./components/menu.vue";
 import ApiDialog from "./components/api.vue";
 import DetailPanel from "@/components/DetailPanel.vue";
 import { $Http } from "@/plugins/http";
-import { withDefaultColumns } from "@/utils/withDefaultColumns";
+import { withDefaultColumns } from "../../../utils/withDefaultColumns";
 
 definePage({
     meta: {

package/apis/admin/cacheRefresh.ts

@@ -32,7 +32,7 @@ export default {
                 await befly.redis.setObject("apis:all", apis.data.lists);
                 results.apis = { success: true, count: apis.data.lists.length };
             } catch (error: any) {
-                befly.logger.error({ err: error }, "刷新接口缓存失败");
+                befly.logger.error({ err: error, msg: "刷新接口缓存失败" });
                 results.apis = { success: false, error: error.message };
             }
 
@@ -54,7 +54,7 @@ export default {
                     childCount: childCount
                 };
             } catch (error: any) {
-                befly.logger.error({ err: error }, "刷新菜单缓存失败");
+                befly.logger.error({ err: error, msg: "刷新菜单缓存失败" });
                 results.menus = { success: false, error: error.message };
             }
 
@@ -74,7 +74,7 @@ export default {
 
                 results.roles = { success: true, count: count };
             } catch (error: any) {
-                befly.logger.error({ err: error }, "刷新角色缓存失败");
+                befly.logger.error({ err: error, msg: "刷新角色缓存失败" });
                 results.roles = { success: false, error: error.message };
             }
 
@@ -83,7 +83,7 @@ export default {
                 await befly.cache.rebuildRoleApiPermissions();
                 results.roleApiPermissions = { success: true };
             } catch (error: any) {
-                befly.logger.error({ err: error }, "重建角色接口权限缓存失败");
+                befly.logger.error({ err: error, msg: "重建角色接口权限缓存失败" });
                 results.roleApiPermissions = { success: false, error: error.message };
             }
 
@@ -96,7 +96,7 @@ export default {
                 return befly.tool.No("部分缓存刷新失败", results);
             }
         } catch (error: any) {
-            befly.logger.error({ err: error }, "刷新全部缓存失败");
+            befly.logger.error({ err: error, msg: "刷新全部缓存失败" });
             return befly.tool.No("刷新全部缓存失败", { error: error.message });
         }
     }

package/apis/api/all.ts

@@ -21,7 +21,7 @@ export default {
 
             return befly.tool.Yes("操作成功", { lists: allApis });
         } catch (error: any) {
-            befly.logger.error({ err: error }, "获取接口列表失败");
+            befly.logger.error({ err: error, msg: "获取接口列表失败" });
             return befly.tool.No("获取接口列表失败");
         }
     }

package/apis/api/list.ts

@@ -20,7 +20,7 @@ export default {
 
             return befly.tool.Yes("操作成功", result.data);
         } catch (error: any) {
-            befly.logger.error({ err: error }, "获取接口列表失败");
+            befly.logger.error({ err: error, msg: "获取接口列表失败" });
             return befly.tool.No("获取接口列表失败");
         }
     }

package/apis/auth/login.ts

@@ -82,7 +82,7 @@ export default {
                 return befly.tool.No("账号或密码错误");
             }
         } catch (error: any) {
-            befly.logger.error({ err: error }, "密码验证失败");
+            befly.logger.error({ err: error, msg: "密码验证失败" });
             logData.failReason = "密码格式错误";
             await befly.db.insData({ table: "addon_admin_login_log", data: logData });
             return befly.tool.No("密码格式错误，请重新设置密码");

package/apis/dashboard/serviceStatus.ts

@@ -14,7 +14,7 @@ export default {
                 responseTime: `${responseTime}ms`
             });
         } catch (error) {
-            befly.logger.error({ err: error }, "数据库状态检测失败");
+            befly.logger.error({ err: error, msg: "数据库状态检测失败" });
             services.push({
                 name: "数据库",
                 status: "stopped",
@@ -34,7 +34,7 @@ export default {
                     responseTime: `${responseTime}ms`
                 });
             } catch (error) {
-                befly.logger.error({ err: error }, "Redis状态检测失败");
+                befly.logger.error({ err: error, msg: "Redis状态检测失败" });
                 services.push({
                     name: "Redis",
                     status: "stopped",

package/apis/dashboard/systemResources.ts

@@ -87,7 +87,7 @@ export default {
                 befly.logger.warn("fs.statfs 不可用，无法获取磁盘信息");
             }
         } catch (error) {
-            befly.logger.warn({ err: error }, "获取磁盘信息失败");
+            befly.logger.warn({ err: error, msg: "获取磁盘信息失败" });
             // 获取失败时返回 0
             diskPercentage = 0;
             diskUsed = 0;

package/apis/email/send.ts

@@ -57,7 +57,7 @@ export default {
                 }
             });
         } catch (logError: any) {
-            befly.logger.error({ err: logError }, "记录邮件日志失败");
+            befly.logger.error({ err: logError, msg: "记录邮件日志失败" });
         }
 
         if (result.success) {

package/apis/menu/all.ts

@@ -51,7 +51,7 @@ export default {
             // 6. 返回一维数组（由前端构建树形结构）
             return befly.tool.Yes("获取菜单成功", { lists: authorizedMenus });
         } catch (error: any) {
-            befly.logger.error({ err: error }, "获取用户菜单失败");
+            befly.logger.error({ err: error, msg: "获取用户菜单失败" });
             return befly.tool.No("获取菜单失败");
         }
     }

package/apis/menu/list.ts

@@ -14,7 +14,7 @@ export default {
 
             return befly.tool.Yes("操作成功", { lists: menus.data.lists });
         } catch (error) {
-            befly.logger.error({ err: error }, "获取菜单列表失败");
+            befly.logger.error({ err: error, msg: "获取菜单列表失败" });
             return befly.tool.No("操作失败");
         }
     }

package/apis/role/del.ts

@@ -42,7 +42,7 @@ export default {
 
             return befly.tool.Yes("操作成功");
         } catch (error: any) {
-            befly.logger.error({ err: error }, "删除角色失败");
+            befly.logger.error({ err: error, msg: "删除角色失败" });
             return befly.tool.No("操作失败");
         }
     }

package/apis/role/save.ts

@@ -36,7 +36,7 @@ export default {
 
             return befly.tool.Yes("操作成功");
         } catch (error: any) {
-            befly.logger.error({ err: error }, "保存用户角色失败");
+            befly.logger.error({ err: error, msg: "保存用户角色失败" });
             return befly.tool.No("操作失败");
         }
     }

package/apis/sysConfig/del.ts

@@ -26,7 +26,7 @@ export default {
 
             return befly.tool.Yes("操作成功");
         } catch (error) {
-            befly.logger.error({ err: error }, "删除系统配置失败");
+            befly.logger.error({ err: error, msg: "删除系统配置失败" });
             return befly.tool.No("操作失败");
         }
     }

package/apis/sysConfig/ins.ts

@@ -31,7 +31,7 @@ export default {
 
             return befly.tool.Yes("操作成功", { id: configId.data });
         } catch (error) {
-            befly.logger.error({ err: error }, "添加系统配置失败");
+            befly.logger.error({ err: error, msg: "添加系统配置失败" });
             return befly.tool.No("操作失败");
         }
     }

package/apis/sysConfig/upd.ts

@@ -46,7 +46,7 @@ export default {
 
             return befly.tool.Yes("操作成功");
         } catch (error) {
-            befly.logger.error({ err: error }, "更新系统配置失败");
+            befly.logger.error({ err: error, msg: "更新系统配置失败" });
             return befly.tool.No("操作失败");
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@befly-addon/admin",
-    "version": "1.4.1",
-    "gitHead": "2ff9d8fc0422aa7332afdd7c19d16493004cdfcf",
+    "version": "1.5.0",
+    "gitHead": "340c00e4dd05b62d89d25c01922c27cb35bd99af",
     "private": false,
     "description": "Befly - 管理后台功能组件",
     "keywords": [
@@ -29,7 +29,8 @@
         "libs/",
         "plugins/",
         "styles/",
-        "tables/"
+        "tables/",
+        "utils/"
     ],
     "type": "module",
     "main": "package.json",

package/utils/arrayToTree.ts

@@ -0,0 +1,135 @@
+export type ArrayToTreeResult<T extends Record<string, any>> = {
+    flat: Array<T>;
+    tree: Array<T>;
+    map: Map<string, T>;
+};
+
+/**
+ * 将一维数组按 { id, pid } 组装为树形结构（纯函数 / 无副作用）。
+ *
+ * - 默认字段：id / pid / children / sort
+ * - pid 为空字符串或父节点不存在时，视为根节点
+ * - 内部会 clone 一份节点对象，并写入 children: []
+ * - 默认自带递归排序：按 sort 升序；sort 缺省/非法或 < 1 视为 999999；sort 相同按 id 自然序
+ */
+export function arrayToTree<T extends Record<string, any>>(items: T[], id: string = "id", pid: string = "pid", children: string = "children", sort: string = "sort"): ArrayToTreeResult<T> {
+    const idKey = typeof id === "string" && id.length > 0 ? id : "id";
+    const pidKey = typeof pid === "string" && pid.length > 0 ? pid : "pid";
+    const childrenKey = typeof children === "string" && children.length > 0 ? children : "children";
+    const sortKey = typeof sort === "string" && sort.length > 0 ? sort : "sort";
+
+    const map = new Map<string, T>();
+    const flat: T[] = [];
+
+    const safeItems = Array.isArray(items) ? items : [];
+
+    const normalizeKey = (value: unknown): string => {
+        if (typeof value === "string") {
+            return value;
+        }
+        if (typeof value === "number" && Number.isFinite(value)) {
+            return String(value);
+        }
+        return "";
+    };
+
+    for (const item of safeItems) {
+        const rawId = item ? (item as any)[idKey] : undefined;
+        const rawPid = item ? (item as any)[pidKey] : undefined;
+
+        const normalizedId = normalizeKey(rawId);
+        const normalizedPid = normalizeKey(rawPid);
+
+        const nextNode = Object.assign({}, item) as T;
+        (nextNode as any)[idKey] = normalizedId;
+        (nextNode as any)[pidKey] = normalizedPid;
+        (nextNode as any)[childrenKey] = [];
+
+        flat.push(nextNode);
+
+        if (normalizedId.length > 0) {
+            map.set(normalizedId, nextNode);
+        }
+    }
+
+    const tree: T[] = [];
+
+    for (const node of flat) {
+        const selfId = normalizeKey(node ? (node as any)[idKey] : undefined);
+        const parentId = normalizeKey(node ? (node as any)[pidKey] : undefined);
+
+        if (parentId.length > 0 && parentId !== selfId) {
+            const parent = map.get(parentId);
+            if (parent && Array.isArray((parent as any)[childrenKey])) {
+                (parent as any)[childrenKey].push(node);
+                continue;
+            }
+        }
+
+        tree.push(node);
+    }
+
+    const collator = new Intl.Collator(undefined, { numeric: true, sensitivity: "base" });
+
+    const getSortValue = (node: T): number => {
+        const raw = node ? (node as any)[sortKey] : undefined;
+        if (typeof raw !== "number") {
+            return 999999;
+        }
+        if (!Number.isFinite(raw)) {
+            return 999999;
+        }
+        if (raw < 1) {
+            return 999999;
+        }
+        return raw;
+    };
+
+    const compareNode = (a: T, b: T): number => {
+        const aSort = getSortValue(a);
+        const bSort = getSortValue(b);
+
+        if (aSort !== bSort) {
+            return aSort - bSort;
+        }
+
+        const aId = a ? (a as any)[idKey] : "";
+        const bId = b ? (b as any)[idKey] : "";
+
+        return collator.compare(typeof aId === "string" ? aId : "", typeof bId === "string" ? bId : "");
+    };
+
+    const sortTreeInPlace = (nodes: Array<T>, seen: WeakSet<object>): void => {
+        if (!Array.isArray(nodes)) {
+            return;
+        }
+
+        if (nodes.length > 1) {
+            nodes.sort(compareNode);
+        }
+
+        for (const node of nodes) {
+            if (typeof node !== "object" || node === null) {
+                continue;
+            }
+
+            if (seen.has(node)) {
+                continue;
+            }
+            seen.add(node);
+
+            const childNodes = (node as any)[childrenKey];
+            if (Array.isArray(childNodes) && childNodes.length > 0) {
+                sortTreeInPlace(childNodes, seen);
+            }
+        }
+    };
+
+    sortTreeInPlace(tree, new WeakSet<object>());
+
+    return {
+        flat: flat,
+        tree: tree,
+        map: map
+    };
+}

package/utils/fieldClear.ts

@@ -0,0 +1,85 @@
+export interface FieldClearOptions {
+    pickKeys?: string[];
+    omitKeys?: string[];
+    keepValues?: any[];
+    excludeValues?: any[];
+    keepMap?: Record<string, any>;
+}
+
+export type FieldClearResult<T> = T extends Array<infer U> ? Array<FieldClearResult<U>> : T extends object ? { [K in keyof T]?: T[K] } : T;
+
+function isObject(val: unknown): val is Record<string, any> {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+
+function isArray(val: unknown): val is any[] {
+    return Array.isArray(val);
+}
+
+export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions = {}): FieldClearResult<T> {
+    const pickKeys = options.pickKeys;
+    const omitKeys = options.omitKeys;
+    const keepValues = options.keepValues;
+    const excludeValues = options.excludeValues;
+    const keepMap = options.keepMap;
+
+    const filterObj = (obj: Record<string, any>) => {
+        const result: Record<string, any> = {};
+
+        let keys = Object.keys(obj);
+        if (pickKeys && pickKeys.length) {
+            keys = keys.filter((k) => pickKeys.includes(k));
+        }
+        if (omitKeys && omitKeys.length) {
+            keys = keys.filter((k) => !omitKeys.includes(k));
+        }
+
+        for (const key of keys) {
+            const value = obj[key];
+
+            // 1. keepMap 优先
+            if (keepMap && Object.prototype.hasOwnProperty.call(keepMap, key)) {
+                if (Object.is(keepMap[key], value)) {
+                    result[key] = value;
+                    continue;
+                }
+            }
+
+            // 2. keepValues
+            if (keepValues && keepValues.length && !keepValues.includes(value)) {
+                continue;
+            }
+
+            // 3. excludeValues
+            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
+                continue;
+            }
+
+            result[key] = value;
+        }
+
+        return result;
+    };
+
+    if (isArray(data)) {
+        return (data as any[])
+            .map((item) => {
+                if (isObject(item)) {
+                    return filterObj(item);
+                }
+                return item;
+            })
+            .filter((item) => {
+                if (isObject(item)) {
+                    return Object.keys(item).length > 0;
+                }
+                return true;
+            }) as FieldClearResult<T>;
+    }
+
+    if (isObject(data)) {
+        return filterObj(data as Record<string, any>) as FieldClearResult<T>;
+    }
+
+    return data as FieldClearResult<T>;
+}

package/utils/hashPassword.ts

@@ -0,0 +1,19 @@
+/**
+ * 使用 SHA-256 对密码进行哈希。
+ * @param password - 原始密码
+ * @param salt - 盐值，默认为 befly
+ * @returns 哈希后的密码（十六进制字符串）
+ */
+export async function hashPassword(password: string, salt: string = "befly"): Promise<string> {
+    const data = password + salt;
+
+    const encoder = new TextEncoder();
+    const dataBuffer = encoder.encode(data);
+
+    const hashBuffer = await crypto.subtle.digest("SHA-256", dataBuffer);
+
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+
+    return hashHex;
+}

package/utils/normalizePathnameListInput.ts

@@ -0,0 +1,55 @@
+const HTTP_METHOD_PREFIX_RE = /^(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)\b/i;
+
+/**
+ * 将未知输入规范化为 pathname 字符串数组。
+ *
+ * 规则（契约）：
+ * - value 为“假值”（null/undefined/""/0/false/NaN）时返回空数组 []。
+ * - value 必须是 string[]，否则抛错：`${fieldLabel} 必须是字符串数组`。
+ * - 数组元素必须满足：
+ *   - 类型为 string
+ *   - 不允许为空字符串
+ *   - 不允许包含任何空白字符（空格/制表符/换行等）
+ *   - 必须以 "/" 开头（pathname）
+ * - forbidMethodPrefix=true 时，禁止 "GET/POST/..." 等 method 前缀，并给出更明确的错误提示。
+ *
+ * 注意：该函数不会做任何隐式修复/转换（例如 trim/split/JSON.parse/去重/排序）。
+ */
+export function normalizePathnameListInput(value: unknown, fieldLabel: string, forbidMethodPrefix: boolean): string[] {
+    if (!value) return [];
+
+    if (!Array.isArray(value)) {
+        throw new Error(`${fieldLabel} 必须是字符串数组`);
+    }
+
+    const out: string[] = [];
+
+    for (let i = 0; i < value.length; i += 1) {
+        const item = value[i];
+        const itemLabel = `${fieldLabel}[${i}]`;
+
+        if (typeof item !== "string") {
+            throw new Error(`${itemLabel} 必须是字符串`);
+        }
+
+        if (item.length === 0) {
+            throw new Error(`${itemLabel} 不允许为空字符串`);
+        }
+
+        if (forbidMethodPrefix && HTTP_METHOD_PREFIX_RE.test(item)) {
+            throw new Error(`${itemLabel} 不允许包含 method 前缀，应为 url.pathname（例如 /api/app/xxx）`);
+        }
+
+        if (/\s/.test(item)) {
+            throw new Error(`${itemLabel} 不允许包含空白字符（空格/制表符/换行等）`);
+        }
+
+        if (!item.startsWith("/")) {
+            throw new Error(`${itemLabel} 必须是 pathname（以 / 开头）`);
+        }
+
+        out.push(item);
+    }
+
+    return out;
+}

package/utils/withDefaultColumns.ts

@@ -0,0 +1,44 @@
+/**
+ * 为表格列添加默认配置（纯函数）。
+ *
+ * 默认行为：
+ * - base 默认：{ width: 200, ellipsis: true }
+ * - 特殊列：operation/state/id
+ * - colKey 以 At/At2 结尾时：默认 { align: "center" }
+ * - customConfig 可覆盖/扩展默认 specialColumnConfig
+ */
+export function withDefaultColumns(columns: any[], customConfig?: Record<string, any>): any[] {
+    const safeColumns = Array.isArray(columns) ? columns : [];
+
+    const specialColumnConfig: Record<string, any> = Object.assign(
+        {
+            operation: { width: 100, align: "center", fixed: "right" },
+            state: { width: 100, align: "center" },
+            id: { width: 200, align: "center" }
+        },
+        customConfig || {}
+    );
+
+    return safeColumns.map((col) => {
+        const colKey = col && (col as any).colKey;
+
+        let specialConfig = colKey ? specialColumnConfig[colKey] : undefined;
+
+        if (!specialConfig && typeof colKey === "string" && (colKey.endsWith("At") || colKey.endsWith("At2"))) {
+            specialConfig = { align: "center" };
+        }
+
+        const base = {
+            width: 200,
+            ellipsis: true
+        };
+
+        const merged = Object.assign({}, base);
+        if (specialConfig) {
+            Object.assign(merged, specialConfig);
+        }
+        Object.assign(merged, col);
+
+        return merged;
+    });
+}