@qilitt-mickey/vue3-temp-skill 1.1.11 → 1.1.13

package/references/layout-theme.md

@@ -1,8 +1,8 @@
 ---
 skill: layout-theme
-description: 规范设计系统（CSS 变量体系、主题色、暗黑模式、侧边栏配色、Design Tokens）、布局系统、UnoCSS 桥接、响应式适配和 PC/移动端双端 UI 适配方案。在修改布局、主题、颜色、暗黑模式、样式或使用 ui-ux-pro-max 设计输出时调用。
+description: 布局、主题色、暗黑模式、侧栏配色、Design Tokens、UnoCSS、响应式。修改布局/主题/颜色时加载。上游设计产出落地见 design-handoff / design-system。
 scope: project
-tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plus, vant, dual-ui, unocss, chroma-js, ui-ux-pro-max]
+tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plus, vant, dual-ui, unocss, chroma-js]
 ---
 
 # 设计系统、布局与主题适配
@@ -33,6 +33,8 @@ tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plu
 │  --vts-theme-sidebar-logo          Logo 区域背景           │
 │  --vts-theme-menu-title-hover      菜单标题悬停色           │
 │  --vts-theme-menu-active-before    激活指示条颜色           │
+  --vts-theme-menu-active-bg        激活菜单块背景色         │
+  --vts-sidebar-border-color        侧栏右边框色             │
 ├─────────────────────────────────────────────────────────┤
 │  第三层：Element Plus 变量（由 JS 动态设置）                  │
 │  --el-color-primary              主题主色                   │
@@ -58,18 +60,28 @@ tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plu
 
 ### 2.1 侧边栏 8 套配色预设
 
-通过 `html[data-theme='<name>']` 切换，定义在 `src/styles/theme.scss`：
+通过 `html[data-theme='<name>']` 切换，定义在 `src/styles/theme.scss`（模版出厂为单色侧栏变量；上游设计产出落地后可桥接 `--sidebar-*` 渐变，见 `design-handoff.md`）。
 
-| 主题名 | 中文名 | 菜单背景 | 激活指示色 | 对应主色 |
-|--------|--------|---------|-----------|---------|
-| `light` | 亮白色 | `#fff` | `#4091f7` | 默认蓝 |
-| `default` | 道奇蓝 | `#001529` | `#4091f7` | `#1b2a47` |
-| `saucePurple` | 深紫罗兰 | `#130824` | `#693ac9` | `#722ed1` |
-| `pink` | 深粉色 | `#28081a` | `#d84493` | `#eb2f96` |
-| `dusk` | 猩红色 | `#2a0608` | `#e13c39` | `#f5222d` |
-| `volcano` | 橙红色 | `#2b0e05` | `#e85f33` | `#fa541c` |
-| `mingQing` | 绿宝石 | `#032121` | `#59bfc1` | `#13c2c2` |
-| `auroraGreen` | 酸橙绿 | `#0b1e15` | `#60ac80` | `#52c41a` |
+| 主题名 | 中文名 | 说明 |
+|--------|--------|------|
+| `light` | 亮白色 | 浅色侧栏 |
+| `default` | 道奇蓝 | 深色侧栏（出厂 `#001529`） |
+| `saucePurple` | 深紫罗兰 | 深色侧栏 |
+| `pink` | 深粉色 | 深色侧栏 |
+| `dusk` | 猩红色 | 深色侧栏 |
+| `volcano` | 橙红色 | 深色侧栏 |
+| `mingQing` | 绿宝石 | 深色侧栏 |
+| `auroraGreen` | 酸橙绿 | 深色侧栏 |
+
+> **上游设计技能衔接**：色值与 `data-theme` 对应关系读 upstream 交接块，不在本 Skill 写死。落地时同步 `design-tokens.scss`、`theme.scss` 桥接、`platform-config.json` 的 `Theme` / `EpThemeColor`。
+
+### 2.1.1 侧栏扩展变量（设计技能落地后写入）
+
+| 令牌 | 用途 |
+|------|------|
+| `--vts-theme-menu-active-bg` | 激活菜单块背景 |
+| `--vts-sidebar-border-color` | 侧栏右边框 |
+| `--sidebar-*` | 由 upstream 主色板派生，见 handoff 文档 |
 
 ### 2.2 Element Plus 主色动态生成（chroma-js）
 
@@ -92,7 +104,7 @@ tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plu
 
 如果需要新增主题色，需要同时修改以下文件：
 
-1. `src/styles/theme.scss` — 添加 `html[data-theme='newTheme']` 的 8 个 `--vts-theme-*` 变量
+1. `src/styles/theme.scss` — 添加 `html[data-theme='newTheme']` 的 `--vts-theme-*` 变量（深色侧栏可桥接 upstream `--sidebar-*`）
 2. `src/hooks/useTheme.ts` — 在 `themeColors` 数组中添加 `{ color, themeColor, tip }` 条目
 3. 如果新主题色需要特殊的 EP 主色，还需在 `setLayoutThemeColor()` 中处理分支
 
@@ -128,8 +140,8 @@ html.dark {
   --vts-switch-off-color: #ffffff3f;              // 亮色: #a6a6a6
   --vts-dialog-bg: var(--ds-dialog-bg, rgb(36 37 37)); // 亮色: var(--ds-dialog-bg, linear-gradient(...))
 
-  // === 布局区域背景 ===
-  .navbar, .tags-view, .sidebar-container,
+  // === 布局区域背景（侧栏保留 theme 令牌，见 dark.scss 侧栏段） ===
+  .navbar, .tags-view,
   .horizontal-header, ... {
     background-color: var(--el-bg-color) !important;
   }
@@ -300,6 +312,55 @@ src/layout/
 3. 侧边栏菜单数据来源于路由配置中的 `meta` 信息。
 4. 标签页（TagsView）支持关闭、刷新、关闭其他等操作。
 
+### 顶栏高度（headerHeight）
+
+| 环节 | 约定 |
+|------|------|
+| 测量 | `lay-header` 用 `ResizeObserver` 测量 `.fixed-header`，写入 `$storage.configure.headerHeight` |
+| 重测 | 切换 `layout`、`hideTabs`、`hiddenSideBar` 后 `nextTick` 再测一次（避免布局切换后仍用 localStorage 旧值） |
+| 消费 | 业务页通过 `useApp().headerHeight` 读 `$storage.configure.headerHeight`；`lay-content` 的 `padding-top` 仍用 `--vts-layout-header-offset*`（勿与 storage 双向绑定，避免重测循环） |
+
+### 内容区高度与滚动
+
+| 场景 | 卡片 / 高度 | 滚动落点 |
+|------|-------------|----------|
+| 查询列表 | `el-card.vts-page-card` + 固定 `calc(100vh - 2 * var(--vts-margin) - ${headerHeight}px)`；表格绑 `useTableSearch().tableHeight` | 仅 `el-table` 体内；分页在表格下方 |
+| 树 + 表分栏 | 同上定高卡；左右并排，高度走 Hook 几何实测 | 同查询列表 |
+| 长表单 / 详情 / 说明 | 同公式可用 `minHeight`；不绑 `tableHeight` | `.app-main` 内 `el-scrollbar` |
+| Card 内边距 | `--vts-card-padding` → `--card-padding` | 换规范只改令牌；列表高度由 Hook 实测跟随 |
+
+`.vts-page-card`：`overflow: hidden`，`.el-card__body` 高度 100%。样式在 `element-plus.scss`。
+
+### 混合布局路由结构
+
+混合模式（mix）左侧栏只展示**一级**菜单，页面组件须挂在 **`children`** 下：
+
+```typescript
+// ✅ 正确：父级 redirect + children（参考 attachment.ts / websocket.ts）
+export default {
+  path: '/demo',
+  redirect: '/demo/list',
+  meta: { title: '示例模块', icon: '...', rank: ROUTER_RANK_NAME.DEMO },
+  children: [
+    {
+      path: '/demo/list',
+      name: 'DemoList',
+      component: () => import('@/views/demo/list.vue'),
+      meta: { title: '列表示例', showLink: true },
+    },
+  ],
+} satisfies RouteConfigsTable
+
+// ❌ 错误：单层路由直接挂 component（mix 模式下左侧子菜单为空）
+export default {
+  path: '/demo',
+  component: () => import('@/views/demo/list.vue'),
+  meta: { title: '示例', showLink: true },
+} satisfies RouteConfigsTable
+```
+
+**禁止**在 horizontal 模式下修改 `.el-menu--horizontal` 的 flex 溢出规则（会导致所有菜单项被收进「更多」）。
+
 ---
 
 ## 六、UnoCSS 桥接配置
@@ -378,177 +439,39 @@ src/styles/
 
 ---
 
-## 八、ui-ux-pro-max 设计输出衔接
-
-### 背景
-
-ui-ux-pro-max 是一个设计系统 Skill，通过 CSV 驱动的风格匹配引擎生成 UI 风格方案。生成的输出通常包含颜色方案、字体搭配、间距规则、组件样式建议等。
-
-### 衔接规则
-
-当用户使用 ui-ux-pro-max 生成设计方案后，需要将设计输出映射到本项目的代码体系中：
-
-**1. 颜色映射**
-
-ui-ux-pro-max 输出的颜色方案需要映射到项目的 CSS 变量体系：
-
-```
-设计输出中的主色 → --el-color-primary（由 chroma-js 自动生成色阶）
-设计输出中的背景色 → --el-bg-color 或 --vts-dialog-bg
-设计输出中的边框色 → --vts-border-color
-设计输出中的文字色 → --el-text-color-primary / --el-text-color-regular
-```
-
-**禁止**直接将设计稿的硬编码颜色写入组件样式，必须转换为对应的 CSS 变量。
+## 八、上游设计产出衔接
 
-**2. 暗黑模式适配**
+颜色 / 间距 / 组件几何映射与落地顺序 → **`design-handoff`** + **`design-system`**（只认产出物，不点名上游技能）。
 
-ui-ux-pro-max 生成的风格如果是"亮色模式专用"，必须同步考虑暗黑模式下的表现：
-- 检查每个硬编码颜色是否在 `dark.scss` 中有对应覆盖
-- 背景色不能直接使用白色/浅色硬编码，必须使用 CSS 变量
-- 图表配色需要在 ECharts 的 `setOption` 中根据 `dataTheme` 值切换配色方案
+落地后自检：
 
-**3. 间距与字号**
+- [ ] 颜色均经 CSS 变量 / 令牌
+- [ ] `html.dark` 与至少 `light`/`default` 侧栏主题正常
+- [ ] 间距遵循 UnoCSS 4px 基数；字号用项目 token
 
-ui-ux-pro-max 输出的间距/字号建议需要适配项目的 token 体系：
-- 间距使用 UnoCSS 的 `p-*` / `m-*` 类（baseFontSize: 4，所以 p-4 = 4px）
-- 字号使用 `text-xs`~`text-9xl`（已定义为 px 值）
-- 不要引入设计稿中的 rem/em 值，统一使用 px 或 UnoCSS 类
+## 九、PC / 移动双端
 
-**4. 组件样式**
+组件对照与 Vant 写法 → **`mobile-h5`**。本处只记策略：
 
-ui-ux-pro-max 建议的组件样式（如卡片阴影、按钮圆角等）需要通过以下方式实现：
-- 优先使用 UnoCSS 原子类（`shadow-sm`、`rounded-lg` 等）
-- 复杂样式写在 `<style scoped>` 中，使用 CSS 变量引用主题色
-- 需要覆盖 Element Plus 组件样式的，放在 `src/styles/element-plus.scss` 中
+| 策略 | 约定 |
+|------|------|
+| 判断 | `useApp().isMobile`（< 768px） |
+| 列表 | PC：`el-table`；移动：卡片 + `van-list` 触底 |
+| 弹窗/选择器 | 移动用 `van-popup` 包裹 |
+| 导航 | 移动底部 TabBar，不用侧栏 |
 
-**5. 风格一致性检查**
+## 十、数据大屏
 
-设计方案应用到代码后，必须检查：
-- [ ] 所有颜色是否通过 CSS 变量引用？
-- [ ] 暗黑模式下是否显示正常？（切换 `html.dark` 验证）
-- [ ] 侧边栏 8 套配色下是否协调？（至少检查 `light` 和 `default`）
-- [ ] 字号是否使用了项目定义的 token？
-- [ ] 间距是否遵循 4px 基数？
+完整约定 → **`data-screen`**。摘要：1920×1080 + `scale`；独立布局无菜单页头；图表用 ECharts。
 
----
-
-## 九、PC 端与移动端双端适配
-
-### 组件映射关系
-
-项目同时集成 Element Plus（PC）和 Vant（移动端），同一业务逻辑使用不同 UI 组件：
-
-| 功能 | PC 端 (Element Plus) | 移动端 (Vant) |
-|------|---------------------|---------------|
-| 弹窗 | `el-dialog` | `van-popup` + `van-dialog` |
-| 表格 | `ReGrid` / `el-table` | `van-list` + 卡片布局 |
-| 表单 | `el-form` | `van-form` + `van-field` |
-| 下拉选择 | `el-select` | `van-picker` + `van-popup` |
-| 级联选择 | `el-cascader` | `van-cascader` |
-| 日期选择 | `el-date-picker` | `van-date-picker` + `van-popup` |
-| 上传 | `el-upload` | `van-uploader` |
-| 分页 | `RePagination` | `van-pagination` 或触底加载 |
-| 搜索 | `el-input` + 搜索按钮 | `van-search` |
-| 消息提示 | `ElMessage` / `ElMessageBox` | `van-toast` / `van-dialog` |
-| 导航 | 侧边栏菜单 | 底部 TabBar |
-| 下拉刷新 | 无 | `van-pull-refresh` |
-
-### 双端适配策略
-
-```vue
-<!-- PC 端表格 -->
-<template v-if="!isMobile">
-  <ReGrid :data="list" :pagination="pagination">
-    <el-table-column prop="name" label="名称" />
-  </ReGrid>
-</template>
-
-<!-- 移动端卡片列表 -->
-<template v-else>
-  <van-list v-model:loading="loading" :finished="finished" @load="onLoad">
-    <div v-for="item in list" :key="item.id" class="card-base mb-3">
-      <!-- 卡片内容 -->
-    </div>
-  </van-list>
-</template>
-```
-
-### 响应式判断
-
-```typescript
-import { useApp } from "@/hooks/useApp";
-const { isMobile } = useApp();
-// isMobile 基于断点判断：< 768px 为移动端
-```
-
-### 双端适配约定
-
-1. 新页面必须同时考虑 PC 和移动端展示，使用 `isMobile` 条件渲染。
-2. 移动端表格数据改用卡片列表 + 触底加载，不要直接复用 PC 端表格。
-3. 移动端弹窗使用 `van-popup` 包裹选择器组件。
-4. 移动端导航使用底部 TabBar，不使用侧边栏。
-5. 搜索框在移动端使用 `van-search`，支持展开/收起。
-
----
-
-## 十、数据大屏布局
-
-### 标准尺寸
-
-数据大屏基于 1920x1080 设计稿，使用 `scale` 方案适配不同分辨率：
-
-```vue
-<script setup lang="ts">
-const scaleRef = ref({ x: 1, y: 1 });
-const screenRef = ref<HTMLDivElement>();
-
-function updateScale() {
-  const width = window.innerWidth / 1920;
-  const height = window.innerHeight / 1080;
-  scaleRef.value = { x: width, y: height };
-}
-
-onMounted(() => {
-  updateScale();
-  window.addEventListener("resize", updateScale);
-});
-onUnmounted(() => {
-  window.removeEventListener("resize", updateScale);
-});
-</script>
-
-<template>
-  <div ref="screenRef" :style="{
-    transform: `scale(${scaleRef.x}, ${scaleRef.y})`,
-    transformOrigin: 'left top',
-    width: '1920px', height: '1080px',
-  }">
-    <!-- 大屏内容 -->
-  </div>
-</template>
-```
-
-### 大屏约定
-
-1. 设计稿固定 1920x1080，使用 `scale` 等比缩放。
-2. 图表使用 ECharts，配合 `ReFlicker` 实现数据闪烁效果。
-3. 布局使用绝对定位 + 百分比，不使用 flex/grid 流式布局。
-4. 字体使用 `rem` 或 `vw/vh` 单位，确保缩放后比例正确。
-5. 大屏使用独立布局，不显示菜单/页头。
-
----
+## 十一、反例（短）
 
-## 十一、常见反例
-
-- 硬编码颜色值而不使用 CSS 变量（暗色模式不生效）。
-- 只写了亮色样式，没有在 `dark.scss` 中添加暗色覆盖。
-- 在 `element-plus.scss` 中新增硬编码颜色但不做暗黑适配。
-- 移动端直接复用 PC 端表格（体验差、性能差）。
-- 大屏使用 `vw/vh` 百分比布局而不是 `scale` 方案。
-- 不通过 `isMobile` 判断而使用 CSS `@media` 做逻辑分支。
-- UnoCSS 快捷方式命名不语义化（如 `f-c` 而非 `flex-center`）。
-- 使用 `chroma-js` 以外的库处理颜色（如 `color`、`polished`）。
-- 直接修改 `--el-color-primary` 而不通过 `setEpThemeColor()`（导致色阶不更新）。
-- 在组件 scoped 样式中写 `:root` 或 `html.dark` 选择器（无效）。
-- 新增侧边栏样式不检查 3 种布局模式的兼容性。
+| 错误 | 正确 |
+|------|------|
+| 硬编码颜色 | CSS 变量 / 令牌 |
+| 只写亮色 | 同步 `dark.scss` |
+| 移动直接复用 PC 表格 | `mobile-h5` 卡片列表 |
+| 大屏用流式 flex 替代 scale | 见 `data-screen` |
+| 直接改 `--el-color-primary` | `setEpThemeColor()` |
+| scoped 内写 `:root` / `html.dark` | 放全局样式文件 |
+| 侧栏样式不测 3 种布局 | 改后回归验证 |

package/references/mobile-h5.md

@@ -90,28 +90,28 @@ export default {
 
 ### 列表页（触底加载）
 
+分页 / 响应字段见 `http-api`（`pageNo`/`pageSize` → `content`/`totalCount`）。本处只示范 Vant 壳。
+
 ```vue
 <script setup lang="ts">
-import { ref } from "vue";
-import { getCustomerListApi } from "@/api/customer";
+import { getCustomerList } from "@/api/customer";
 
 defineOptions({ name: "MobileCustomer" });
 
-const list = ref<CustomerItem[]>([]);
+const list = ref<Customer[]>([]);
 const loading = ref(false);
 const finished = ref(false);
-const page = ref(1);
+const pageNo = ref(1);
 const pageSize = 10;
 
 async function onLoad() {
   loading.value = true;
   try {
-    const { data } = await getCustomerListApi({ page: page.value, pageSize });
-    if (data.list.length < pageSize) {
-      finished.value = true;
-    }
-    list.value.push(...data.list);
-    page.value++;
+    const res = await getCustomerList({ pageNo: pageNo.value, pageSize });
+    const rows = res.data?.content ?? [];
+    if (rows.length < pageSize) finished.value = true;
+    list.value.push(...rows);
+    pageNo.value++;
   } finally {
     loading.value = false;
   }
@@ -119,7 +119,7 @@ async function onLoad() {
 
 function onRefresh() {
   list.value = [];
-  page.value = 1;
+  pageNo.value = 1;
   finished.value = false;
   onLoad();
 }

package/references/project-inventory.md

@@ -1,13 +1,12 @@
 # 项目资产清单（Project Inventory）
 
-> **本模块是 AI 代码生成的前置必读文件。**
-> 在生成任何功能代码之前，AI 必须先查阅本清单，确认项目中是否已有对应的库、组件、Hook 或工具函数。
-> **已有封装须复用，勿另起一套同能力实现；选型表已指定的三方库勿擅自换成同类其他库（新依赖须待确认）。**
->
-> **版本真相源**：下表版本对齐模板仓库 `package.json`（2026-08 冻结）。生成前先查业务项目 `package.json`：  
-> - 已存在且版本一致 → 直接写代码，勿重复安装  
-> - 缺失或被裁剪 → 按「九、专项能力依赖安装表」给出 **精确版本** 的 `pnpm` 命令，**征得用户确认后再执行**  
-> - 禁止擅自升降级；禁止用 `latest` / 不带版本号安装选型表内的库
+## 何时读本文件
+
+按需加载（非始终）：查 Re* / Hook 名、确认库版本、命中 addon、缺依赖需安装时。硬约束与壳摘要见 `core-kernel`。
+
+- 已有封装须复用；选型表指定库勿擅自替换；新依赖须待确认
+- 版本对齐模板 `package.json`（2026-08 冻结）；先查业务项目 `package.json`
+- 缺失 →「九、专项能力依赖安装表」精确版本 `pnpm` 命令，确认后再装；禁止 `@latest` / 无版本号
 
 ---
 
@@ -219,9 +218,9 @@
 | Hook | 用途 | 关键 API |
 |---|---|---|
 | **useApp** | 全局应用状态（布局、字典、登出等） | `baseCodeGet(codeType)`、`filterValue()`、`headerHeight`、`svgLoading` |
-| **useDetail** | 详情页跳转与参数传递 | `toDetail({ id, mark, text })`、`initToDetail()`、`getParameter()` |
+| **useDetail** | 列表→详情：写顶部 tag 并跳转 | `toDetail(name, params, title?, 'query'\|'params')`、`initToDetail(name)`、`getParameter`；路由配 `showLink:false`（不进侧栏）+`activePath`（见 `detail-page`） |
 | **useFormCheck** | 多表单校验聚合 | 追踪各字段校验状态，emit `form-validate` 事件 |
-| **useTableSearch** | 列表页搜索/分页/Loading/动态表高 | `content`（须绑 `el-card`）、`otherRef`（查询条件外模块的统一根元素，高度自动从 `tableHeight` 扣除）、`tableHeight`、`paginationRef`、`tableData`、`pagination`、`loading`、`onSearch()`、`reset()`、`formRef`、`gridRef`、`collapsed` / `showCollapse` / `collapsedToggle` |
+| **useTableSearch** | 列表页搜索/分页/Loading/动态表高 | `content`（须绑 `el-card.vts-page-card`）、`multipleTableRef`（建议绑 `el-table`）、`otherRef`（表上方额外模块）、`tableHeight`（卡片底边 − 表格顶边 − 分页；空数据仍有占位高）、`paginationRef`、`tableData`、`pagination`、`loading`、`onSearch()`、`reset()`、`formRef`、`gridRef`、`collapsed` / `showCollapse` / `collapsedToggle` |
 | **useTags** | 多标签页管理 | 右键菜单（刷新/关闭/关闭其他/全屏） |
 | **useTheme** | 主题切换（暗色/亮色） | 主题色生成、布局预设、缓存重置 |
 | **useWebSocket** | WebSocket 通信 | `subscribe()`、`send()`、`sendRaw()`、`isConnected` |

package/references/table-vxe.md

@@ -25,14 +25,15 @@ pnpm add vxe-table@4.19.21 vxe-pc-ui@4.15.19
 
 ## 必须复用
 
-- HTTP / 分页约定仍走 `@/utils/http` + `Result<T>`
+- 请求与分页字段见 `http-api`（`Result<T>`、`pageNo`/`pageSize`/`content`/`totalCount`）
+- API 函数放 `src/api/`，组件内调用业务 API（勿在页面直接 `http.request`）
 
 ## 完整示例
 
 ```vue
 <script setup lang="ts">
 import type { VxeGridInstance, VxeGridProps } from "vxe-table";
-import { http } from "@/utils/http";
+import { getOrderList } from "@/api/order";
 
 defineOptions({ name: "OrderVxeList" });
 
@@ -43,7 +44,6 @@ interface RowVO {
 }
 
 const gridRef = ref<VxeGridInstance>();
-const loading = ref(false);
 
 const gridOptions = reactive<VxeGridProps<RowVO>>({
   border: true,
@@ -71,24 +71,18 @@ const gridOptions = reactive<VxeGridProps<RowVO>>({
 });
 
 async function loadData() {
-  loading.value = true;
   gridOptions.loading = true;
   try {
     const pager = gridOptions.pagerConfig!;
-    const res = await http.request<
-      Result<{ content?: RowVO[]; totalCount?: number }>
-    >("post", `${import.meta.env.VITE_API_BASE_URL}/console/order/list`, {
-      data: {
-        pageNo: pager.currentPage,
-        pageSize: pager.pageSize,
-      },
+    const res = await getOrderList({
+      pageNo: pager.currentPage,
+      pageSize: pager.pageSize,
     });
     if (res.status === 200) {
       gridOptions.data = res.data?.content || [];
       pager.total = res.data?.totalCount || 0;
     }
   } finally {
-    loading.value = false;
     gridOptions.loading = false;
   }
 }
@@ -111,4 +105,4 @@ onMounted(() => loadData());
 
 - [ ] 未对普通小列表强行上 VXE
 - [ ] 未引入其它表格库
-- [ ] 分页字段与项目一致（`pageNo`/`pageSize`/`content`/`totalCount`）
+- [ ] 分页字段与 `http-api` 一致

package/references/tree-table.md

@@ -108,5 +108,5 @@ import { ReTreeLine } from '@/components/ReTreeLine'
 
 ## 关联文件
 
-- [src/utils/tree.ts](file:///e:/work/vue3-web-temp/src/utils/tree.ts)
-- [src/components/ReTreeLine/index.ts](file:///e:/work/vue3-web-temp/src/components/ReTreeLine/index.ts)
+- `src/utils/tree.ts`
+- `src/components/ReTreeLine/index.ts`

package/references/websocket-realtime.md

@@ -172,6 +172,6 @@ VITE_WS_URL=wss://api.example.com/ws
 
 ## 关联文件
 
-- [src/hooks/useWebSocket.ts](file:///e:/work/vue3-web-temp/src/hooks/useWebSocket.ts)
-- [src/utils/websocket/index.ts](file:///e:/work/vue3-web-temp/src/utils/websocket/index.ts)
-- [src/utils/websocket/core.ts](file:///e:/work/vue3-web-temp/src/utils/websocket/core.ts)
+- `src/hooks/useWebSocket.ts`
+- `src/utils/websocket/index.ts`
+- `src/utils/websocket/core.ts`