create-bubbles 0.1.24 → 0.1.26

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/request/index.ts

@@ -2,8 +2,8 @@ import { axiosRequestAdapter, type AlovaAxiosRequestConfig } from '@alova/adapte
 import reactHook, { type ReactHookExportType } from 'alova/react'
 import { message } from 'antd'
 import type { AxiosResponse, AxiosResponseHeaders } from 'axios'
-import { navigator } from '@/router'
 import { envVariables } from '@/utils/env'
+import { cookie } from '@/utils/storage/cookie'
 import { createDualCallInstance, type BaseRequestOption } from './core/index.ts'
 
 type WebRequestOption = BaseRequestOption<
@@ -25,8 +25,8 @@ function normalizeBaseUrl(apiAffix?: string) {
 function getBaseConfig(): WebRequestOption {
   return {
     baseUrl: normalizeBaseUrl(envVariables.API_AFFIX),
+    isWrapped: false,
     statusMap: {
-      success: [200, 201, 204],
       unAuthorized: 401,
     },
     codeMap: {
@@ -34,8 +34,12 @@ function getBaseConfig(): WebRequestOption {
       unAuthorized: [401],
     },
     responseDataKey: 'data',
-    responseMessageKey: 'msg',
-    commonHeaders: () => ({}),
+    responseMessageKey: 'message',
+    errorDefaultMessage: '请求失败，请稍后重试',
+    commonHeaders: () => {
+      const token = cookie.get('token')
+      return token ? { Authorization: `Bearer ${token}` } : {}
+    },
     successMessageFunc: (msg) => {
       message.success(msg)
     },
@@ -43,8 +47,9 @@ function getBaseConfig(): WebRequestOption {
       message.error(msg)
     },
     unAuthorizedResponseFunc: () => {
-      void navigator('/login')
+      cookie.remove('token')
       message.error('登录过期或未登录')
+      window.location.assign('/login')
     },
     statesHook: reactHook,
     requestAdapter: axiosRequestAdapter(),

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/storage/cookie.ts

@@ -0,0 +1,50 @@
+export interface CookieOptions {
+  path?: string
+  domain?: string
+  expires?: Date
+  /** 有效期，单位为秒；优先于 expires。 */
+  maxAge?: number
+  secure?: boolean
+  sameSite?: 'Strict' | 'Lax' | 'None'
+}
+
+export const cookie = {
+  get(key: string): string | null {
+    const prefix = `${encodeURIComponent(key)}=`
+    const entry = document.cookie.split(';').find((item) => item.trim().startsWith(prefix))
+    if (entry === undefined) return null
+
+    const value = entry.trim().slice(prefix.length)
+    try {
+      return decodeURIComponent(value)
+    } catch {
+      return value
+    }
+  },
+
+  /** 同名 Cookie 在相同 path、domain 下写入即为更新。 */
+  set(key: string, value: string, options: CookieOptions = {}): void {
+    const { path = '/', domain, expires, maxAge, sameSite = 'Lax' } = options
+    const secure = options.secure ?? window.location.protocol === 'https:'
+    const attributes = [
+      `${encodeURIComponent(key)}=${encodeURIComponent(value)}`,
+      `Path=${path}`,
+      `SameSite=${sameSite}`,
+    ]
+
+    if (domain) attributes.push(`Domain=${domain}`)
+    if (expires) attributes.push(`Expires=${expires.toUTCString()}`)
+    if (maxAge !== undefined) attributes.push(`Max-Age=${Math.trunc(maxAge)}`)
+    if (secure) attributes.push('Secure')
+
+    document.cookie = attributes.join('; ')
+  },
+
+  /** 删除时的 path、domain 必须与写入时一致。 */
+  remove(
+    key: string,
+    options: Pick<CookieOptions, 'path' | 'domain' | 'secure' | 'sameSite'> = {},
+  ): void {
+    cookie.set(key, '', { ...options, maxAge: 0, expires: new Date(0) })
+  },
+}

package/template-vp-monorepo-react-nestjs/apps/web/src/utils/storage/session.ts

@@ -0,0 +1,33 @@
+function createStorage(type: 'localStorage' | 'sessionStorage') {
+  return {
+    /** 自动序列化为 JSON；同名写入即为更新。 */
+    set<T>(key: string, value: T): void {
+      const serialized = JSON.stringify(value)
+      if (serialized === undefined) throw new TypeError('存储值必须能够序列化为 JSON')
+      window[type].setItem(key, serialized)
+    },
+
+    /** 不存在或内容不是有效 JSON 时返回 null。 */
+    get<T = unknown>(key: string): T | null {
+      const value = window[type].getItem(key)
+      if (value === null) return null
+
+      try {
+        return JSON.parse(value) as T
+      } catch {
+        return null
+      }
+    },
+
+    remove(key: string): void {
+      window[type].removeItem(key)
+    },
+
+    clear(): void {
+      window[type].clear()
+    },
+  }
+}
+
+export const local = createStorage('localStorage')
+export const session = createStorage('sessionStorage')

package/template-vp-monorepo-react-nestjs/apps/web/test/draft-projects.spec.ts

@@ -0,0 +1,89 @@
+import { describe, expect, it } from 'vite-plus/test'
+import {
+  currentUser,
+  initialRecords,
+  type DraftProjectRecord,
+} from '../src/pages/examples/pro-table/draft/config'
+import {
+  filterProjectRecords,
+  saveProjectRecord,
+} from '../src/pages/examples/pro-table/draft/config/projects'
+
+describe('项目草稿演示', () => {
+  it('允许保存未填完的草稿，并与正式项目分开显示', () => {
+    const records = saveProjectRecord(initialRecords, {
+      values: { name: '  测试草稿  ' },
+      stage: 'draft',
+    })
+    const drafts = filterProjectRecords({ records, view: 'draft', search: {} })
+    expect(drafts).toHaveLength(4)
+    expect(drafts.find((record) => record.name === '测试草稿')).toMatchObject({
+      stage: 'draft',
+      createdBy: currentUser,
+    })
+    expect(drafts.find((record) => record.name === '测试草稿')?.owner).toBeUndefined()
+    expect(filterProjectRecords({ records, view: 'list', search: {} })).toHaveLength(18)
+  })
+
+  it('继续保存同一草稿不会产生重复记录，提交后保留编号并移入正式列表', () => {
+    const original = initialRecords.find((record) => record.id === 'PRJ-019')!
+    const saved = saveProjectRecord(initialRecords, {
+      original,
+      values: { name: '继续完善' },
+      stage: 'draft',
+    })
+    const updated = saved.find((record) => record.id === original.id)!
+    expect(saved).toHaveLength(initialRecords.length)
+    const submitted = saveProjectRecord(saved, {
+      original: updated,
+      values: {
+        name: '已完成项目',
+        owner: currentUser,
+        status: 'completed',
+        priority: 'medium',
+        progress: 75,
+        dueDate: '2026-10-01',
+        description: '',
+      },
+      stage: 'published',
+    })
+    expect(submitted.filter((record) => record.id === original.id)).toHaveLength(1)
+    expect(submitted.find((record) => record.id === original.id)).toMatchObject({
+      stage: 'published',
+      progress: 100,
+    })
+    expect(filterProjectRecords({ records: submitted, view: 'draft', search: {} })).toHaveLength(2)
+    expect(filterProjectRecords({ records: submitted, view: 'list', search: {} })).toHaveLength(19)
+  })
+
+  it('草稿可见性取决于创建人，负责人筛选不能显示其他人的草稿', () => {
+    const otherDraft: DraftProjectRecord = {
+      id: 'PRJ-099',
+      name: '其他人的草稿',
+      stage: 'draft',
+      createdBy: '其他人',
+      owner: currentUser,
+      savedAt: new Date().toISOString(),
+    }
+    const records = [...initialRecords, otherDraft]
+    expect(
+      filterProjectRecords({ records, view: 'draft', search: { owner: currentUser } }),
+    ).toHaveLength(3)
+    expect(
+      filterProjectRecords({ records, view: 'list', search: { name: 'PRJ-099' } }),
+    ).toHaveLength(0)
+  })
+
+  it('未填写业务状态的草稿仍可按编号搜索，状态筛选不把它当作待启动', () => {
+    expect(
+      filterProjectRecords({ records: initialRecords, view: 'draft', search: { name: 'prj-020' } }),
+    ).toHaveLength(1)
+    expect(
+      filterProjectRecords({
+        records: initialRecords,
+        view: 'draft',
+        search: { status: 'planning' },
+      }),
+    ).toHaveLength(2)
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/request.spec.ts

@@ -0,0 +1,145 @@
+import { createServer, type Server } from 'node:http'
+import type { AddressInfo } from 'node:net'
+import { axiosRequestAdapter } from '@alova/adapter-axios'
+import { afterAll, beforeAll, describe, expect, it, vi } from 'vite-plus/test'
+import { createInstance } from '../src/utils/request/core'
+
+let server: Server
+let baseUrl: string
+
+beforeAll(async () => {
+  server = createServer((req, res) => {
+    res.setHeader('Content-Type', 'application/json')
+    if (req.url === '/credentials') {
+      res
+        .writeHead(422)
+        .end(JSON.stringify({ code: 'AUTH.INVALID_CREDENTIALS', message: '账号或密码错误' }))
+    } else if (req.url === '/expired') {
+      res
+        .writeHead(401)
+        .end(JSON.stringify({ code: 'AUTH.SESSION_INVALID', message: '登录已失效，请重新登录' }))
+    } else if (req.url === '/unavailable') {
+      res.writeHead(503).end(
+        JSON.stringify({
+          code: 'AUTH.SERVICE_UNAVAILABLE',
+          message: '登录服务暂时不可用，请稍后重试',
+        }),
+      )
+    } else if (req.url === '/wrapped') {
+      res.end(JSON.stringify({ code: 200, data: { id: 'test-user' } }))
+    } else if (req.url?.startsWith('/http-status/')) {
+      const status = Number(req.url.split('/').at(-1))
+      res.writeHead(status).end(status === 204 ? undefined : JSON.stringify({ status }))
+    } else if (req.url?.startsWith('/wrapped-error/')) {
+      const code = Number(req.url.split('/').at(-1))
+      res.end(JSON.stringify({ code, message: '业务处理失败' }))
+    } else {
+      res.end(JSON.stringify({ id: 'test-user', authorization: req.headers.authorization }))
+    }
+  })
+  await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
+  baseUrl = `http://127.0.0.1:${(server.address() as AddressInfo).port}`
+})
+
+afterAll(
+  () =>
+    new Promise<void>((resolve, reject) =>
+      server.close((error) => (error ? reject(error) : resolve())),
+    ),
+)
+
+function setup() {
+  const unauthorized = vi.fn()
+  const errorMessage = vi.fn()
+  const request = createInstance({
+    baseUrl,
+    isWrapped: false,
+    requestAdapter: axiosRequestAdapter(),
+    commonHeaders: () => ({ Authorization: 'Bearer test-session' }),
+    unAuthorizedResponseFunc: unauthorized,
+    errorMessageFunc: errorMessage,
+  })
+  return { request, unauthorized, errorMessage }
+}
+
+describe('NestJS 响应适配', () => {
+  it('读取未包装的数据，并携带 Bearer 令牌', async () => {
+    const { request } = setup()
+    expect(await request.Get('/me')).toEqual({
+      id: 'test-user',
+      authorization: 'Bearer test-session',
+    })
+    expect(await request.Get('/wrapped', { meta: { isWrapped: true } })).toEqual({
+      id: 'test-user',
+    })
+  })
+
+  it('Axios 的 422 走统一错误解析，保留错误码和公开文案', async () => {
+    const { request, unauthorized, errorMessage } = setup()
+    await expect(request.Post('/credentials').send()).rejects.toMatchObject({
+      status: 422,
+      code: 'AUTH.INVALID_CREDENTIALS',
+      message: '账号或密码错误',
+    })
+    expect(errorMessage).toHaveBeenCalledExactlyOnceWith('账号或密码错误')
+    expect(unauthorized).not.toHaveBeenCalled()
+  })
+
+  it.each([201, 202, 204, 206])('HTTP %i 按 Axios 的 2xx 规则返回成功', async (status) => {
+    const { request, unauthorized, errorMessage } = setup()
+    await expect(request.Get(`/http-status/${status}`).send()).resolves.toEqual(
+      status === 204 ? '' : { status },
+    )
+    expect(errorMessage).not.toHaveBeenCalled()
+    expect(unauthorized).not.toHaveBeenCalled()
+  })
+
+  it('默认适配器的 HTTP 401 也走统一错误处理', async () => {
+    const unauthorized = vi.fn()
+    const errorMessage = vi.fn()
+    const request = createInstance({
+      baseUrl,
+      isWrapped: false,
+      unAuthorizedResponseFunc: unauthorized,
+      errorMessageFunc: errorMessage,
+    })
+
+    await expect(request.Get('/expired').send()).rejects.toMatchObject({
+      status: 401,
+      code: 'AUTH.SESSION_INVALID',
+      message: '登录已失效，请重新登录',
+    })
+    expect(unauthorized).toHaveBeenCalledOnce()
+    expect(errorMessage).toHaveBeenCalledExactlyOnceWith('登录已失效，请重新登录')
+  })
+
+  it.each([401, 422])('HTTP 200 下的业务错误 %i 仍会拒绝且只提示一次', async (code) => {
+    const { request, unauthorized, errorMessage } = setup()
+    await expect(
+      request.Get(`/wrapped-error/${code}`, { meta: { isWrapped: true } }).send(),
+    ).rejects.toMatchObject({ status: 200, code, message: '业务处理失败' })
+    expect(errorMessage).toHaveBeenCalledExactlyOnceWith('业务处理失败')
+    expect(unauthorized).toHaveBeenCalledTimes(code === 401 ? 1 : 0)
+  })
+
+  it('页面关闭全局提示后，401 仍触发会话失效回调', async () => {
+    const { request, unauthorized, errorMessage } = setup()
+    await expect(
+      request.Get('/expired', { meta: { isShowErrorMessage: false } }).send(),
+    ).rejects.toMatchObject({ status: 401 })
+    expect(unauthorized).toHaveBeenCalledOnce()
+    expect(unauthorized.mock.calls[0]?.[0].config.headers.get('Authorization')).toBe(
+      'Bearer test-session',
+    )
+    expect(errorMessage).not.toHaveBeenCalled()
+  })
+
+  it('服务暂不可用时保留会话，不当成 401 注销用户', async () => {
+    const { request, unauthorized } = setup()
+    await expect(request.Get('/unavailable').send()).rejects.toMatchObject({
+      status: 503,
+      message: '登录服务暂时不可用，请稍后重试',
+    })
+    expect(unauthorized).not.toHaveBeenCalled()
+  })
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/storage.spec.ts

@@ -0,0 +1,108 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vite-plus/test'
+import { cookie } from '../src/utils/storage/cookie'
+import { local, session } from '../src/utils/storage/session'
+
+function createMemoryStorage() {
+  const values = new Map<string, string>()
+  return {
+    getItem: (key: string) => values.get(key) ?? null,
+    setItem: (key: string, value: string) => values.set(key, value),
+    removeItem: (key: string) => values.delete(key),
+    clear: () => values.clear(),
+  }
+}
+
+beforeEach(() => {
+  vi.stubGlobal('window', {
+    location: { protocol: 'https:' },
+    localStorage: createMemoryStorage(),
+    sessionStorage: createMemoryStorage(),
+  })
+  vi.stubGlobal('document', { cookie: '' })
+})
+
+afterEach(() => vi.unstubAllGlobals())
+
+describe('Cookie', () => {
+  it('准确区分名称，并解码包含中文、分隔符的值', () => {
+    document.cookie = 'token-old=wrong; token=%E4%B8%AD%E6%96%87%3B%3D%25; empty='
+    expect(cookie.get('token')).toBe('中文;=%')
+    expect(cookie.get('empty')).toBe('')
+    expect(cookie.get('missing')).toBeNull()
+  })
+
+  it('名称和值均编码，HTTPS 默认启用 Secure 并作用于整个站点', () => {
+    cookie.set('偏好', '中文;=')
+    expect(document.cookie).toBe(
+      '%E5%81%8F%E5%A5%BD=%E4%B8%AD%E6%96%87%3B%3D; Path=/; SameSite=Lax; Secure',
+    )
+    expect(cookie.get('偏好')).toBe('中文;=')
+  })
+
+  it('HTTP 开发环境可写入 Cookie，支持设置过期时间', () => {
+    window.location.protocol = 'http:'
+    const expires = new Date('2030-01-01T00:00:00Z')
+    cookie.set('token', 'value', { expires })
+    expect(document.cookie).toContain(`Expires=${expires.toUTCString()}`)
+    expect(document.cookie).not.toContain('Secure')
+  })
+
+  it('删除时覆盖原作用域，并同时设置立即过期时间和 Max-Age', () => {
+    cookie.remove('token', { path: '/workspace', domain: 'example.test' })
+    expect(document.cookie).toContain('token=;')
+    expect(document.cookie).toContain('Path=/workspace')
+    expect(document.cookie).toContain('Domain=example.test')
+    expect(document.cookie).toContain('Expires=Thu, 01 Jan 1970 00:00:00 GMT')
+    expect(document.cookie).toContain('Max-Age=0')
+  })
+
+  it('读取无法解码的现有 Cookie 时保留原值', () => {
+    document.cookie = 'token=%zz'
+    expect(cookie.get('token')).toBe('%zz')
+  })
+})
+
+describe.each([
+  ['local', local, 'localStorage'],
+  ['session', session, 'sessionStorage'],
+] as const)('%s 存储', (_name, storage, type) => {
+  it('保存和更新结构化数据，正确读取空字符串、false 和 0', () => {
+    for (const value of [{ title: '草稿', items: [1, 2] }, '', false, 0]) {
+      storage.set('draft', value)
+      expect(storage.get('draft')).toEqual(value)
+    }
+    storage.remove('draft')
+    expect(storage.get('draft')).toBeNull()
+  })
+
+  it('缺失或损坏的数据返回 null', () => {
+    expect(storage.get('missing')).toBeNull()
+    window[type].setItem('broken', '{invalid')
+    expect(storage.get('broken')).toBeNull()
+  })
+
+  it('不可序列化的数据不会覆盖已有值', () => {
+    storage.set('draft', 'saved')
+    expect(() => storage.set('draft', undefined)).toThrow(TypeError)
+    expect(storage.get('draft')).toBe('saved')
+  })
+
+  it('存储失败时向调用方抛出错误', () => {
+    vi.spyOn(window[type], 'setItem').mockImplementation(() => {
+      throw new Error('QuotaExceededError')
+    })
+    expect(() => storage.set('draft', 'value')).toThrow('QuotaExceededError')
+  })
+})
+
+it('local 和 session 的同名数据与清空操作相互独立', () => {
+  local.set('draft', 'local')
+  session.set('draft', 'session')
+  expect(local.get('draft')).toBe('local')
+  expect(session.get('draft')).toBe('session')
+  local.clear()
+  expect(local.get('draft')).toBeNull()
+  expect(session.get('draft')).toBe('session')
+  session.clear()
+  expect(session.get('draft')).toBeNull()
+})

package/template-vp-monorepo-react-nestjs/apps/web/test/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "types": ["node", "vite-plus/client"]
+  },
+  "include": ["./**/*.ts"]
+}

package/template-vp-monorepo-react-nestjs/apps/web/tsconfig.json

@@ -4,7 +4,7 @@
     "target": "ES2023",
     "lib": ["ES2023", "DOM", "DOM.Iterable"],
     "jsx": "react-jsx",
-    "types": ["vite-plus/client"],
+    "types": ["vite-plus/client", "vite-plugin-svgr/client"],
     "paths": {
       "@/*": ["./src/*"]
     },

package/template-vp-monorepo-react-nestjs/apps/web/vite.config.ts

@@ -2,6 +2,7 @@ import path from 'path'
 import tailwindcss from '@tailwindcss/vite'
 import react from '@vitejs/plugin-react'
 import AutoImport from 'unplugin-auto-import/vite'
+import svgr from 'vite-plugin-svgr'
 import { defineConfig, loadEnv } from 'vite-plus'
 
 export default defineConfig(({ mode }) => {
@@ -17,6 +18,11 @@ export default defineConfig(({ mode }) => {
     `)
 
   return {
+    test: {
+      environment: 'node',
+      include: ['test/**/*.spec.ts'],
+      restoreMocks: true,
+    },
     resolve: {
       alias: {
         '@': path.resolve(__dirname, 'src'),
@@ -35,6 +41,7 @@ export default defineConfig(({ mode }) => {
     },
     plugins: [
       react(),
+      svgr({ svgrOptions: { icon: true, ref: true } }),
       AutoImport({
         imports: ['react', 'react-router', 'react-dom'],
         dts: './src/types/auto-imports.d.ts',

package/template-vp-monorepo-react-nestjs/apps/web-vue/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/main.ts","./src/api/index.ts","./src/hooks/chart/lib.ts","./src/hooks/chart/useecharts.ts","./src/i18n/instance.ts","./src/router/index.ts","./src/router/interface.ts","./src/router/guard/index.ts","./src/router/guard/permissionguard.ts","./src/router/modules/index.ts","./src/store/index.ts","./src/store/modules/user.ts","./src/types/antdv-next.d.ts","./src/types/auto-import.d.ts","./src/types/components.d.ts","./src/types/vite-env.d.ts","./src/utils/env.ts","./src/utils/request/index.ts","./src/utils/request/core/index.ts","./src/utils/request/core/utils.ts","./src/views/example/echart/config.ts","./src/app.vue","./src/components/icon/svg-icon.vue","./src/layout/default/index.vue","./src/layout/default/header/index.vue","./src/views/example/tree-chart.vue","./src/views/example/echart/index.vue","./src/views/home/index.vue","./src/views/login/index.vue"],"errors":true,"version":"6.0.3"}

package/template-vp-monorepo-react-nestjs/docker-compose.yml

@@ -34,6 +34,25 @@ services:
       - '9001:9001'
     volumes:
       - minio-data:/data
+  minio-init:
+    image: quay.io/minio/mc:latest
+    container_name: vp-minio-init
+    depends_on:
+      minio:
+        condition: service_started
+    environment:
+      MINIO_ROOT_USER: minio
+      MINIO_ROOT_PASSWORD: minio123456
+      MINIO_BUCKET: uploads
+    entrypoint: >
+      /bin/sh -c "
+      until mc alias set local http://minio:9000 $$MINIO_ROOT_USER
+      $$MINIO_ROOT_PASSWORD;
+      do sleep 1; done;
+      mc mb --ignore-existing local/$$MINIO_BUCKET;
+      mc anonymous set none local/$$MINIO_BUCKET;
+      "
+    restart: 'no'
 
 volumes:
   postgres18-data:

package/template-vp-monorepo-react-nestjs/mise.toml

@@ -1,3 +1,3 @@
 [tools]
 node = "26"
-pnpm = "11"
+pnpm = "12"

package/template-vp-monorepo-react-nestjs/package.json

@@ -24,12 +24,7 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "11.9.0",
-      "onFail": "download"
-    },
-    "runtime": {
-      "name": "node",
-      "version": ">=22.18.0",
+      "version": "11.24.0",
       "onFail": "download"
     }
   }

package/template-vp-monorepo-react-nestjs/pnpm-workspace.yaml

@@ -7,14 +7,19 @@ catalogMode: prefer
 
 catalog:
   '@alova/adapter-axios': ^2.0.18
+  '@ant-design/cssinjs': ^2.1.2
+  '@ant-design/icons': ^6.3.4
+  '@ant-design/pro-components': 3.1.14-7
   '@antdv-next/auto-import-resolver': ^1.1.0
   '@antdv-next/icons': ^1.1.1
   '@antfu/eslint-config': ^9.1.0
+  '@aws-sdk/client-s3': ^3.1120.0
   '@commitlint/cli': ^21.2.1
   '@commitlint/config-conventional': ^21.1.0
   '@fastify/cookie': ^11.1.2
   '@fastify/static': ^10.1.0
   '@nestjs-modules/ioredis': ^2.2.1
+  '@nestjs/bullmq': ^12.0.0
   '@nestjs/cli': ^11.0.0
   '@nestjs/common': ^11.1.27
   '@nestjs/config': ^4.0.4
@@ -41,10 +46,11 @@ catalog:
   '@vitejs/plugin-vue': ^6.0.7
   '@vue/tsconfig': ^0.9.1
   alova: ^3.5.1
-  antd: ^6.4.5
+  antd: ^6.6.2
   antdv-next: ^1.4.1
   argon2: ^0.45.0
   axios: ^1.18.1
+  bullmq: ^6.3.4
   classnames: ^2.5.1
   cross-env: ^10.1.0
   dayjs: ^1.11.21
@@ -86,6 +92,7 @@ catalog:
   vite: npm:@voidzero-dev/vite-plus-core@0.2.4
   vite-plugin-inspect: ^11.4.1
   vite-plugin-svg-icons: ^2.0.1
+  vite-plugin-svgr: ^5.2.0
   vite-plus: 0.2.4
   vue: ^3.5.39
   vue-router: ^5.1.0
@@ -109,3 +116,4 @@ allowBuilds:
   argon2: true
   esbuild: true
   lefthook: true
+  msgpackr-extract: true

package/template-vp-react/.agents/rules/SVG/344/275/277/347/224/250.md

@@ -0,0 +1,8 @@
+# SVG 使用
+
+- 图标通过 `*.svg?react` 导入，使用 `@/components/Icon/svg-icon/SvgIcon` 渲染；用 `size`、`color` 控制大小和颜色，默认继承父级。
+- 公共图标放 `src/assets/svg/`，页面专用图标放所属页面的 `assets/svg/`。
+- 保留 `viewBox`；单色图标用 `currentColor`，保留 `none`、多色和渐变。
+- 图片或背景直接导入 `*.svg` 获取 URL。
+
+参数、无障碍设置及示例见 [SvgIcon 使用说明](../../src/components/Icon/svg-icon/README.md)。

package/template-vp-react/AGENTS.md

@@ -0,0 +1,11 @@
+## 适用范围
+
+本文件适用于本模板及其子目录。
+
+## 按需规则
+
+根据当前任务匹配下表，在执行相关操作前读取对应规则。不要预先加载整个 `.agents/rules/` 目录；任务范围变化时补读新命中的规则。
+
+| 适用条件             | 规则文件                             |
+| -------------------- | ------------------------------------ |
+| 新增、修改或使用 SVG | [SVG 使用](.agents/rules/SVG使用.md) |