dlzn-ui 2.0.26 → 2.0.28

package/chunks/{AssignUser-B8KO6qit.mjs → AssignUser-DZvNJ6_v.mjs}

@@ -1,8 +1,8 @@
 import { F as e, S as t } from "./provider-BhFm5rvy.mjs";
 import n from "../plugins/autoImport/$msg/index.mjs";
-import { t as r } from "./page-list-DMDDWHTe.mjs";
+import { t as r } from "./page-list-DUYDkWcj.mjs";
 import "../components/page-list/index.mjs";
-import { t as i } from "./SelectUser-Ce69wfaR.mjs";
+import { t as i } from "./SelectUser-Y-2MCvw3.mjs";
 import { computed as a, createBlock as o, defineComponent as s, h as c, mergeProps as l, openBlock as u, reactive as d, ref as f, unref as p, useTemplateRef as m } from "vue";
 //#endregion
 //#region ../../packages/dlzn-ui/views/system/role/modules/AssignUser.vue

package/chunks/{DictTypeDetail-DDv2c9JG.mjs → DictTypeDetail--OE6JJ5s.mjs}

@@ -1,6 +1,6 @@
 import { F as e, S as t, o as n } from "./provider-BhFm5rvy.mjs";
 import r from "../plugins/autoImport/$msg/index.mjs";
-import { t as i } from "./page-list-DMDDWHTe.mjs";
+import { t as i } from "./page-list-DUYDkWcj.mjs";
 import "../components/page-list/index.mjs";
 import { createBlock as a, defineComponent as o, h as s, mergeProps as c, openBlock as l, reactive as u, ref as d, unref as f, useTemplateRef as p, watch as m } from "vue";
 //#endregion

package/chunks/{Log-CPni6oj5.mjs → Log-DTQeRVz1.mjs}

@@ -1,6 +1,6 @@
 import { F as e, S as t, o as n } from "./provider-BhFm5rvy.mjs";
 import r from "../plugins/autoImport/$msg/index.mjs";
-import { t as i } from "./page-list-DMDDWHTe.mjs";
+import { t as i } from "./page-list-DUYDkWcj.mjs";
 import "../components/page-list/index.mjs";
 import { computed as a, createBlock as o, defineComponent as s, h as c, mergeProps as l, nextTick as u, openBlock as d, reactive as f, ref as p, unref as m, useTemplateRef as h, watch as g } from "vue";
 import { useRequest as _ } from "alova/client";

package/chunks/{SelectUser-Ce69wfaR.mjs → SelectUser-Y-2MCvw3.mjs}

@@ -1,6 +1,6 @@
 import { S as e } from "./provider-BhFm5rvy.mjs";
 import t from "../plugins/autoImport/$msg/index.mjs";
-import { t as n } from "./page-list-DMDDWHTe.mjs";
+import { t as n } from "./page-list-DUYDkWcj.mjs";
 import "../components/page-list/index.mjs";
 import { createBlock as r, defineComponent as i, mergeProps as a, openBlock as o, unref as s, useTemplateRef as c } from "vue";
 //#endregion

package/chunks/{custom-page-list-DNONwY-V.mjs → custom-page-list-Dkjf1nLR.mjs}

@@ -4,8 +4,8 @@ import { t as n } from "./card-Domqu1Hz.mjs";
 import "../components/card/index.mjs";
 import { t as r } from "./custom-page-table-y7emjJnS.mjs";
 import "../components/custom-page-table/index.mjs";
-import { n as i, r as a } from "./page-list-DMDDWHTe.mjs";
-import { t as o } from "./page-query-CRbcQbQW.mjs";
+import { n as i, r as a } from "./page-list-DUYDkWcj.mjs";
+import { t as o } from "./page-query-oFiHpSCX.mjs";
 import "../components/page-query/index.mjs";
 import "../components/page-list/index.mjs";
 import { Fragment as s, createBlock as c, createCommentVNode as l, createElementBlock as u, createElementVNode as d, createSlots as f, createVNode as p, defineComponent as m, guardReactiveProps as h, mergeDefaults as g, mergeProps as _, normalizeProps as v, openBlock as y, renderList as b, renderSlot as x, unref as S, useTemplateRef as C, withCtx as w } from "vue";

package/chunks/{page-list-DMDDWHTe.mjs → page-list-DUYDkWcj.mjs}

@@ -6,7 +6,7 @@ import { t as a } from "./card-Domqu1Hz.mjs";
 import "../components/card/index.mjs";
 import { t as o } from "./page-table-C1hMMXID.mjs";
 import "../components/page-table/index.mjs";
-import { t as s } from "./page-query-CRbcQbQW.mjs";
+import { t as s } from "./page-query-oFiHpSCX.mjs";
 import "../components/page-query/index.mjs";
 import { Fragment as c, computed as l, createBlock as u, createCommentVNode as d, createElementBlock as f, createSlots as p, createVNode as m, defineComponent as h, guardReactiveProps as g, mergeDefaults as _, mergeProps as v, nextTick as y, normalizeProps as b, openBlock as x, ref as S, renderList as C, renderSlot as w, unref as T, useTemplateRef as E, withCtx as D } from "vue";
 import { cloneDeep as O } from "lodash-es";
@@ -16,13 +16,13 @@ var A = { isFirstQueryByParent: !1 };
 function j({ pageQueryRef: t, pageTableRef: n, props: r, route: a }) {
 	let o = S({});
 	function s() {
-		t.value === null ? (o.value = {}, n.value.query(!0)) : t.value.query();
+		t.value === null ? (o.value = {}, n.value.query()) : t.value.query();
 	}
 	function c() {
 		t.value === null ? (o.value = {}, n.value.reset()) : t.value.reset();
 	}
-	function u(e) {
-		o.value = O(e), n.value.query(!0);
+	function u(e, t) {
+		o.value = O(e), n.value.query(t);
 	}
 	function d(e) {
 		o.value = O(e), n.value.reset();

package/chunks/{page-query-CRbcQbQW.mjs → page-query-oFiHpSCX.mjs}

@@ -62,12 +62,15 @@ var D = /* @__PURE__ */ l({
 		}
 		S([N, () => A.value.length], I);
 		function L() {
-			O("query", k.value);
+			O("query", k.value, !1);
 		}
 		function R() {
-			z(), O("reset", k.value);
+			O("query", k.value, !0);
 		}
 		function z() {
+			B(), O("reset", k.value);
+		}
+		function B() {
 			Object.keys(k.value).forEach((e) => {
 				if (Object.hasOwn(D.data, e)) {
 					k.value[e] = D.data[e];
@@ -79,8 +82,8 @@ var D = /* @__PURE__ */ l({
 		return l({
 			formData: k,
 			query: L,
-			reset: R,
-			resetFormData: z
+			reset: z,
+			resetFormData: B
 		}), (e, r) => (h(), i(b(n), f({
 			ref_key: "formRef",
 			ref: M,
@@ -90,7 +93,7 @@ var D = /* @__PURE__ */ l({
 			_btn: C(() => [
 				c(b(t), {
 					class: "shrink",
-					onClick: L
+					onClick: R
 				}, {
 					default: C(() => [...r[1] ||= [s("查询", -1)]]),
 					_: 1
@@ -98,7 +101,7 @@ var D = /* @__PURE__ */ l({
 				c(b(t), {
 					class: "shrink",
 					theme: "default",
-					onClick: R
+					onClick: z
 				}, {
 					default: C(() => [...r[2] ||= [s("重置", -1)]]),
 					_: 1

package/components/custom-page-list/index.mjs

@@ -1,2 +1,2 @@
-import { t as e } from "../../chunks/custom-page-list-DNONwY-V.mjs";
+import { t as e } from "../../chunks/custom-page-list-Dkjf1nLR.mjs";
 export { e as TCustomPageList };

package/components/custom-page-list/src/custom-page-list.mjs

@@ -1,2 +1,2 @@
-import { t as e } from "../../../chunks/custom-page-list-DNONwY-V.mjs";
+import { t as e } from "../../../chunks/custom-page-list-Dkjf1nLR.mjs";
 export { e as default };

package/components/index.mjs

@@ -45,11 +45,11 @@ import "./table/index.mjs";
 import "./page-table/index.mjs";
 import { t as Z } from "../chunks/custom-page-table-y7emjJnS.mjs";
 import "./custom-page-table/index.mjs";
-import { n as Q, r as $, t as ee } from "../chunks/page-list-DMDDWHTe.mjs";
-import { t as te } from "../chunks/page-query-CRbcQbQW.mjs";
+import { n as Q, r as $, t as ee } from "../chunks/page-list-DUYDkWcj.mjs";
+import { t as te } from "../chunks/page-query-oFiHpSCX.mjs";
 import "./page-query/index.mjs";
 import "./page-list/index.mjs";
-import { t as ne } from "../chunks/custom-page-list-DNONwY-V.mjs";
+import { t as ne } from "../chunks/custom-page-list-Dkjf1nLR.mjs";
 import "./custom-page-list/index.mjs";
 import { t as re } from "../chunks/overview-BvLGalk-.mjs";
 import { t as ie } from "../chunks/overview-YqvRmr0O.mjs";

package/components/page-list/index.mjs

@@ -1,2 +1,2 @@
-import { n as e, r as t, t as n } from "../../chunks/page-list-DMDDWHTe.mjs";
+import { n as e, r as t, t as n } from "../../chunks/page-list-DUYDkWcj.mjs";
 export { n as TPageList, e as baseCustomPageListPropsInit, t as useBaseCustomPageListMixin };

package/components/page-list/src/page-list.d.ts

@@ -1411,7 +1411,7 @@ export declare function useBaseCustomPageListMixin({ pageQueryRef, pageTableRef,
         _help?: string | ((h: typeof import('vue').h) => import('tdesign-vue-next').TNodeReturnValue) | undefined;
     })[]>;
     finallyQueryParams: import('vue').ComputedRef<Record<string, any> | undefined>;
-    onQuery: (formData: Record<string, any>) => void;
+    onQuery: (formData: Record<string, any>, isClick: boolean) => void;
     onReset: (formData: Record<string, any>) => void;
     queryParams: Ref<Record<string, any>, Record<string, any>>;
     resetCurrentQueryParams: () => void;

package/components/page-list/src/page-list.mjs

@@ -1,2 +1,2 @@
-import { t as e } from "../../../chunks/page-list-DMDDWHTe.mjs";
+import { t as e } from "../../../chunks/page-list-DUYDkWcj.mjs";
 export { e as default };

package/components/page-query/index.mjs

@@ -1,2 +1,2 @@
-import { t as e } from "../../chunks/page-query-CRbcQbQW.mjs";
+import { t as e } from "../../chunks/page-query-oFiHpSCX.mjs";
 export { e as TPageQuery };

package/components/page-query/src/page-query.mjs

@@ -1,2 +1,2 @@
-import { t as e } from "../../../chunks/page-query-CRbcQbQW.mjs";
+import { t as e } from "../../../chunks/page-query-oFiHpSCX.mjs";
 export { e as default };

package/components/page-query/src/page-query.vue.d.ts

@@ -13,10 +13,10 @@ declare const __VLS_base: import('vue').DefineComponent<FormProps, {
     resetFormData: typeof resetFormData;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     reset: (formData: Record<string, any>) => any;
-    query: (formData: Record<string, any>) => any;
+    query: (formData: Record<string, any>, isClick: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<FormProps> & Readonly<{
     onReset?: ((formData: Record<string, any>) => any) | undefined;
-    onQuery?: ((formData: Record<string, any>) => any) | undefined;
+    onQuery?: ((formData: Record<string, any>, isClick: boolean) => any) | undefined;
 }>, {
     data: import('../../form').FormPropsData;
     disabled: boolean;

package/components/select-sys-user/src/Picker.mjs

@@ -1,5 +1,5 @@
 import { S as e } from "../../../chunks/provider-BhFm5rvy.mjs";
-import { t } from "../../../chunks/page-list-DMDDWHTe.mjs";
+import { t } from "../../../chunks/page-list-DUYDkWcj.mjs";
 import "../../page-list/index.mjs";
 import { createBlock as n, createSlots as r, createVNode as i, defineComponent as a, mergeProps as o, openBlock as s, unref as c, useTemplateRef as l, withCtx as u } from "vue";
 import { Alert as d } from "tdesign-vue-next";

package/package.json

@@ -108,7 +108,7 @@
     "> 1%",
     "not dead"
   ],
-  "version": "2.0.26",
+  "version": "2.0.28",
   "scripts": {
     "dev": "vite --config play/vite.config.ts"
   }

package/proj-template/.cursor/skills/refactor-page-list/SKILL.md

@@ -0,0 +1,314 @@
+---
+name: refactor-page-list
+description: >-
+  将 yq-monitor-front 的 CPageList 列表页重构到 qc-ui 的 TPageList 模式。
+  用于页面迁移、列表页重构、CPageList 转 TPageList、yq-monitor-front 到 qc-ui 的 views 迁移。
+---
+
+# PageList 页面重构（yq-monitor-front → qc-ui）
+
+## 项目约定
+
+| 角色 | 路径 | 说明 |
+|------|------|------|
+| 原项目 | `e:\code\yq-monitor-front` | 业务行为基准，不做重构性改动 |
+| 目标项目 | `e:\code\qc-ui` | 迁移落地目录，保持 `src/views/...` 路径一致 |
+
+路由由后端菜单驱动，组件路径如 `system/config/index` 映射到 `qc-ui/src/views/system/config/index.vue`（`src/views/index.ts` glob），**无需手动注册路由**。
+
+## 实现方式选择
+
+迁移前先确认实现位置：
+
+| 场景 | 做法 | 参考 |
+|------|------|------|
+| 通用系统模块（user/role/dict/post）且 dlzn-ui 已有 | qc-ui 薄封装，引用 `dlzn-ui/views/system/...` | `src/views/system/user/index.vue` |
+| 通用系统模块但 dlzn-ui 尚无 | 在 qc-ui 内完整实现（默认） | `src/views/system/config/index.vue` |
+| 舆情业务页（yq/* API） | 在 qc-ui 内完整实现 | `src/views/system/wbTaskCfg/index.vue` |
+
+用户未指定时，**默认在 qc-ui 内完整实现**。
+
+## 迁移工作流
+
+```
+Task Progress:
+- [ ] 1. 读取原项目页面及 modules/PageListItemForm.vue（如有）
+- [ ] 2. 读取原项目 `@/api/*.ts` 中**每个**接口的 `method`（未写则默认为 `get`，见 yq-monitor-front `$api`）
+- [ ] 3. 在 qc-ui 同路径创建 index.vue
+- [ ] 4. 按映射表转换配置
+- [ ] 5. 内联新增/编辑表单（不迁移 PageListItemForm）
+- [ ] 6. 对**本次修改的文件**执行 `pnpm eslint <路径>` 与 `pnpm vue-tsc --noEmit`，确认无 ESLint/TS 报错后再结束
+```
+
+### Step 1：分析原页面
+
+原项目典型结构：
+
+- `CPageList` + `config.urls`（list/delete/export）
+- `config.formItems` + `config.columns`（vxe-table 字段名 `field`）
+- `config.btns` 自定义操作
+- `modules/PageListItemForm.vue` 负责新增/编辑
+
+### Step 2：建立 formItemMap
+
+将所有表单字段（筛选 + 弹窗）集中到 `formItemMap`：
+
+```typescript
+const formItemMap = {
+  fieldName: {
+    _label: '标签',
+    _required: true,           // 弹窗必填
+    component: 'TInput',       // 见组件映射表
+    model: 'fieldName',
+    dicCode: 'dict_code',      // 字典字段
+  },
+  dateRange: {
+    _class: 'col-span-2',  // 仅用于 TPageList 筛选区；vertical TForm 不加
+    _label: '创建时间',
+    component: 'TDatePicker',
+    model: 'dateRange',
+    type: 'daterange',
+  },
+} satisfies Record<string, FormItem>
+```
+
+筛选用 `TSelect`，弹窗用 `TRadioGroup` 时，通过展开覆盖 component：
+
+`formItemMap` 若同时用于筛选区和 vertical 弹窗，详情专用字段不要带 `_class: 'col-span-2'`；或弹窗 items 里单独定义不带 `_class` 的项。
+
+```typescript
+formItems: [{ ...formItemMap.status, component: 'TSelect' }]
+// 弹窗内: { ...formItemMap.status, component: 'TRadioGroup' }
+```
+
+### Step 3：配置 PageListProps
+
+```typescript
+const pageListRef = useTemplateRef('pageListRef')
+const config: PageListProps = {
+  apis: { /* 见 API 映射 */ },
+  columns: [ /* 见列映射 */ ],
+  formItems: [ /* 筛选项 */ ],
+  operations: [ /* 新增、刷新缓存等 */ ],
+  tableOtherProps: { rowKey: '主键字段' },
+}
+```
+
+### Step 4：内联新增/编辑
+
+**不要**迁移 `PageListItemForm.vue`，改用 `$confirm` + `h(TForm, ...)`：
+
+```typescript
+// 编辑
+const formRef = ref<FormInstance | null>(null)
+watch(formRef, () => { formRef.value!.setFormData(row) }, { once: true })
+$confirm({
+  body: () => h(TForm, { items: [...], labelAlign: 'right', layout: 'vertical', ref: formRef }),
+  header: '修改xxx',
+  width: 460,
+  onConfirmCallback: async () => {
+    await $alova.Put('module/path', { ...(await formRef.value!.validate()), id: row.id })
+    $msg.success('修改成功')
+    pageListRef.value!.query()
+  },
+})
+
+// 新增
+$confirm({
+  body: () => h(TForm, {
+    data: reactive({ status: '0' }),  // 默认值
+    items: [...],
+    ref: formRef,
+  }),
+  onConfirmCallback: async () => {
+    await $alova.Post('module/path', await formRef.value!.validate())
+    $msg.success('添加成功')
+    pageListRef.value!.query()
+  },
+})
+```
+
+### Step 5：模板
+
+```vue
+<template>
+  <TPageList ref="pageListRef" v-bind="config"></TPageList>
+</template>
+```
+
+## 映射表
+
+### 组件映射
+
+| 原项目 (C*) | 目标项目 (T*) | 说明 |
+|-------------|---------------|------|
+| `CInput` / 默认 | `TInput` | 文本 |
+| `CSelect` | `TSelect` | 筛选下拉 |
+| `CRadio` | `TRadioGroup` | 弹窗单选 |
+| `CDate` type=daterange | `TDatePicker` type=daterange | 筛选表单加 `_class: 'col-span-2'`；`layout: 'vertical'` 的 TForm 不加 |
+| textarea | `TTextarea` | 备注 |
+| append slot | `adornment: { append: () => '单位' }` | TInput 后缀须用函数形式 |
+| `c:dicLabel` | `{ component: 'DicLabel', dicCode }` | 表格字典列 |
+| `c:btns` | `{ component: 'Buttons', buttons: [...] }` | 操作列 |
+
+### API 映射
+
+**迁移前必查原项目 api 定义**（`yq-monitor-front/src/api/system.ts` 或 `monitor.ts` 等）。原项目 `$api` 默认 `method = 'get'`，**未显式声明 method 的接口一律是 GET**，不能凭语义猜测（如 unlock 不是 DELETE）。
+
+| 原 apiConfig | 目标调用 |
+|--------------|----------|
+| 无 `method` 或 `method` 省略 | `$alova.Get('...')` |
+| `url: 'system/xxx/list'` | `apis.list.method: 'system/xxx/list'` 或 `$alova.Get` |
+| `method: 'post'` | `$alova.Post('...', data)` |
+| `method: 'put'` | `$alova.Put('...', data)` |
+| `method: 'delete'` + `{id}` | `$alova.Delete('...')` 或 `apis.delete.method`（TPageList 自动拼接 id） |
+| `responseType: 'blob'` 导出 | `apis.export.method: '.../export'`（POST） |
+| `refreshCache` 且原定义为 delete | `$alova.Delete('.../refreshCache', ...)` |
+| `unlock/{userName}` 且无 method | `$alova.Get('monitor/logininfor/unlock/${userName}', ...)` |
+
+路径占位符 `{userName}`、`{id}` 在目标项目中通常拼进 URL 字符串，如 `` `monitor/logininfor/unlock/${row.userName}` ``。
+
+**`$alova` 参数个数**（勿与 axios 混用；写完后对照项目内已有调用）：
+
+| 方法 | 签名 | 仅 meta / params 时 |
+|------|------|---------------------|
+| `Get` | `(url, config?)` | `$alova.Get(url, { meta: { useSuccessMsg: true } })` |
+| `Post` | `(url, data?, config?)` | 无 body 时第二参可省略 |
+| `Put` | `(url, data?, config?)` | |
+| `Delete` | `(url, data?, config?)` | 无 body 时用 `$alova.Delete(url, undefined, { meta })` |
+
+`Get` **只有两个参数**，不要把 `undefined` 插在中间；`params` 与 `meta` 同放在第二个 config 对象里。
+
+**dateRange 参数转换**（list 与 export 共用 finallyQueryParams；`dateRange` 恒为数组，空数组时 `[0]`/`[1]` 为 `undefined` 可直接传递）：
+
+```typescript
+list: {
+  method: (o: Record<string, any>) =>
+    $alova.Get('system/xxx/list', {
+      params: {
+        ...o,
+        dateRange: undefined,
+        'params[beginTime]': o.dateRange[0],
+        'params[endTime]': o.dateRange[1],
+      },
+    }),
+},
+```
+
+**批量删除**：原 `handleParams` 拼接 id → 目标设置 `showBatch: true` + `tableOtherProps.rowKey`。
+
+### 列映射
+
+| 原 columns | 目标 columns |
+|------------|--------------|
+| `field: 'xxx'` | `colKey: 'xxx'` |
+| `title: 'xxx'` | `title: 'xxx'`（不变） |
+| `type: 'checkbox'` | 由 `apis.delete.showBatch: true` 自动处理 |
+| `field: 'c-action'` | `colKey: '_operation'` |
+| 删除按钮 | 由 TPageList 根据 `apis.delete` 自动追加 |
+| `field: 'remark'` / `title: '备注'` | 加 `resize: { maxWidth: 300 }`（内容可能很长） |
+
+### 权限
+
+原 `permission` 字段**原样保留**，如 `system:config:add/edit/remove/export`。
+
+### 即时请求操作需 popconfirm
+
+`operations` 中点击即发请求的操作（刷新缓存、同步、重置等），**必须**用 `popconfirm` 二次确认，不用 `onClick` 直接请求：
+
+```typescript
+{
+  default: '刷新缓存',
+  permission: 'system:config:remove',
+  popconfirm: {
+    content: '确定要刷新缓存吗？',
+    onConfirm: async () => {
+      await $alova.Delete('system/config/refreshCache', undefined, {
+        meta: { useSuccessMsg: true },
+      })
+    },
+  },
+}
+```
+
+新增/编辑等打开弹窗的操作不需要 popconfirm。
+
+### 只读详情弹窗（$dialog）
+
+原项目用旧式 `$dialog({ title, showCancel: false, confirmText: '关闭' }, Component)` 展示只读详情时，目标项目**直接用 `h(TForm, ...)` 内联**，与 `formItemMap` 共用，**不单独建 `modules/Detail.vue`**：
+
+```typescript
+onClick: () => {
+  const formRef = ref<FormInstance | null>(null)
+
+  watch(formRef, () => {
+    formRef.value!.setFormData(row, {
+      override: {
+        loginInfo: `${row.operName}/${row.operIp}/${row.operLocation}`,
+      },
+    })
+  }, { once: true })
+
+  $dialog({
+    body: () =>
+      h(TForm, {
+        items: [formItemMap.title, formItemMap.businessType, /* ... */],
+        labelAlign: 'right',
+        layout: 'vertical',
+        readonly: true,
+        ref: formRef,
+      }),
+    cancelBtn: '关闭',
+    confirmBtn: null,
+    header: '操作日志详细',
+    width: 700,
+  })
+}
+```
+
+- 用 `cancelBtn: '关闭'` + `confirmBtn: null` 实现仅关闭按钮，**不要用** `footer: false`
+- 详情字段并入 `formItemMap`，筛选与详情共用；用 `setFormData(row)` 赋值，字段转换走 `override`，避免手写 `row.xxx`（Select 等组件内部已处理 number/string，无需 `numberToStringKeys`）
+- `items` 直接内联，无复用时不在函数体内单独声明变量
+- `layout: 'vertical'` 的 TForm 不是 grid 布局，其 `items` 上**不要**写 `_class: 'col-span-2'`（筛选区 inline 表单仍可用）
+- 对应原项目 `showCancel: false` + `confirmText: '关闭'`
+
+### 字典
+
+| 原项目 | 目标项目 |
+|--------|----------|
+| `$dicStore('sys_yes_no')` | `dicCode: 'sys_yes_no'` |
+
+## 不在迁移范围
+
+- 不修改 yq-monitor-front
+- 不创建 `modules/PageListItemForm.vue`
+- 不新增 `src/api/*.ts`（qc-ui 无独立 API 层）
+- 不修改 `folder-alias.json`（通常已有描述）
+- 不遗留调试代码（如 `console.log`）
+
+## 参考文件
+
+| 用途 | 路径 |
+|------|------|
+| 迁移成果示例 | `qc-ui/src/views/system/config/index.vue` |
+| 原项目示例 | `yq-monitor-front/src/views/system/config/index.vue` |
+| 业务页参考 | `qc-ui/src/views/system/wbTaskCfg/index.vue` |
+| 系统页参考（dlzn-ui） | `dlzn-ui/packages/dlzn-ui/views/system/post/index.vue` |
+| 含 dateRange + 刷新缓存 | `dlzn-ui/packages/dlzn-ui/views/system/dict/index.vue` |
+| 只读详情弹窗 | `qc-ui/src/views/monitor/operlog/index.vue` |
+
+更多 before/after 片段见 [examples.md](examples.md)。
+
+## 验证清单
+
+- [ ] 路径与原项目一致（`src/views/.../index.vue`）
+- [ ] 筛选、分页列表正常
+- [ ] 新增、编辑、单删、批量删、导出
+- [ ] 自定义 operations（如刷新缓存）
+- [ ] 权限码与后端一致
+- [ ] 每个非 CRUD 操作（unlock、clean、refreshCache 等）的 HTTP 方法已与原 `@/api` 定义逐项核对
+- [ ] 无路由组件缺失报错
+- [ ] 修改文件 ESLint 通过（`pnpm eslint <文件路径>`）
+- [ ] 修改文件 TS 通过（`pnpm vue-tsc --noEmit`，或至少无本次文件相关报错）
+- [ ] `$alova.Get` 仅两参；带 meta 时写在第二参 config 对象内
+- [ ] `formItemMap` 使用 `satisfies Record<string, FormItem>`；条件显示用 `__others`