@befly-addon/admin 1.8.6 → 1.8.8

package/adminViews/log/email/index.vue

@@ -24,8 +24,8 @@
         </template>
 
         <template #sendResult="{ row }">
-            <TTag v-if="row.sendResult === 1" shape="round" theme="success" variant="light-outline">成功</TTag>
-            <TTag v-else shape="round" theme="danger" variant="light-outline">失败</TTag>
+            <TTag v-if="row.sendResult === 1" shape="round" theme="success" variant="light-outline"> 成功 </TTag>
+            <TTag v-else shape="round" theme="danger" variant="light-outline"> 失败 </TTag>
         </template>
 
         <template #sendTime="{ row }">
@@ -35,8 +35,8 @@
         <template #detail="scope">
             <DetailPanel :data="scope.row" :fields="$Data.columns">
                 <template #sendResult="slotScope">
-                    <TTag v-if="slotScope.value === 1" shape="round" theme="success" variant="light-outline">成功</TTag>
-                    <TTag v-else shape="round" theme="danger" variant="light-outline">失败</TTag>
+                    <TTag v-if="slotScope.value === 1" shape="round" theme="success" variant="light-outline"> 成功 </TTag>
+                    <TTag v-else shape="round" theme="danger" variant="light-outline"> 失败 </TTag>
                 </template>
                 <template #sendTime="slotScope">
                     {{ formatTime(slotScope.value) }}
@@ -49,7 +49,7 @@
 
         <template #dialogs="scope">
             <PageDialog v-model="$Data.sendDialogVisible" title="发送邮件" :confirm-loading="$Data.sending" @confirm="(context) => onSend(scope.reload, context)" @cancel="onCancelSend" @close="onCancelSend">
-                <TForm :ref="(el) => ($From.sendForm = el)" :data="$Data.sendForm" :rules="$Data.sendRules" label-width="80px">
+                <TForm ref="sendFormRef" :data="$Data.sendForm" :rules="$Data.sendRules" label-width="80px">
                     <TFormItem label="收件人" name="to">
                         <TInput v-model="$Data.sendForm.to" placeholder="请输入收件人邮箱" />
                     </TFormItem>
@@ -69,6 +69,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive, ref } from "vue";
 import { Button as TButton, Form as TForm, FormItem as TFormItem, Input as TInput, MessagePlugin, Space as TSpace, Tag as TTag, Textarea as TTextarea } from "tdesign-vue-next";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import ILucideSend from "~icons/lucide/send";
@@ -79,12 +80,14 @@ import { $Http } from "@/plugins/http";
 import PagedTableDetail from "@/components/pagedTableDetail.vue";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
-const $From = $shallowRef({
-    sendForm: null
-});
+type TDesignFormInstance = {
+    validate: () => Promise<unknown>;
+};
+
+const sendFormRef = ref<TDesignFormInstance | null>(null);
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     columns: withDefaultColumns([
         { colKey: "username", title: "发送人", fixed: "left" },
         { colKey: "toEmail", title: "收件人" },
@@ -142,7 +145,13 @@ type PageDialogEventContext = {
 };
 
 async function onSend(reload: ((options: { keepSelection?: boolean; resetPage?: boolean }) => void) | null, context?: PageDialogEventContext): Promise<void> {
-    const valid = await $From.sendForm?.validate();
+    const form = sendFormRef.value;
+    if (!form) {
+        MessagePlugin.warning("表单未就绪");
+        return;
+    }
+
+    const valid = await form.validate();
     if (valid !== true) return;
 
     $Data.sending = true;
@@ -168,7 +177,7 @@ async function onSend(reload: ((options: { keepSelection?: boolean; resetPage?:
         } else {
             MessagePlugin.error(res.msg || "发送失败");
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("发送失败");
     } finally {
         $Data.sending = false;
@@ -183,7 +192,7 @@ async function onVerify(): Promise<void> {
         } else {
             MessagePlugin.error(res.msg || "配置异常");
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("验证失败");
     }
 }

package/adminViews/log/login/index.vue

@@ -39,6 +39,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 import { Button as TButton, Tag as TTag } from "tdesign-vue-next";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/detailPanel.vue";
@@ -46,7 +47,7 @@ import PagedTableDetail from "@/components/pagedTableDetail.vue";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     columns: withDefaultColumns([
         { colKey: "username", title: "用户名", fixed: "left" },
         { colKey: "ip", title: "登录IP" },

package/adminViews/log/operate/index.vue

@@ -62,6 +62,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 import { Button as TButton, Option as TOption, Select as TSelect, Tag as TTag } from "tdesign-vue-next";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/detailPanel.vue";
@@ -69,7 +70,7 @@ import PagedTableDetail from "@/components/pagedTableDetail.vue";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     columns: withDefaultColumns([
         { colKey: "username", title: "操作人", fixed: "left", width: 100 },
         { colKey: "module", title: "模块", width: 100 },

package/adminViews/login_1/index.vue

@@ -21,7 +21,7 @@
                     <p class="login-subtitle">请登录您的账户</p>
                 </div>
 
-                <TForm :model="$Data.formData" :rules="$Data.formRules" :ref="(el) => ($From.form = el)" class="login-form" :show-message="false" label-width="0">
+                <TForm :model="$Data.formData" :rules="$Data.formRules" ref="formRef" class="login-form" :show-message="false" label-width="0">
                     <TFormItem prop="account">
                         <TInputAdornment>
                             <template #prepend>
@@ -49,7 +49,7 @@
 
                     <div class="form-options">
                         <TCheckbox v-model="$Data.rememberMe">记住我</TCheckbox>
-                        <a href="#" class="link-text">忘记密码？</a>
+                        <a href="#" class="link-text"> 忘记密码？ </a>
                     </div>
 
                     <TButton theme="primary" class="login-btn" size="large" block :loading="$Data.loading" @click="apiLogin"> 登录 </TButton>
@@ -64,6 +64,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive, ref } from "vue";
 import { useRouter } from "vue-router";
 import { Form as TForm, FormItem as TFormItem, Input as TInput, Button as TButton, Checkbox as TCheckbox, InputAdornment as TInputAdornment, Select as TSelect, Option as TOption, MessagePlugin } from "tdesign-vue-next";
 import ILucideUser from "~icons/lucide/user";
@@ -74,13 +75,10 @@ import { hashPassword } from "befly-shared/utils/hashPassword";
 
 const router = useRouter();
 
-// 表单引用
-const $From = $shallowRef({
-    form: null
-});
+const formRef = ref<null | { validate: () => Promise<boolean> }>(null);
 
 // 数据定义
-const $Data = $ref({
+const $Data = reactive({
     loading: false,
     rememberMe: false,
     formRules: {
@@ -96,7 +94,12 @@ const $Data = $ref({
 
 async function apiLogin(): Promise<void> {
     try {
-        await $From.form.validate();
+        if (formRef.value === null) {
+            MessagePlugin.error("表单未就绪");
+            return;
+        }
+
+        await formRef.value.validate();
 
         $Data.loading = true;
 

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

@@ -1,7 +1,7 @@
 <template>
     <PageDialog v-model="dialogVisible" :title="$Prop.actionType === 'upd' ? '编辑管理员' : '添加管理员'" :confirm-loading="$Data.submitting" @confirm="onSubmit">
         <div class="dialog-wrapper">
-            <TForm :model="$Data.formData" label-width="80px" label-position="left" label-align="left" :rules="$Data2.formRules" :ref="(el) => ($From.form = el)">
+            <TForm :model="$Data.formData" label-width="80px" label-position="left" label-align="left" :rules="$Data2.formRules" ref="formRef">
                 <TFormItem label="角色" prop="roleCode">
                     <TSelect v-model="$Data.formData.roleCode" :options="$Data.allRoleLists" :keys="$Data.keys" placeholder="请选择角色" />
                 </TFormItem>
@@ -26,7 +26,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
+import { computed, reactive, ref } from "vue";
 
 import {
     //
@@ -68,9 +68,11 @@ type PageDialogEventContext = {
 };
 
 // 表单引用
-const $From = $shallowRef({
-    form: null
-});
+type TDesignFormInstance = {
+    validate: () => Promise<unknown>;
+};
+
+const formRef = ref<TDesignFormInstance | null>(null);
 
 const dialogVisible = computed({
     get: () => $Prop.modelValue,
@@ -79,7 +81,7 @@ const dialogVisible = computed({
     }
 });
 
-const $Data = $ref({
+const $Data = reactive({
     submitting: false,
     allRoleLists: [],
     keys: {
@@ -96,7 +98,7 @@ const $Data = $ref({
     }
 });
 
-const $Data2 = $shallowRef({
+const $Data2 = reactive({
     formRules: {
         username: [{ required: true, message: "请输入用户名", trigger: "blur" }],
         password: [
@@ -125,14 +127,20 @@ async function apiRoleLists(): Promise<void> {
             }
         );
         $Data.allRoleLists = result.data || [];
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载角色列表失败");
     }
 }
 
 async function onSubmit(context?: PageDialogEventContext): Promise<void> {
     try {
-        const valid = await $From.form.validate();
+        const form = formRef.value;
+        if (!form) {
+            MessagePlugin.warning("表单未就绪");
+            return;
+        }
+
+        const valid = await form.validate();
         if (!valid) return;
 
         $Data.submitting = true;

package/adminViews/people/admin/index.vue

@@ -48,6 +48,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 import { Button as TButton, Dropdown as TDropdown, DropdownItem as TDropdownItem, DropdownMenu as TDropdownMenu, Tag as TTag } from "tdesign-vue-next";
 import ILucidePlus from "~icons/lucide/plus";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
@@ -59,7 +60,7 @@ import PagedTableDetail from "@/components/pagedTableDetail.vue";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     columns: withDefaultColumns([
         { colKey: "username", title: "用户名", fixed: "left" },
         { colKey: "nickname", title: "昵称" },

package/adminViews/permission/api/index.vue

@@ -59,6 +59,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 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";
@@ -67,7 +68,7 @@ import { $Http } from "@/plugins/http";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     tableData: [],
     allData: [],
     loading: false,
@@ -108,7 +109,7 @@ async function loadApiAll(): Promise<void> {
             $Data.currentRow = null;
             $Data.activeRowKeys = [];
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载数据失败");
     } finally {
         $Data.loading = false;

package/adminViews/permission/menu/index.vue

@@ -40,6 +40,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 import { Button as TButton, Table as TTable, Tag as TTag, MessagePlugin } from "tdesign-vue-next";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
 import DetailPanel from "@/components/detailPanel.vue";
@@ -48,7 +49,7 @@ import { arrayToTree } from "befly-shared/utils/arrayToTree";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     tableData: [],
     loading: false,
     columns: withDefaultColumns([
@@ -89,7 +90,7 @@ async function apiMenuList(): Promise<void> {
             $Data.currentRow = null;
             $Data.activeRowKeys = [];
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载数据失败");
     } finally {
         $Data.loading = false;

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

@@ -32,7 +32,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
+import { computed, reactive } from "vue";
 
 import { Input as TInput, CheckboxGroup as TCheckboxGroup, Checkbox as TCheckbox, MessagePlugin } from "tdesign-vue-next";
 import ILucideSearch from "~icons/lucide/search";
@@ -66,7 +66,7 @@ const dialogVisible = computed({
     }
 });
 
-const $Data = $ref({
+const $Data = reactive({
     submitting: false,
     apiData: [],
     filteredApiData: [],
@@ -164,7 +164,7 @@ async function apiApiAll(): Promise<void> {
         });
 
         $Data.apiData = groups as never;
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载接口失败");
     }
 }
@@ -186,7 +186,7 @@ async function apiRoleApiDetail(): Promise<void> {
         const resRecord = res && typeof res === "object" ? (res as Record<string, unknown>) : null;
         const resData = resRecord && resRecord["data"] && typeof resRecord["data"] === "object" ? (resRecord["data"] as Record<string, unknown>) : null;
         $Data.checkedApiPaths = resData && Array.isArray(resData["apiPaths"]) ? (resData["apiPaths"] as never) : ([] as never);
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载数据失败");
     }
 }
@@ -236,7 +236,7 @@ async function onSubmit(context?: PageDialogEventContext): Promise<void> {
         } else {
             MessagePlugin.error(res.msg || "保存失败");
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("保存失败");
     } finally {
         $Data.submitting = false;

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

@@ -1,7 +1,7 @@
 <template>
     <PageDialog v-model="dialogVisible" :title="$Prop.actionType === 'upd' ? '更新角色' : '添加角色'" :confirm-loading="$Data.submitting" @confirm="onSubmit">
         <div class="comp-role-edit">
-            <TForm :model="$Data.formData" label-width="120px" label-position="left" :rules="$Data2.formRules" :ref="(el) => ($From.form = el)">
+            <TForm :model="$Data.formData" label-width="120px" label-position="left" :rules="$Data2.formRules" ref="formRef">
                 <TFormItem label="角色名称" prop="name">
                     <TInput v-model="$Data.formData.name" placeholder="请输入角色名称" />
                 </TFormItem>
@@ -26,7 +26,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
+import { computed, reactive, ref } from "vue";
 
 import {
     //
@@ -68,13 +68,15 @@ type PageDialogEventContext = {
 };
 
 // 表单引用
-const $From = $shallowRef({
-    form: null
-});
+type TDesignFormInstance = {
+    validate: () => Promise<unknown>;
+};
+
+const formRef = ref<TDesignFormInstance | null>(null);
 
 const $Computed = {};
 
-const $Data = $ref({
+const $Data = reactive({
     submitting: false,
     formData: {
         id: 0,
@@ -86,7 +88,7 @@ const $Data = $ref({
     }
 });
 
-const $Data2 = $shallowRef({
+const $Data2 = reactive({
     formRules: {
         name: [{ required: true, message: "请输入角色名称", trigger: "blur" }],
         code: [
@@ -112,7 +114,13 @@ const dialogVisible = computed({
 
 async function onSubmit(context?: PageDialogEventContext): Promise<void> {
     try {
-        const valid = await $From.form.validate();
+        const form = formRef.value;
+        if (!form) {
+            MessagePlugin.warning("表单未就绪");
+            return;
+        }
+
+        const valid = await form.validate();
         if (!valid) return;
 
         $Data.submitting = true;

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

@@ -33,7 +33,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
+import { computed, reactive } from "vue";
 
 import { CheckboxGroup as TCheckboxGroup, Checkbox as TCheckbox, Input as TInput, MessagePlugin } from "tdesign-vue-next";
 import ILucideSearch from "~icons/lucide/search";
@@ -68,7 +68,7 @@ const dialogVisible = computed({
     }
 });
 
-const $Data = $ref({
+const $Data = reactive({
     submitting: false,
     searchText: "",
     menuGroups: [],
@@ -134,7 +134,7 @@ async function apiMenuAll(): Promise<void> {
         }
 
         $Data.menuGroups = groups as never;
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载菜单失败");
     }
 }
@@ -154,7 +154,7 @@ async function apiRoleMenuDetail(): Promise<void> {
         );
 
         $Data.checkedMenuPaths = Array.isArray(res.data) ? res.data : [];
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("加载数据失败");
     }
 }
@@ -204,7 +204,7 @@ async function onSubmit(context?: PageDialogEventContext): Promise<void> {
         } else {
             MessagePlugin.error(res.msg || "保存失败");
         }
-    } catch (error) {
+    } catch (_error) {
         MessagePlugin.error("保存失败");
     } finally {
         $Data.submitting = false;

package/adminViews/permission/role/index.vue

@@ -71,6 +71,7 @@
 </template>
 
 <script setup lang="ts">
+import { reactive } from "vue";
 import { Button as TButton, Dropdown as TDropdown, DropdownItem as TDropdownItem, DropdownMenu as TDropdownMenu, Tag as TTag } from "tdesign-vue-next";
 import ILucidePlus from "~icons/lucide/plus";
 import ILucideRotateCw from "~icons/lucide/rotate-cw";
@@ -86,7 +87,7 @@ import PagedTableDetail from "@/components/pagedTableDetail.vue";
 import { withDefaultColumns } from "befly-shared/utils/withDefaultColumns";
 
 // 响应式数据
-const $Data = $ref({
+const $Data = reactive({
     columns: withDefaultColumns([
         { colKey: "name", title: "角色名称" },
         { colKey: "code", title: "角色代码", width: 150 },

package/apis/admin/cacheRefresh.ts

@@ -4,7 +4,9 @@
  * 功能：
  * 1. 刷新接口缓存（apis:all）
  * 2. 刷新菜单缓存（menus:all）
- * 3. 刷新角色权限缓存（role:info:{code}）
+ * 3. 刷新角色缓存（role:info:{code}）
+ * 4. 重建角色接口权限缓存（role:apis:{code}，Set）
+ * 5. 重建角色菜单权限缓存（role:menus:{code}，Set）
  *
  * 使用场景：
  * - 执行数据库同步后
@@ -22,7 +24,8 @@ const route: ApiRoute = {
                 apis: { success: false, count: 0 },
                 menus: { success: false, count: 0 },
                 roles: { success: false, count: 0 },
-                roleApiPermissions: { success: false }
+                roleApiPermissions: { success: false },
+                roleMenuPermissions: { success: false }
             };
 
             // 1. 刷新接口缓存
@@ -89,8 +92,17 @@ const route: ApiRoute = {
                 results["roleApiPermissions"] = { success: false, error: error.message };
             }
 
+            // 5. 重建角色菜单权限缓存
+            try {
+                await befly.cache.rebuildRoleMenuPermissions();
+                results["roleMenuPermissions"] = { success: true };
+            } catch (error: any) {
+                befly.logger.error({ err: error, msg: "重建角色菜单权限缓存失败" });
+                results["roleMenuPermissions"] = { success: false, error: error.message };
+            }
+
             // 检查是否全部成功
-            const allSuccess = results["apis"].success && results["menus"].success && results["roles"].success && results["roleApiPermissions"].success;
+            const allSuccess = results["apis"].success && results["menus"].success && results["roles"].success && results["roleApiPermissions"].success && results["roleMenuPermissions"].success;
 
             if (allSuccess) {
                 return befly.tool.Yes("全部缓存刷新成功", results);

package/apis/api/all.ts

@@ -1,28 +1,21 @@
-import type { DbJsonRow } from "../../utils/dbJsonRow";
 import type { ApiRoute } from "befly/types/api";
+import type { JsonValue, KeyValue } from "befly/types/common";
+
+type ApiRow = KeyValue<JsonValue>;
 
 const route: ApiRoute = {
     name: "获取所有接口",
     handler: async (befly) => {
         try {
             // 从缓存获取所有接口
-            let allApis: unknown[] = await befly.cache.getApis();
+            const allApis = (await befly.cache.getApis()) as ApiRow[];
 
-            // 如果缓存不存在，从数据库查询并缓存
+            // 强制缓存：不回退 DB
             if (allApis.length === 0) {
-                const result = await befly.db.getAll<DbJsonRow>({
-                    table: "addon_admin_api",
-                    orderBy: ["id#ASC"]
-                });
-                allApis = result.data.lists;
-
-                // 缓存到 Redis
-                if (allApis.length > 0) {
-                    await befly.cache.cacheApis();
-                }
+                return befly.tool.No("接口缓存不存在，请刷新缓存", { lists: [] });
             }
 
-            const lists = allApis.filter((api): api is Record<string, unknown> => typeof api === "object" && api !== null).map((api) => api as DbJsonRow);
+            const lists = allApis.filter((api) => api && typeof api === "object");
 
             return befly.tool.Yes("操作成功", { lists: lists });
         } catch (error: unknown) {

package/apis/menu/all.ts

@@ -1,61 +1,48 @@
 /**
  * 获取当前用户的菜单权限
  * 说明：
- * 1. 从 Redis 缓存读取所有菜单（如果缓存不存在则从数据库查询并缓存）
- * 2. 根据当前登录用户的角色过滤可访问的菜单
- * 3. 返回一维数组（由前端构建树形结构）
- * 4. 仅返回状态为启用的菜单
+ * 1. 从 Redis 缓存读取所有菜单（强制：不回退 DB）
+ * 2. 从 Redis Set 读取角色菜单权限（role:menus:{roleCode}），拿到该角色可访问的菜单 path 列表
+ * 3. 根据角色菜单 path 列表过滤可访问的菜单
+ * 4. 返回一维数组（由前端构建树形结构）
+ * 5. 仅返回状态为启用的菜单
  */
 
-import type { DbJsonRow } from "../../utils/dbJsonRow";
 import type { ApiRoute } from "befly/types/api";
+import type { JsonValue, KeyValue } from "befly/types/common";
+
+type MenuRow = KeyValue<JsonValue>;
 
 const route: ApiRoute = {
     name: "获取用户菜单",
     handler: async (befly, ctx) => {
         try {
-            // 2. 查询角色信息获取菜单权限（使用 roleCode 而非 roleId）
-            const role = await befly.db.getOne<{ id?: number; menus?: unknown }>({
-                table: "addon_admin_role",
-                where: { code: ctx.user["roleCode"] }
-            });
-
-            if (!role.data?.id) {
-                return befly.tool.No("角色不存在", { lists: [] });
+            const roleCode = typeof ctx.user["roleCode"] === "string" ? ctx.user["roleCode"] : "";
+            if (roleCode.length === 0) {
+                return befly.tool.No("角色缺失", { lists: [] });
             }
 
-            // 3. 解析菜单路径列表（menu.path 数组，array_text）
-            const rawMenuPaths = Array.isArray(role.data.menus) ? role.data.menus : [];
-            const menuPaths = rawMenuPaths.map((p: unknown) => (typeof p === "string" ? p.trim() : "")).filter((p: string) => p.length > 0);
+            // 2. 从 Redis Set 读取角色菜单权限（由 core 的 cache 体系维护）
+            // 约定：key = role:menus:{roleCode}（会自动加上 Redis prefix）
+            const menuPaths = await befly.cache.getRoleMenuPermissions(roleCode);
 
             if (menuPaths.length === 0) {
                 return befly.tool.Yes("菜单为空", { lists: [] });
             }
 
-            // 4. 从缓存获取所有菜单
-            let allMenus: unknown[] = await befly.cache.getMenus();
-
-            // 如果缓存不存在，从数据库查询
-            if (allMenus.length === 0) {
-                const result = await befly.db.getAll<DbJsonRow>({
-                    table: "addon_admin_menu"
-                });
-                allMenus = result.data.lists;
-            }
+            // 4. 从缓存获取所有菜单（强制：不回退 DB）
+            const allMenus = (await befly.cache.getMenus()) as MenuRow[];
 
             if (allMenus.length === 0) {
-                return befly.tool.Yes("菜单为空", { lists: [] });
+                return befly.tool.No("菜单缓存不存在，请刷新缓存", { lists: [] });
             }
 
             // 5. 根据角色权限过滤菜单（按 menu.path）
             const menuPathSet = new Set<string>(menuPaths);
-            const authorizedMenus = allMenus
-                .filter((menu): menu is Record<string, unknown> => typeof menu === "object" && menu !== null)
-                .filter((menu) => {
-                    const path = menu["path"];
-                    return typeof path === "string" && menuPathSet.has(path);
-                })
-                .map((menu) => menu as DbJsonRow);
+            const authorizedMenus = allMenus.filter((menu) => {
+                const path = menu["path"];
+                return typeof path === "string" && menuPathSet.has(path);
+            });
 
             // 6. 返回一维数组（由前端构建树形结构）
             return befly.tool.Yes("获取菜单成功", { lists: authorizedMenus });