befly-vite 1.1.10 → 1.1.12

package/README.md

@@ -21,7 +21,7 @@ bun add -d befly-vite vite
 
 ```javascript
 // vite.config.js
-import { createBeflyViteConfig } from 'befly-vite';
+import { createBeflyViteConfig } from "befly-vite";
 
 export default createBeflyViteConfig();
 ```
@@ -29,11 +29,11 @@ export default createBeflyViteConfig();
 ### 自定义配置
 
 ```javascript
-import { createBeflyViteConfig } from 'befly-vite';
-import { fileURLToPath } from 'node:url';
+import { createBeflyViteConfig } from "befly-vite";
+import { fileURLToPath } from "node:url";
 
 export default createBeflyViteConfig({
-    root: fileURLToPath(new URL('.', import.meta.url)),
+    root: fileURLToPath(new URL(".", import.meta.url)),
 
     // 自定义配置
     userConfig: {

package/configs/uno.config.js

@@ -1,4 +1,4 @@
-import { defineConfig, presetAttributify, presetUno } from 'unocss';
+import { defineConfig, presetAttributify, presetUno } from "unocss";
 
 /**
  * 创建 UnoCSS 配置
@@ -7,17 +7,17 @@ export function createUnoConfig(userConfig = {}) {
     const defaultConfig = {
         presets: [presetUno(), presetAttributify()],
         shortcuts: {
-            'flex-center': 'flex items-center justify-center',
-            'flex-between': 'flex items-center justify-between',
-            'flex-col-center': 'flex flex-col items-center justify-center'
+            "flex-center": "flex items-center justify-center",
+            "flex-between": "flex items-center justify-between",
+            "flex-col-center": "flex flex-col items-center justify-center"
         },
         theme: {
             colors: {
-                primary: '#1890ff',
-                success: '#52c41a',
-                warning: '#faad14',
-                danger: '#ff4d4f',
-                info: '#1890ff'
+                primary: "#1890ff",
+                success: "#52c41a",
+                warning: "#faad14",
+                danger: "#ff4d4f",
+                info: "#1890ff"
             }
         }
     };
@@ -27,11 +27,11 @@ export function createUnoConfig(userConfig = {}) {
         ...userConfig,
         theme: {
             ...defaultConfig.theme,
-            ...(userConfig.theme || {})
+            ...userConfig.theme
         },
         shortcuts: {
             ...defaultConfig.shortcuts,
-            ...(userConfig.shortcuts || {})
+            ...userConfig.shortcuts
         }
     });
 }

package/index.js

@@ -1,15 +1,17 @@
-import { defineConfig, mergeConfig } from 'vite';
-import { fileURLToPath } from 'node:url';
-import { createVuePlugins } from './plugins/vue.js';
-import { createRouterPlugin } from './plugins/router.js';
-import { createAutoImportPlugin } from './plugins/auto-import.js';
-import { createComponentsPlugin } from './plugins/components.js';
-import { createIconsPlugin } from './plugins/icons.js';
-import { createUnoCSSPlugin } from './plugins/unocss.js';
-import { createDevToolsPlugin } from './plugins/devtools.js';
-import { createAnalyzerPlugin } from './plugins/analyzer.js';
-import { createCompressionPlugin } from './plugins/compression.js';
-import { createInspectPlugin } from './plugins/inspect.js';
+import { fileURLToPath } from "node:url";
+
+import { defineConfig, mergeConfig } from "vite";
+
+import { createAnalyzerPlugin } from "./plugins/analyzer.js";
+import { createAutoImportPlugin } from "./plugins/auto-import.js";
+import { createComponentsPlugin } from "./plugins/components.js";
+import { createCompressionPlugin } from "./plugins/compression.js";
+import { createDevToolsPlugin } from "./plugins/devtools.js";
+import { createIconsPlugin } from "./plugins/icons.js";
+import { createReactivityTransformPlugin } from "./plugins/reactivity-transform.js";
+import { createRouterPlugin } from "./plugins/router.js";
+import { createUnoCSSPlugin } from "./plugins/unocss.js";
+import { createVuePlugin } from "./plugins/vue.js";
 
 /**
  * 默认分包策略
@@ -19,59 +21,59 @@ function defaultManualChunks(id) {
     // 注意：必须在 befly-addon 之前判断，因为 addon 会引用这些库
 
     // vue-router（优先级最高）
-    if (id.match(/node_modules[\/\\]vue-router[\/\\]/)) {
-        return 'vue-router';
+    if (id.match(/node_modules[/\\]vue-router[/\\]/)) {
+        return "vue-router";
     }
 
     // pinia
-    if (id.match(/node_modules[\/\\]pinia[\/\\]/)) {
-        return 'pinia';
+    if (id.match(/node_modules[/\\]pinia[/\\]/)) {
+        return "pinia";
     }
 
     // vue 核心和运行时（@vue/* 包）
-    if (id.match(/node_modules[\/\\](vue[\/\\]|@vue[\/\\])/)) {
-        return 'vue';
+    if (id.match(/node_modules[/\\](vue[/\\]|@vue[/\\])/)) {
+        return "vue";
     }
 
     // TDesign Vue Next
-    if (id.includes('tdesign-vue-next')) {
-        return 'tdesign';
+    if (id.includes("tdesign-vue-next")) {
+        return "tdesign";
     }
 
     // 工具库
-    if (id.match(/node_modules[\/\\]axios[\/\\]/)) {
-        return 'axios';
+    if (id.match(/node_modules[/\\]axios[/\\]/)) {
+        return "axios";
     }
-    if (id.match(/node_modules[\/\\]lodash-es[\/\\]/)) {
-        return 'lodash';
+    if (id.match(/node_modules[/\\]lodash-es[/\\]/)) {
+        return "lodash";
     }
 
     // echarts
-    if (id.match(/node_modules[\/\\]echarts[\/\\]/)) {
-        return 'echarts';
+    if (id.match(/node_modules[/\\]echarts[/\\]/)) {
+        return "echarts";
     }
-    if (id.match(/node_modules[\/\\]zrender[\/\\]/)) {
-        return 'zrender';
+    if (id.match(/node_modules[/\\]zrender[/\\]/)) {
+        return "zrender";
     }
 
     // 图标
-    if (id.includes('/@iconify/') || id.includes('~icons/')) {
-        return 'icons';
+    if (id.includes("/@iconify/") || id.includes("~icons/")) {
+        return "icons";
     }
 
     // Vue Macros
-    if (id.match(/node_modules[\/\\](@vue-macros|vue-macros)[\/\\]/)) {
-        return 'vue-macros';
+    if (id.match(/node_modules[/\\](@vue-macros|vue-macros)[/\\]/)) {
+        return "vue-macros";
     }
 
     // befly-addon（必须在 Vue 判断之后）
-    if (id.includes('@befly-addon/') || id.includes('packages/addonAdmin/') || id.includes('packages\\addonAdmin\\')) {
-        return 'befly-addon';
+    if (id.includes("@befly-addon/") || id.includes("packages/addonAdmin/") || id.includes("packages\\addonAdmin\\")) {
+        return "befly-addon";
     }
 
     // 其他 node_modules 依赖
-    if (id.includes('node_modules/')) {
-        return 'vendor';
+    if (id.includes("node_modules/")) {
+        return "vendor";
     }
 }
 
@@ -92,25 +94,25 @@ export function createBeflyViteConfig(options = {}) {
     const projectRoot = root || process.cwd();
 
     const baseConfig = defineConfig({
-        base: './',
+        base: "./",
 
         plugins: [
             //
             createUnoCSSPlugin(),
-            createDevToolsPlugin(),
             createRouterPlugin({ scanViews: scanViews }),
-            ...createVuePlugins(),
+            createVuePlugin(),
+            createReactivityTransformPlugin(),
+            createDevToolsPlugin(),
             createAutoImportPlugin({ resolvers: resolvers }),
             createComponentsPlugin({ resolvers: resolvers }),
             createIconsPlugin(),
             createAnalyzerPlugin(),
-            createInspectPlugin(),
             createCompressionPlugin()
         ],
 
         resolve: {
             alias: {
-                '@': fileURLToPath(new URL('src', `file:///${projectRoot.replace(/\\/g, '/')}/`))
+                "@": fileURLToPath(new URL("src", `file:///${projectRoot.replace(/\\/g, "/")}/`))
             }
         },
 
@@ -120,11 +122,11 @@ export function createBeflyViteConfig(options = {}) {
         },
 
         build: {
-            target: 'es2020',
-            outDir: 'dist',
-            assetsDir: 'assets',
+            target: "es2020",
+            outDir: "dist",
+            assetsDir: "assets",
             sourcemap: false,
-            minify: 'esbuild',
+            minify: "esbuild",
             chunkSizeWarningLimit: 1000,
             commonjsOptions: {
                 include: [/node_modules/],
@@ -132,53 +134,24 @@ export function createBeflyViteConfig(options = {}) {
             },
             rollupOptions: {
                 output: {
-                    chunkFileNames: 'assets/js/[name]-[hash].js',
-                    entryFileNames: 'assets/js/[name]-[hash].js',
-                    assetFileNames: 'assets/[ext]/[name]-[hash].[ext]',
+                    chunkFileNames: "assets/js/[name]-[hash].js",
+                    entryFileNames: "assets/js/[name]-[hash].js",
+                    assetFileNames: "assets/[ext]/[name]-[hash].[ext]",
                     manualChunks(id) {
-                        // 最高优先级：框架库必须单独打包
-                        if (id.includes('node_modules')) {
-                            // vue-router
-                            if (id.includes('/vue-router/')) return 'vue-router';
-                            // pinia
-                            if (id.includes('/pinia/')) return 'pinia';
-                            // vue 核心（包括 @vue/*）
-                            if (id.includes('/vue/') || id.includes('/@vue/')) return 'vue';
-                            // tdesign
-                            if (id.includes('/tdesign-vue-next/')) return 'tdesign';
-                            // axios
-                            if (id.includes('/axios/')) return 'axios';
-                            // 其他第三方库
-                            return 'vendor';
-                        }
-                        // befly-addon（workspace 包）
-                        if (id.includes('@befly-addon/') || id.includes('/addonAdmin/')) {
-                            return 'befly-addon';
+                        if (typeof manualChunks === "function") {
+                            const chunkName = manualChunks(id);
+                            if (chunkName) return chunkName;
                         }
+                        return defaultManualChunks(id);
                     }
                 }
             }
         },
 
         optimizeDeps: {
-            include: ['vue', 'vue-router', 'pinia', 'axios', 'tdesign-vue-next']
+            include: ["vue", "vue-router", "pinia", "axios", "tdesign-vue-next"]
         }
     });
 
     return mergeConfig(baseConfig, userConfig);
 }
-
-// 导出 UnoCSS 配置创建函数
-export { createUnoConfig } from './configs/uno.config.js';
-
-// 导出所有插件创建函数（供高级用户自定义）
-export { createVuePlugins } from './plugins/vue.js';
-export { createRouterPlugin } from './plugins/router.js';
-export { createAutoImportPlugin } from './plugins/auto-import.js';
-export { createComponentsPlugin } from './plugins/components.js';
-export { createIconsPlugin } from './plugins/icons.js';
-export { createUnoCSSPlugin } from './plugins/unocss.js';
-export { createDevToolsPlugin } from './plugins/devtools.js';
-export { createAnalyzerPlugin } from './plugins/analyzer.js';
-export { createCompressionPlugin } from './plugins/compression.js';
-export { createInspectPlugin } from './plugins/inspect.js';

package/package.json

@@ -1,43 +1,37 @@
 {
     "name": "befly-vite",
-    "version": "1.1.10",
+    "version": "1.1.12",
+    "private": false,
     "description": "Befly Vite 配置预设和插件集合",
+    "keywords": [
+        "befly",
+        "config",
+        "preset",
+        "vite",
+        "vue"
+    ],
+    "homepage": "https://chensuiyi.me",
+    "author": "chensuiyi <bimostyle@qq.com>",
+    "license": "Apache-2.0",
     "type": "module",
-    "private": false,
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org"
-    },
     "main": "index.js",
     "exports": {
         ".": "./index.js",
-        "./configs/*": "./configs/*.js",
-        "./plugins/*": "./plugins/*.js",
         "./utils/*": "./utils/*.js"
     },
     "files": [
+        "README.md",
         "configs/",
-        "plugins/",
         "index.js",
         "package.json",
-        "README.md"
-    ],
-    "keywords": [
-        "vite",
-        "vue",
-        "config",
-        "preset",
-        "befly"
+        "plugins/",
+        "utils/"
     ],
-    "author": "chensuiyi <bimostyle@qq.com>",
-    "homepage": "https://chensuiyi.me",
-    "license": "Apache-2.0",
     "dependencies": {
         "@unocss/preset-attributify": "^66.5.10",
         "@unocss/preset-uno": "^66.5.10",
-        "@vitejs/plugin-vue": "^6.0.2",
+        "@vitejs/plugin-vue": "^6.0.3",
         "@vue-macros/reactivity-transform": "^3.1.1",
-        "befly-shared": "^1.2.7",
         "sass": "^1.96.0",
         "unocss": "^66.5.10",
         "unplugin-auto-import": "^20.3.0",
@@ -46,15 +40,18 @@
         "unplugin-vue-router": "^0.19.0",
         "vite-bundle-analyzer": "^1.3.1",
         "vite-plugin-compression2": "^2.4.0",
-        "vite-plugin-inspect": "^11.3.3",
         "vite-plugin-vue-devtools": "^8.0.5"
     },
     "peerDependencies": {
-        "vite": "^8.0.0-beta.2",
-        "vue": "^3.5.25"
+        "vite": "^8.0.0-beta.3",
+        "vue": "^3.5.26"
     },
     "engines": {
         "bun": ">=1.3.0"
     },
-    "gitHead": "4b7ea2e7f6d7b5c7454f34c30794473d8bb021de"
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org"
+    },
+    "gitHead": "d42bf60ba6b8b11fef7e759fa008ada075829772"
 }

package/plugins/analyzer.js

@@ -1,16 +1,16 @@
-import { analyzer } from 'vite-bundle-analyzer';
+import { analyzer } from "vite-bundle-analyzer";
 
 /**
  * 创建打包分析插件配置
  */
 export function createAnalyzerPlugin(options = {}) {
-    const { analyzerMode = 'static', fileName = 'bundle-report', reportTitle = '打包分析', openAnalyzer = false } = options;
+    const { analyzerMode = "static", fileName = "bundle-report", reportTitle = "打包分析", openAnalyzer = false } = options;
 
     return analyzer({
         analyzerMode: analyzerMode,
         fileName: fileName,
         reportTitle: reportTitle,
-        defaultSizes: 'gzip',
+        defaultSizes: "gzip",
         gzipOptions: {},
         brotliOptions: {},
         openAnalyzer: openAnalyzer,

package/plugins/auto-import.js

@@ -1,6 +1,6 @@
-import AutoImport from 'unplugin-auto-import/vite';
-import { VueRouterAutoImports } from 'unplugin-vue-router';
-import { TDesignResolver } from 'unplugin-vue-components/resolvers';
+import AutoImport from "unplugin-auto-import/vite";
+import { TDesignResolver } from "unplugin-vue-components/resolvers";
+import { VueRouterAutoImports } from "unplugin-vue-router";
 
 /**
  * 创建自动导入插件配置
@@ -9,15 +9,15 @@ export function createAutoImportPlugin(options = {}) {
     const { resolvers = {} } = options;
 
     return AutoImport({
-        imports: ['vue', 'pinia', VueRouterAutoImports],
+        imports: ["vue", "pinia", VueRouterAutoImports],
         resolvers: [
             TDesignResolver({
-                library: 'vue-next'
+                library: "vue-next"
             }),
             ...(resolvers.auto || [])
         ],
-        dts: 'src/types/auto-imports.d.ts',
-        dirs: ['src/utils', 'src/plugins', 'src/config'],
+        dts: "src/types/auto-imports.d.ts",
+        dirs: ["src/utils", "src/plugins", "src/config"],
         vueTemplate: true
     });
 }

package/plugins/components.js

@@ -1,6 +1,6 @@
-import Components from 'unplugin-vue-components/vite';
-import { TDesignResolver } from 'unplugin-vue-components/resolvers';
-import IconsResolver from 'unplugin-icons/resolver';
+import IconsResolver from "unplugin-icons/resolver";
+import { TDesignResolver } from "unplugin-vue-components/resolvers";
+import Components from "unplugin-vue-components/vite";
 
 /**
  * 创建组件自动导入插件配置
@@ -11,13 +11,13 @@ export function createComponentsPlugin(options = {}) {
     return Components({
         resolvers: [
             TDesignResolver({
-                library: 'vue-next'
+                library: "vue-next"
             }),
             IconsResolver({}),
             ...(resolvers.components || [])
         ],
-        dirs: ['src/components'],
+        dirs: ["src/components"],
         deep: true,
-        dts: 'src/types/components.d.ts'
+        dts: "src/types/components.d.ts"
     });
 }

package/plugins/compression.js

@@ -1,10 +1,10 @@
-import { compression } from 'vite-plugin-compression2';
+import { compression } from "vite-plugin-compression2";
 
 /**
  * 创建文件压缩插件配置
  */
 export function createCompressionPlugin(options = {}) {
-    const { threshold = 10240, algorithms = ['gzip', 'brotliCompress'] } = options;
+    const { threshold = 10240, algorithms = ["gzip", "brotliCompress"] } = options;
 
     return compression({
         include: /\.(html|xml|css|json|js|mjs|svg)$/i,

package/plugins/devtools.js

@@ -1,8 +1,14 @@
-import VueDevTools from 'vite-plugin-vue-devtools';
+import VueDevTools from "vite-plugin-vue-devtools";
 
 /**
  * 创建 Vue DevTools 插件配置（仅开发环境）
  */
 export function createDevToolsPlugin() {
+    // 该插件内部会引入 inspector 能力；如果在非开发环境启用，容易引入不必要的解析开销/兼容性风险。
+    // Vite 的 plugins 数组允许包含 null/false，会被自动忽略。
+    if (process.env.NODE_ENV === "production") {
+        return null;
+    }
+
     return VueDevTools();
 }

package/plugins/icons.js

@@ -1,13 +1,13 @@
-import Icons from 'unplugin-icons/vite';
+import Icons from "unplugin-icons/vite";
 
 /**
  * 创建图标插件配置
  */
 export function createIconsPlugin() {
     return Icons({
-        compiler: 'vue3',
+        compiler: "vue3",
         autoInstall: false,
-        defaultClass: 'icon-befly',
-        defaultStyle: 'vertical-align: middle;'
+        defaultClass: "icon-befly",
+        defaultStyle: "vertical-align: middle;"
     });
 }

package/plugins/reactivity-transform.js

@@ -0,0 +1,8 @@
+import ReactivityTransform from "@vue-macros/reactivity-transform/vite";
+
+// 创建 Vue Reactivity Transform 插件配置
+export function createReactivityTransformPlugin() {
+    return ReactivityTransform({
+        exclude: []
+    });
+}

package/plugins/router.js

@@ -1,4 +1,4 @@
-import VueRouter from 'unplugin-vue-router/vite';
+import VueRouter from "unplugin-vue-router/vite";
 
 /**
  * 创建路由插件配置
@@ -8,9 +8,9 @@ export function createRouterPlugin(options = {}) {
 
     return VueRouter({
         routesFolder: scanViews(),
-        dts: './src/types/typed-router.d.ts',
-        extensions: ['.vue'],
-        importMode: 'async',
-        exclude: ['**/components/**']
+        dts: "./src/types/typed-router.d.ts",
+        extensions: [".vue"],
+        importMode: "async",
+        exclude: ["**/components/**"]
     });
 }

package/plugins/unocss.js

@@ -1,4 +1,4 @@
-import UnoCSS from 'unocss/vite';
+import UnoCSS from "unocss/vite";
 
 /**
  * 创建 UnoCSS 插件配置

package/plugins/vue.js

@@ -1,19 +1,13 @@
-import vue from '@vitejs/plugin-vue';
-import ReactivityTransform from '@vue-macros/reactivity-transform/vite';
+import vue from "@vitejs/plugin-vue";
 
 /**
  * 创建 Vue 插件配置
  */
-export function createVuePlugins() {
-    return [
-        vue({
-            script: {
-                defineModel: true,
-                propsDestructure: true
-            }
-        }),
-        ReactivityTransform({
-            exclude: []
-        })
-    ];
+export function createVuePlugin() {
+    return vue({
+        script: {
+            defineModel: true,
+            propsDestructure: true
+        }
+    });
 }

package/utils/arrayToTree.js

@@ -0,0 +1,55 @@
+/**
+ * @typedef {Object} ArrayToTreeOptions
+ * @property {string=} idField
+ * @property {string=} pidField
+ * @property {string=} childrenField
+ * @property {any=} rootPid
+ * @property {(node: any) => any=} mapFn
+ */
+
+/**
+ * @template T
+ * @param {T[]} items
+ * @param {ArrayToTreeOptions=} options
+ * @returns {T[]}
+ */
+export function arrayToTree(items, options = {}) {
+    const idField = typeof options.idField === "string" ? options.idField : "id";
+    const pidField = typeof options.pidField === "string" ? options.pidField : "pid";
+    const childrenField = typeof options.childrenField === "string" ? options.childrenField : "children";
+    const rootPid = "rootPid" in options ? options.rootPid : 0;
+    const mapFn = typeof options.mapFn === "function" ? options.mapFn : null;
+
+    /** @type {T[]} */
+    const tree = [];
+
+    for (const item of items) {
+        // @ts-ignore
+        const pid = item[pidField];
+
+        if (Object.is(pid, rootPid)) {
+            const node = Object.assign({}, item);
+            const mappedNode = mapFn ? mapFn(node) : node;
+
+            // 子节点 rootPid = node[id]
+            // @ts-ignore
+            const nextRootPid = mappedNode[idField];
+            const children = arrayToTree(items, {
+                idField: idField,
+                pidField: pidField,
+                childrenField: childrenField,
+                rootPid: nextRootPid,
+                mapFn: mapFn
+            });
+
+            if (children.length > 0) {
+                // @ts-ignore
+                mappedNode[childrenField] = children;
+            }
+
+            tree.push(mappedNode);
+        }
+    }
+
+    return tree;
+}

package/utils/createUnoConfig.js

@@ -0,0 +1,7 @@
+/**
+ * UnoCSS 配置创建函数（对外稳定导出）
+ *
+ * 注意：befly-vite 不再从主入口导出 configs/plugins，统一通过 utils 子路径导入。
+ */
+
+export { createUnoConfig } from "../configs/uno.config.js";

package/utils/fieldClear.js

@@ -0,0 +1,94 @@
+/**
+ * @typedef {Object} FieldClearOptions
+ * @property {string[]=} pickKeys
+ * @property {string[]=} omitKeys
+ * @property {any[]=} keepValues
+ * @property {any[]=} excludeValues
+ * @property {Record<string, any>=} keepMap
+ */
+
+function isObject(val) {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+
+function isArray(val) {
+    return Array.isArray(val);
+}
+
+/**
+ * 清理对象/数组字段
+ * - 支持 pick/omit/keepValues/excludeValues
+ * - 支持 keepMap 强制保留
+ * @template T
+ * @param {T|T[]} data
+ * @param {FieldClearOptions=} options
+ * @returns {any}
+ */
+export function fieldClear(data, options = {}) {
+    const pickKeys = options.pickKeys;
+    const omitKeys = options.omitKeys;
+    const keepValues = options.keepValues;
+    const excludeValues = options.excludeValues;
+    const keepMap = options.keepMap;
+
+    const filterObj = (obj) => {
+        /** @type {Record<string, any>} */
+        const result = {};
+
+        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
+            .map((item) => {
+                if (isObject(item)) {
+                    return filterObj(item);
+                }
+                return item;
+            })
+            .filter((item) => {
+                if (isObject(item)) {
+                    return Object.keys(item).length > 0;
+                }
+                return true;
+            });
+    }
+
+    if (isObject(data)) {
+        return filterObj(data);
+    }
+
+    return data;
+}

package/utils/hashPassword.js

@@ -0,0 +1,21 @@
+/**
+ * 密码哈希工具（浏览器侧）
+ * 使用 SHA-256 + 盐值对密码进行单向哈希
+ * @param {string} password
+ * @param {string=} salt
+ * @returns {Promise<string>} 十六进制哈希
+ */
+export async function hashPassword(password, salt = "befly") {
+    const data = String(password) + String(salt);
+
+    const encoder = new TextEncoder();
+    const dataBuffer = encoder.encode(data);
+
+    // Web Crypto API
+    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/layouts.js

@@ -0,0 +1,103 @@
+/**
+ * 自定义布局处理函数
+ * 根据文件名后缀 _数字 判断使用哪个布局
+ */
+
+/**
+ * @typedef {Object} RouteConfig
+ * @property {string=} path
+ * @property {any=} component
+ * @property {RouteConfig[]=} children
+ * @property {Record<string, any>=} meta
+ */
+
+/**
+ * @typedef {Object} LayoutConfig
+ * @property {string} path
+ * @property {string} layoutName
+ * @property {any} component
+ * @property {Record<string, any>=} meta
+ */
+
+/**
+ * @param {RouteConfig[]} routes
+ * @param {string=} inheritLayout
+ * @returns {LayoutConfig[]}
+ */
+export function Layouts(routes, inheritLayout = "") {
+    /** @type {LayoutConfig[]} */
+    const result = [];
+
+    for (const route of routes) {
+        const currentPath = route.path || "";
+
+        const pathMatch = currentPath.match(/_(\d+)$/);
+        const currentLayout = pathMatch ? pathMatch[1] : inheritLayout;
+
+        // 中间节点：递归处理子路由，不包裹布局
+        if (route.children && route.children.length > 0) {
+            const cleanPath = pathMatch ? currentPath.replace(/_\d+$/, "") : currentPath;
+            const childConfigs = Layouts(route.children, currentLayout);
+
+            for (const child of childConfigs) {
+                const mergedPath = cleanPath ? `${cleanPath}/${child.path}`.replace(/\/+/, "/") : child.path;
+                result.push({
+                    path: mergedPath,
+                    layoutName: child.layoutName,
+                    component: child.component,
+                    meta: child.meta
+                });
+            }
+            continue;
+        }
+
+        // 叶子节点：包裹布局
+        const lastPart = currentPath;
+        const match = lastPart.match(/_(\d+)$/);
+        const layoutName = match ? match[1] : currentLayout || "default";
+
+        let cleanPath = "";
+        if (lastPart === "index" || (lastPart.startsWith("index_") && match)) {
+            cleanPath = "";
+        } else if (match) {
+            cleanPath = lastPart.replace(/_\d+$/, "");
+        } else {
+            cleanPath = lastPart;
+        }
+
+        result.push({
+            path: cleanPath,
+            layoutName: layoutName,
+            component: route.component,
+            meta: route.meta
+        });
+    }
+
+    return result;
+}
+
+/**
+ * 将 Layouts 输出的扁平配置转换为 Vue Router 的 RouteRecordRaw
+ * 说明：resolveLayoutComponent 由业务方提供，以避免 utils 强耦合具体项目的布局路径。
+ *
+ * @param {LayoutConfig[]} configs
+ * @param {(layoutName: string) => any} resolveLayoutComponent
+ * @returns {import('vue-router').RouteRecordRaw[]}
+ */
+export function applyLayouts(configs, resolveLayoutComponent) {
+    return configs.map((config) => {
+        const layoutComponent = resolveLayoutComponent(config.layoutName);
+
+        return {
+            path: config.path,
+            component: layoutComponent,
+            meta: config.meta,
+            children: [
+                {
+                    path: "",
+                    component: config.component
+                }
+            ]
+        };
+    });
+}

package/utils/router.js

@@ -0,0 +1,109 @@
+/**
+ * 路由相关工具函数（守卫 / 布局装配 / resolver 等）
+ */
+
+import { Layouts, applyLayouts } from "./layouts.js";
+
+/**
+ * 规范化路由 path：去尾随 "/"（根路径 "/" 例外）。
+ *
+ * @param {any} path
+ * @returns {any}
+ */
+export function normalizeRoutePath(path) {
+    if (typeof path !== "string") {
+        return path;
+    }
+
+    const normalized = path.replace(/\/+$/, "");
+    return normalized.length === 0 ? "/" : normalized;
+}
+
+/**
+ * 应用一个最小可用的 token 鉴权守卫（业务方提供 token 获取方式与路径）。
+ *
+ * 约定：当路由 meta.public === true 时认为是公开路由。
+ *
+ * @param {import('vue-router').Router} router
+ * @param {{
+ *   getToken: () => any,
+ *   loginPath: string,
+ *   homePath: string
+ * }} options
+ */
+export function applyTokenAuthGuard(router, options) {
+    const normalizedLoginPath = normalizeRoutePath(options.loginPath);
+    const normalizedHomePath = normalizeRoutePath(options.homePath);
+
+    router.beforeEach(async (to, _from, next) => {
+        const token = options.getToken();
+        const toPath = normalizeRoutePath(to.path);
+
+        // 0. 根路径重定向
+        if (toPath === "/") {
+            return next(token ? normalizedHomePath : normalizedLoginPath);
+        }
+
+        // 1. 未登录且访问非公开路由 → 跳转登录
+        if (!token && to.meta?.public !== true && toPath !== normalizedLoginPath) {
+            return next(normalizedLoginPath);
+        }
+
+        // 2. 已登录访问登录页 → 跳转首页
+        if (token && toPath === normalizedLoginPath) {
+            return next(normalizedHomePath);
+        }
+
+        next();
+    });
+}
+
+/**
+ * 将“组件/懒加载函数/Promise”统一转换为 Vue Router 可接受的懒加载 component 函数。
+ *
+ * - 如果已经是函数（通常是 `() => import(...)`），直接返回。
+ * - 否则包一层函数（使其变成 lazy component）。
+ *
+ * @param {any} value
+ * @returns {any}
+ */
+function toLazyComponent(value) {
+    if (typeof value === "function") {
+        return value;
+    }
+
+    return () => value;
+}
+
+/**
+ * 创建布局组件解析器（resolver）。
+ *
+ * @param {{
+ *   resolveDefaultLayout: () => any,
+ *   resolveNamedLayout: (layoutName: string) => any,
+ *   defaultLayoutName?: string
+ * }} options
+ * @returns {(layoutName: string) => any}
+ */
+export function createLayoutComponentResolver(options) {
+    const defaultLayoutName = options.defaultLayoutName || "default";
+
+    return (layoutName) => {
+        if (layoutName === defaultLayoutName) {
+            return toLazyComponent(options.resolveDefaultLayout());
+        }
+
+        return toLazyComponent(options.resolveNamedLayout(layoutName));
+    };
+}
+
+/**
+ * 将 auto-routes 的 routes 按 `_数字` 规则套用布局组件，并输出 Vue Router 的 RouteRecordRaw[]。
+ *
+ * @param {any[]} routes
+ * @param {(layoutName: string) => any} resolveLayoutComponent
+ * @returns {import('vue-router').RouteRecordRaw[]}
+ */
+export function buildLayoutRoutes(routes, resolveLayoutComponent) {
+    return applyLayouts(Layouts(routes), resolveLayoutComponent);
+}

package/utils/scanViews.js

@@ -0,0 +1,55 @@
+import { existsSync, readdirSync, realpathSync } from "node:fs";
+import { join } from "node:path";
+
+/**
+ * 扫描项目和所有 @befly-addon 包的 views 目录
+ * 用于 unplugin-vue-router 的 routesFolder 配置
+ * 注意：此函数只能在 vite.config.js 中使用（Node.js 环境），不能在浏览器中使用
+ * @returns {Array<{ src: string, path: string, exclude: string[] }>} 路由文件夹配置数组
+ */
+export function scanViews() {
+    const projectRoot = process.cwd();
+    const addonBasePath = join(projectRoot, "node_modules", "@befly-addon");
+
+    /** @type {Array<{ src: string, path: string, exclude: string[] }>} */
+    const routesFolders = [];
+
+    // 1. 项目自身 views
+    const projectViewsPath = join(projectRoot, "src", "views");
+    if (existsSync(projectViewsPath)) {
+        routesFolders.push({
+            src: realpathSync(projectViewsPath),
+            path: "",
+            exclude: ["**/components/**"]
+        });
+    }
+
+    // 2. 扫描 @befly-addon/*/views
+    if (!existsSync(addonBasePath)) {
+        return routesFolders;
+    }
+
+    try {
+        const addonDirs = readdirSync(addonBasePath);
+
+        for (const addonName of addonDirs) {
+            const addonPath = join(addonBasePath, addonName);
+            if (!existsSync(addonPath)) {
+                continue;
+            }
+
+            const viewsPath = join(addonPath, "views");
+            if (existsSync(viewsPath)) {
+                routesFolders.push({
+                    src: realpathSync(viewsPath),
+                    path: `addon/${addonName}/`,
+                    exclude: ["**/components/**"]
+                });
+            }
+        }
+    } catch {
+        // 扫描失败保持静默，避免影响 Vite 启动
+    }
+
+    return routesFolders;
+}

package/utils/withDefaultColumns.js

@@ -0,0 +1,40 @@
+/**
+ * 为表格列添加默认配置
+ * @param {any[]} columns
+ * @param {Record<string, any>=} customConfig
+ * @returns {any[]}
+ */
+export function withDefaultColumns(columns, customConfig = {}) {
+    /** @type {Record<string, any>} */
+    const specialColumnConfig = Object.assign(
+        {
+            operation: { width: 100, align: "center", fixed: "right" },
+            state: { width: 100, align: "center" },
+            id: { width: 200, align: "center" }
+        },
+        customConfig
+    );
+
+    return columns.map((col) => {
+        const colKey = col && col.colKey;
+
+        let specialConfig = colKey ? specialColumnConfig[colKey] : undefined;
+
+        if (!specialConfig && colKey && (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;
+    });
+}

package/plugins/inspect.js

@@ -1,11 +0,0 @@
-import Inspect from 'vite-plugin-inspect';
-
-/**
- * 创建 Vite 插件转换分析工具
- */
-export function createInspectPlugin() {
-    return Inspect({
-        build: true,
-        outputDir: '.vite-inspect'
-    });
-}