gd-web-core 0.0.9 → 0.0.11

package/README.md

@@ -1,443 +1,111 @@
-# gd-web-core
-
-Vue 3 基座能力封装库，提供通用组件和工具函数。
-
-## 安装
-
-```bash
-pnpm add gd-web-core
-```
-
-## 快速开始
-
-### 全量引入
-
-```ts
-import { createApp } from 'vue'
-import YourOrgCore from 'gd-web-core'
-import 'gd-web-core/style.css'
-import App from './App.vue'
-
-const app = createApp(App)
-app.use(YourOrgCore)
-app.mount('#app')
-```
-
-### 按需引入（推荐）
-
-本库完全支持 Tree-shaking，可以按需引入组件和工具函数，减小打包体积。
-
-#### 方式 1: 从主入口导入（推荐）
-
-```ts
-import { Echarts, STable, formatDate } from 'gd-web-core'
-import 'gd-web-core/style.css'
-```
-
-#### 方式 2: 从子路径导入（更语义化）
-
-```ts
-// 仅导入组件
-import { Echarts, STable } from 'gd-web-core/components'
-
-// 仅导入工具函数
-import { formatDate, formatNumber } from 'gd-web-core/utils'
-
-// 导入样式
-import 'gd-web-core/style.css'
-```
-
-#### Tree-shaking 原理
-
-现代打包工具（Vite、Webpack 5+、Rollup）会自动移除未使用的代码：
-
-```ts
-// 只会打包 formatDate 相关代码，其他工具函数不会被打包
-import { formatDate } from 'gd-web-core'
-```
-
-**工作条件**：
-- ✅ 使用 ES Module (`import`/`export`)
-- ✅ 打包工具开启生产模式
-- ✅ 使用命名导入（不是 `import *`）
-
-#### 打包体积对比
-
-| 导入方式 | 打包后体积（估算） |
-|---------|-----------------|
-| 全量导入 | ~200KB (gzip ~60KB) |
-| 按需导入单个组件 | ~20KB (gzip ~6KB) |
-| 按需导入单个工具函数 | ~2KB (gzip <1KB) |
-
-## 验证 Tree-shaking 效果
-
-### 使用 Rollup Plugin Visualizer
-
-```bash
-# 安装可视化插件
-pnpm add -D rollup-plugin-visualizer
-
-# 在 vite.config.ts 中添加
-import { visualizer } from 'rollup-plugin-visualizer'
-
-export default defineConfig({
-  plugins: [
-    visualizer({ open: true })
-  ]
-})
-
-# 构建后会自动打开分析报告
-pnpm build
-```
-
-### 使用 Vite Build Analyzer
-
-```bash
-# 开发时查看导入分析
-pnpm dev
-
-# 在浏览器控制台查看
-import { formatDate } from 'gd-web-core'
-// 只会加载 formatDate 相关模块
-```
-
-### 检查打包产物
-
-```bash
-# 构建生产版本
-pnpm build
-
-# 查看产物大小
-ls -lh dist/
-
-# 输出示例
-# index.js        150KB  (ES Module, 支持 tree-shaking)
-# index.umd.cjs   180KB  (UMD, 不支持 tree-shaking)
-# index.d.ts       50KB  (TypeScript 类型定义)
-# style.css        20KB  (所有组件样式)
-```
-
-## 组件
-
-### Echarts 图表
-
-需要安装 `echarts` 依赖。
-
-```vue
-<template>
-  <Echarts :options="chartOptions" height="400px" @click="handleClick" />
-</template>
-
-<script setup lang="ts">
-import { Echarts } from 'gd-web-core'
-
-const chartOptions = {
-  xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
-  yAxis: { type: 'value' },
-  series: [{ data: [120, 200, 150], type: 'bar' }]
-}
-</script>
-```
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| options | `EChartsOption` | 必填 | ECharts 配置项 |
-| width | `string` | `'100%'` | 宽度 |
-| height | `string` | `'300px'` | 高度 |
-| theme | `string` | `''` | 主题 |
-
-### ScrollContainer 滚动容器
-
-自定义滚动条组件。
-
-```vue
-<template>
-  <ScrollContainer height="300px" direction="y">
-    <div>滚动内容...</div>
-  </ScrollContainer>
-</template>
-
-<script setup lang="ts">
-import { ScrollContainer } from 'gd-web-core'
-</script>
-```
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| height | `string \| number` | `'100%'` | 高度 |
-| maxHeight | `string \| number` | - | 最大高度 |
-| direction | `'x' \| 'y' \| 'both'` | `'y'` | 滚动方向 |
-
-### STable 表格
-
-需要安装 `@surely-vue/table` 和 `ant-design-vue` 依赖。
-
-```vue
-<template>
-  <STable :columns="columns" :data="loadData" />
-</template>
-
-<script setup lang="ts">
-import { STable } from 'gd-web-core'
-
-const columns = [
-  { title: '姓名', dataIndex: 'name' },
-  { title: '年龄', dataIndex: 'age' }
-]
-
-const loadData = async (params) => {
-  const res = await fetchData(params)
-  return { data: res.list, total: res.total }
-}
-</script>
-```
-
-## 工具函数
-
-### 日期格式化
-
-```ts
-import { formatDate, dateFormat } from 'gd-web-core'
-
-formatDate(new Date())                      // '2026-02-02 10:30:00'
-formatDate('2026-01-01', 'YYYY/MM/DD')      // '2026/01/01'
-dateFormat('YY-mm-dd HH:MM:SS', new Date()) // '2026-02-02 10:30:00'
-```
-
-### 数字处理
-
-```ts
-import { formatNumber, formatFileSize, toFixed, round } from 'gd-web-core'
-
-formatNumber(1234567.89)     // '1,234,567.89'
-formatFileSize(1048576)      // '1 MB'
-toFixed(3.1415926, 2)        // 3.14 (不四舍五入)
-round(0.7 * 3, 2)            // 2.1 (四舍五入，精度安全)
-```
-
-### Storage 封装
-
-```ts
-import { storage, createStorage } from 'gd-web-core'
-
-storage.set('token', 'xxx', 3600000)  // 1小时后过期
-storage.get('token')
-
-const myStorage = createStorage('session', { prefix: 'myapp' })
-```
-
-### 防抖节流
-
-```ts
-import { debounce, throttle, createDebounce } from 'gd-web-core'
-
-// Promise 防抖
-await debounce('search', 300)
-
-// 节流函数
-const throttledFn = throttle(fn, 100)
-
-// 创建防抖函数
-const debouncedFn = createDebounce(fn, 300)
-```
-
-### URL 参数
-
-```ts
-import { useUrlParams, updateUrlParams } from 'gd-web-core'
-
-const params = useUrlParams()
-updateUrlParams({ page: '2' })
-```
-
-### DOM 操作
-
-```ts
-import { scrollView, setHtmlTitle, print } from 'gd-web-core'
-
-scrollView('element-id')
-setHtmlTitle('新标题')
-await print('#print-area')
-```
-
-### 加密
-
-```ts
-import { useRsa, useAes, disuseAes } from 'gd-web-core'
-
-const encrypted = await useRsa('data', publicKey)
-const aesEncrypted = await useAes('data', key)
-const decrypted = await disuseAes(aesEncrypted, key)
-```
-
-### 页面可见性
-
-```ts
-import { onVisibilityChange } from 'gd-web-core'
-
-const unsubscribe = onVisibilityChange((hidden) => {
-  console.log('页面隐藏:', hidden)
-})
-```
-
-### Excel 导入导出
-
-```ts
-import { importExcel, importExcelAll, exportJsonToExcel } from 'gd-web-core'
-
-// 导入
-const data = await importExcel(file)
-const allSheets = await importExcelAll(file)
-
-// 导出
-await exportJsonToExcel(['姓名', '年龄'], [['张三', 25]], '用户列表')
-```
-
-### 后端数据解析
-
-```ts
-import { rowSet, pageRowSet } from 'gd-web-core'
-
-const { colKey, data } = rowSet(result)
-const { colKey, data, total } = pageRowSet(pageResult)
-```
-
-## 常见问题
-
-### 为什么按需引入后打包体积还是很大？
-
-1. **检查样式文件**：CSS 是全量加载的，确保只在入口文件导入一次
-2. **检查导入方式**：避免使用 `import * as Core from 'gd-web-core'`
-3. **检查生产模式**：确保打包工具运行在生产模式 (`NODE_ENV=production`)
-4. **检查打包配置**：确认 Tree-shaking 已启用
-
-### 组件依赖的第三方库会被打包吗？
-
-不会。以下依赖被标记为 `external`，不会打包进库中：
-- `vue` (必需)
-- `vue-router` (可选)
-- `echarts` (按需)
-- `ant-design-vue` (按需)
-- `@surely-vue/table` (按需)
-
-用户需要在自己的项目中安装这些依赖。
-
-### 可以只安装部分依赖吗？
-
-可以。例如，如果不使用 `Echarts` 组件，无需安装 `echarts`：
-
-```bash
-# 最小安装
-pnpm add gd-web-core vue
-
-# 使用 Echarts 组件
-pnpm add echarts
-
-# 使用 STable 组件
-pnpm add ant-design-vue @surely-vue/table
-```
-
-### TypeScript 类型定义支持按需引用吗？
-
-完全支持。所有类型定义都会正确推导：
-
-```ts
-import { formatDate } from 'gd-web-core'
-// formatDate 函数会有完整的类型提示
-
-import type { EchartsProps } from 'gd-web-core'
-// 可以单独导入类型
-```
-
-## 目录结构
-
-```
-src/
-├── components/
-│   ├── Echarts/
-│   ├── ScrollContainer/
-│   └── STable/
-├── utils/
-│   ├── format.ts
-│   ├── storage.ts
-│   ├── loadRemote.ts
-│   ├── dom.ts
-│   ├── url.ts
-│   ├── number.ts
-│   ├── async.ts
-│   ├── crypto.ts
-│   ├── visibility.ts
-│   ├── rowSet.ts
-│   └── xlsx.ts
-├── assets/
-└── index.ts
-```
-
-## 📚 文档
-
-完整文档请查看 [docs/](./docs/) 目录：
-
-- **快速开始**
-  - [安装指南](./docs/getting-started/installation.md)
-  - [快速上手](./docs/getting-started/quick-start.md)
-
-- **进阶指南**
-  - [按需引用](./docs/guides/tree-shaking.md) - Tree-shaking 优化
-  - [TypeScript 支持](./docs/guides/typescript.md)
-  - [最佳实践](./docs/guides/best-practices.md)
-
-- **发布和部署** ⭐
-  - [发布流程完整指南](./docs/deployment/publishing.md)
-  - [版本管理规范](./docs/deployment/versioning.md)
-  - [发布检查清单](./docs/deployment/checklist.md)
-  - [CI/CD 集成](./docs/deployment/ci-cd.md)
-
-- **开发指南**
-  - [开发环境搭建](./docs/development/setup.md)
-  - [贡献指南](./docs/development/contributing.md)
-
-## 🚀 开发
-
-### 快速开始
-
-```bash
-# 安装依赖
-pnpm install
-
-# 启动开发服务器（带 playground 预览）
-pnpm dev
-
-# 构建库
-pnpm build
-
-# 发布到 npm
-pnpm release:patch  # 或 minor、major
-```
-
-### 发布流程
-
-详细的发布指南请查看 [发布流程文档](./docs/deployment/publishing.md)
-
-**快速发布**：
-```bash
-# 1. 构建
-pnpm build
-
-# 2. 发布（自动更新版本号）
-pnpm release:patch   # Bug 修复 (0.0.1 -> 0.0.2)
-pnpm release:minor   # 新功能 (0.0.2 -> 0.1.0)
-pnpm release:major   # 破坏性变更 (0.1.0 -> 1.0.0)
-
-# 3. 推送 tag
-git push origin main --tags
-```
-
-### 目录说明
-
-- `src/` - 库源代码
-- `playground/` - 开发预览应用
-- `dist/` - 构建输出
-
-## License
-
-MIT
+# Vue 3 + TypeScript + Ant Design Vue + Vite 管理系统
+
+这是一个基于 Vue 3、TypeScript、Vite 和 Ant Design Vue 构建的后台管理系统模板。项目集成了 Pinia 状态管理、Vue Router 路由控制以及 ESLint/Prettier 代码规范工具，旨在提供一个快速、高效的开发起点。
+
+## 📚 文档
+
+*   [**脚手架配置 (Scaffold)**](./docs/脚手架配置.md): 统一封装了Vite、代理、插件等配置。
+*   [**路由说明 (Router)**](./docs/路由说明.md): 详细介绍了路由配置、权限控制及新增页面的方法。
+*   [**开发服务器 (DevServer)**](./docs/开发服务器.md): 介绍代理配置、BaseURL 注入及运行时配置原理。
+*   [**基座组件 (Core)**](./docs/基座组件.md): 介绍基座组件的设计理念、使用方法及注意事项。
+*   [**全局水印 (Watermark)**](./docs/全局水印.md): 介绍全局水印功能的开启、配置与实现原理。
+
+## 🛠️ 技术栈
+
+*   **框架**: [Vue 3](https://vuejs.org/) (Composition API)
+*   **语言**: TypeScript
+*   **构建工具**: [Vite](https://vitejs.dev/)
+*   **UI 组件库**: [Ant Design Vue](https://antdv.com/)
+*   **状态管理**: [Pinia](https://pinia.vuejs.org/)
+*   **路由管理**: [Vue Router](https://router.vuejs.org/)
+*   **CSS 预处理**: Less
+*   **HTTP 请求**: Axios
+*   **代码规范**: ESLint + Prettier
+
+## 🚀 快速开始
+
+### 环境要求
+
+*   **Node.js**: version **20+**
+*   **Package Manager**: **pnpm**
+
+推荐使用 `nvm` 管理 Node 版本：
+
+```bash
+nvm use 20
+```
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 开发环境运行
+
+启动本地开发服务器，支持热重载：
+
+```bash
+pnpm dev
+```
+
+### 生产环境构建
+
+编译并压缩代码用于生产环境：
+
+```bash
+pnpm build
+```
+
+## ⚙️ 配置说明
+
+### 开发服务器代理
+
+`devServer.config.ts` 用于配置开发环境的代理设置。
+
+示例：
+
+```ts
+const proxy = {
+  // Key: 代理路径前缀 (也是开发模式下的 baseUrl)
+  // Value: 目标 API 服务器地址
+  respj: 'http://dddev.yixx.cn/respj',
+};
+export default proxy;
+```
+
+在 `pnpm dev` 模式下，第一个 key (如 `respj`) 将自动作为 `baseUrl`。
+
+## 📂 目录结构
+
+```
+project-root/
+├── core/               # 基座组件：提供通用组件、函数、服务
+│   ├── components/     # 通用组件
+├── src/                # 业务逻辑目录
+│   ├── api/            # 业务 API 接口 (TypeScript)
+│   ├── assets/         # 静态资源
+│   ├── components/     # 业务组件
+│   ├── layout/         # 布局组件 (BasicLayout, TopLayout, SideLayout)
+│   ├── router/         # 路由配置 (index.ts, permission.ts)
+│   ├── store/          # 状态管理 (User, Menu, Setting, Permission，均为 .ts)
+│   ├── styles/         # 全局样式
+│   │   ├── variables.less # 变量
+│   │   ├── global.less    # 全局样式
+│   │   └── index.less     # 样式入口
+│   ├── utils/          # 工具函数 (request.ts 等)
+│   ├── views/          # 页面视图
+│   │   ├── home/       # 首页
+│   │   ├── login/      # 登录页
+│   │   └── system/     # 系统管理页
+│   ├── App.vue         # 根组件
+│   └── main.ts         # 入口文件
+├── devServer.config.ts # 开发环境代理配置
+├── vite.config.ts      # Vite 配置 (TypeScript)
+├── tsconfig.json       # TypeScript 主配置
+└── tsconfig.node.json  # Node 相关 TypeScript 配置
+```
+
+## 💻 IDE 支持
+
+推荐使用 [VS Code](https://code.visualstudio.com/) 配合 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) 插件以获得最佳的 Vue 3 开发体验。

package/docs/utils/index.md

@@ -1,12 +1,13 @@
 # 工具函数索引
 
-> 📅 索引生成时间：2026-02-09
+> 📅 索引生成时间：2026-03-27
 
 ## 文档列表
 
 | 文档 | 描述 | 状态 |
 |------|------|------|
 | [async](./async.md) | 防抖、节流等异步控制函数 | ✅ |
+| [request](./request.md) | HTTP 请求封装，支持自定义消息组件 | ✅ |
 | [crypto](./crypto.md) | RSA/AES 加密解密工具 | ✅ |
 | [dom](./dom.md) | DOM 操作（滚动、打印、标题） | ✅ |
 | [format](./format.md) | 日期、数字、文件大小格式化 | ✅ |
@@ -20,14 +21,14 @@
 
 ## 分类统计
 
-- 总数量：11
+- 总数量：12
 - 需要更新：0
 
 ## 快速导入
 
 ```typescript
 // 导入所有工具函数
-import { 
+import {
   debounce, throttle, createDebounce,
   useRsa, useAes, disuseAes,
   scrollView, setHtmlTitle, print,
@@ -38,6 +39,7 @@ import {
   createStorage, storage,
   useUrlParams, updateUrlParams,
   onVisibilityChange,
-  importExcel, importExcelAll, exportJsonToExcel, exportTableToExcel, tableToExcel, exportMultipleTableToExcel
+  importExcel, importExcelAll, exportJsonToExcel, exportTableToExcel, tableToExcel, exportMultipleTableToExcel,
+  request, configureRequest, getRequestOptions
 } from 'gd-web-core/utils'
 ```

package/docs/utils/request.md

@@ -0,0 +1,174 @@
+# request
+
+基于 Axios 的 HTTP 请求封装，支持自定义消息组件和响应处理。
+
+## 概述
+
+提供统一的 HTTP 请求拦截器、响应处理、错误提示和登录超时处理。默认使用 ant-design-vue 的消息组件，支持消费者自定义。
+
+## 导入方式
+
+```typescript
+import request, { configureRequest, getRequestOptions } from 'gd-web-core/utils'
+```
+
+## 配置函数
+
+### configureRequest
+
+全局配置请求实例。
+
+```typescript
+configureRequest(options: RequestOptions): void
+```
+
+**RequestOptions 参数**
+
+| 参数名 | 类型 | 默认值 | 描述 |
+|--------|------|--------|------|
+| message | MessageHandler | ant-design-vue | 自定义消息组件 |
+| autoSuccessMsg | boolean | true | 是否自动显示成功提示 |
+| loginUrl | string | '#/login' | 登录跳转路径 |
+| transformResponse | (res, config) => any | - | 自定义响应处理 |
+
+### getRequestOptions
+
+获取当前全局配置。
+
+```typescript
+getRequestOptions(): RequestOptions
+```
+
+## 接口定义
+
+### RequestConfig
+
+扩展的 Axios 请求配置。
+
+```typescript
+export interface RequestConfig extends AxiosRequestConfig {
+  hideErrMsg?: boolean;    // 是否隐藏错误提示
+  hideLoading?: boolean;   // 是否隐藏 loading
+  useToken?: boolean;      // 是否使用 token
+}
+```
+
+### MessageHandler
+
+消息处理组件接口。
+
+```typescript
+export interface MessageHandler {
+  loading: (content: string, duration?: number) => (() => void) | undefined;
+  success: (options: { content: string; duration?: number; onClose?: () => void }) => void;
+  error: (options: { content: string; duration?: number; onClose?: () => void }) => void;
+}
+```
+
+### ResponseData
+
+响应数据结构。
+
+```typescript
+export interface ResponseData {
+  error?: { code: number; message?: string };
+  result?: { code: number; msg?: string };
+  [key: string]: any;
+}
+```
+
+## 使用示例
+
+### 基础使用
+
+```typescript
+import request from 'gd-web-core/utils'
+
+// GET 请求
+const data = await request.get('/api/user', { hideErrMsg: true })
+
+// POST 请求
+const result = await request.post('/api/submit', { name: 'test' })
+```
+
+### 自定义消息组件
+
+```typescript
+import request, { configureRequest } from 'gd-web-core/utils'
+
+configureRequest({
+  message: {
+    loading: (content) => {
+      console.log('loading:', content)
+      return () => console.log('close loading')
+    },
+    success: ({ content }) => console.log('success:', content),
+    error: ({ content }) => console.log('error:', content),
+  }
+})
+```
+
+### 自定义响应处理
+
+```typescript
+import request, { configureRequest } from 'gd-web-core/utils'
+
+configureRequest({
+  transformResponse: (res, config) => {
+    // 自定义处理逻辑
+    if (config.url?.includes('/custom')) {
+      return res.data
+    }
+    return res
+  }
+})
+```
+
+### 禁用成功提示
+
+```typescript
+// 方式1：全局禁用
+configureRequest({
+  autoSuccessMsg: false
+})
+
+// 方式2：单个请求禁用
+request.post('/api/submit', { data: 1 }, { hideErrMsg: true })
+```
+
+## 响应数据结构
+
+请求成功时返回的响应结构：
+
+```typescript
+// 业务错误（error 字段）
+{
+  error: {
+    code: -403,
+    message: '会话已超时'
+  }
+}
+
+// 操作结果（result 字段）
+{
+  result: {
+    code: 0,      // >= 0 表示成功
+    msg: '操作成功'
+  },
+  data: {...}     // 业务数据
+}
+
+// 正常返回
+{
+  data: {...}    // 业务数据
+}
+```
+
+## 错误处理
+
+请求失败时会自动 reject Promise，并通过消息组件提示错误：
+
+- **登录超时**：code === -403 或 message 包含"会话已超时"，自动跳转登录页
+- **业务错误**：显示 error.message
+- **操作失败**：显示 result.msg
+- **网络错误**：显示"请求超时"、"网络错误"等

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "gd-web-core",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Vue 3 基座能力封装库 - 组件与工具函数",
   "type": "module",
   "files": [
-    "src",
-    "docs"
+    "src/assets",
+    "src/components",
+    "src/utils",
+    "src/index.ts",
+    "docs/components",
+    "docs/utils",
+    "docs/INDEX.md"
   ],
   "main": "./src/index.ts",
   "module": "./src/index.ts",
@@ -34,6 +39,10 @@
     "build:check": "vue-tsc --noEmit && vite build",
     "build:types": "vue-tsc --declaration --emitDeclarationOnly --outDir dist",
     "preview": "vite preview",
+    "lint": "eslint . --fix",
+    "format": "prettier --write .",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
     "release:patch": "npm version patch && npm publish",
     "release:minor": "npm version minor && npm publish",
     "release:major": "npm version major && npm publish",
@@ -53,27 +62,6 @@
     "ant-design-vue": "^4.0.0",
     "echarts": "^5.0.0"
   },
-  "devDependencies": {
-    "@types/node": "^25.2.0",
-    "@types/prismjs": "^1.26.5",
-    "@vitejs/plugin-vue": "^6.0.4",
-    "@vitest/ui": "^4.0.18",
-    "ant-design-vue": "^4.2.0",
-    "echarts": "^5.5.0",
-    "happy-dom": "^20.5.0",
-    "highlight.js": "^11.11.1",
-    "marked": "^17.0.1",
-    "typescript": "~5.6.0",
-    "unplugin-auto-import": "^21.0.0",
-    "unplugin-vue-components": "^31.0.0",
-    "vite": "^7.2.0",
-    "vite-plugin-css-injected-by-js": "^3.5.2",
-    "vite-plugin-dts": "^4.2.0",
-    "vitest": "^4.0.18",
-    "vue": "^3.5.0",
-    "vue-router": "^4.4.0",
-    "vue-tsc": "^2.1.0"
-  },
   "keywords": [
     "vue",
     "vue3",
@@ -97,8 +85,45 @@
   "dependencies": {
     "@surely-vue/table": "4.1.9",
     "axios": "^1.13.6",
-    "npm": "^11.8.0",
-    "prismjs": "^1.30.0",
-    "publish": "^0.6.0"
+    "dayjs": "^1.11.19",
+    "echarts": "^6.0.0",
+    "nprogress": "^0.2.0",
+    "pinia": "^3.0.4",
+    "prismjs": "^1.30.0"
+  },
+  "devDependencies": {
+    "@ant-design/icons-vue": "^7.0.1",
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^22.10.6",
+    "@types/nprogress": "^0.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "@vitest/ui": "^4.0.18",
+    "ant-design-vue": "^4.2.6",
+    "echarts": "^5.5.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-vue": "^10.6.2",
+    "gd-vite-core": "^1.0.8",
+    "globals": "^17.0.0",
+    "happy-dom": "^20.5.0",
+    "highlight.js": "^11.11.1",
+    "less": "^4.5.1",
+    "marked": "^17.0.1",
+    "prettier": "^3.7.4",
+    "typescript": "~5.6.0",
+    "unplugin-auto-import": "^21.0.0",
+    "unplugin-vue-components": "^30.0.0",
+    "vite": "^7.2.4",
+    "vite-plugin-css-injected-by-js": "^3.5.2",
+    "vite-plugin-dts": "^4.2.0",
+    "vite-plugin-require-transform": "^1.0.21",
+    "vitest": "^4.0.18",
+    "vue": "^3.5.24",
+    "vue-eslint-parser": "^10.2.0",
+    "vue-router": "^4.6.4",
+    "vue-tsc": "^2.2.4"
   }
 }

package/src/components/STable/STable.vue

@@ -31,7 +31,7 @@
 <script setup lang="ts">
 import { ref, reactive, onMounted, defineAsyncComponent, computed } from 'vue'
 import type { Component } from 'vue'
-import * as xlsx from '@/utils/xlsx'
+import * as xlsx from '../../utils/xlsx'
 import '@surely-vue/table/dist/index.css';
 // import 'ant-design-vue/es/menu/style'
 // import 'ant-design-vue/es/dropdown/style'

package/src/components/SliderCaptcha/SliderCaptcha.vue

@@ -204,7 +204,7 @@ export interface SliderCaptchaProps {
 }
 
 export interface SliderCaptchaEmits {
-  (e: 'success'): void
+  (e: 'success', x: number): void
   (e: 'fail'): void
   (e: 'refresh'): void
   (e: 'close'): void
@@ -247,8 +247,8 @@ const {
 } = useSliderCaptcha({
   fetchImage: fetchImageFn,
   verify: verifyFn,
-  onSuccess: () => {
-    emit('success')
+  onSuccess: (x: number) => {
+    emit('success', x)
     if (isDialogMode.value) {
       setTimeout(() => {
         emit('close')

package/src/components/SliderCaptcha/SliderCaptchaContent.vue

@@ -42,12 +42,6 @@ defineEmits<{
 
 function onBgLoad(event: Event) {
   img.value = event.target as HTMLImageElement
-  console.log('onBgLoad', {
-    width: img.value.naturalWidth,
-    height: img.value.naturalHeight,
-    currentWidth: img.value.width,
-    currentHeight: img.value.height
-  })
 }
 
 function onSliderLoad() {

package/src/components/SliderCaptcha/apis.ts

@@ -2,7 +2,7 @@
  * 内置接口 - 滑块验证码后端交互
  * 注意：仅适用于 monorepo 或源码引用场景
  */
-import request from '@_request'
+import request from '../../utils/request'
 
 /**
  * 获取验证码图片
@@ -12,7 +12,7 @@ export async function defaultFetchImage(): Promise<{
   sliderImage: string
   y: number
 }> {
-  const res = await request('/yzm/getSlideYzmInfo.jsmeb', {}, { hideErrMsg: true, hideLoading: true })
+  const res = await request.post('/yzm/getSlideYzmInfo.jsmeb', {}, { hideErrMsg: true, hideLoading: true })
   const data = res.result
   return {
     bgImage: 'data:image/jpeg;base64,' + data.backgroundImg,
@@ -25,6 +25,6 @@ export async function defaultFetchImage(): Promise<{
  * 验证滑块位置
  */
 export async function defaultVerify(x: number): Promise<{ success: boolean }> {
-  const res = await request({ url: '/yzm/check.jsmeb', data: [Math.round(x)], ideErrMsg: true, hideLoading: true })
+  const res = await request.post('/yzm/check.jsmeb', [Math.round(x)], { hideErrMsg: true, hideLoading: true })
   return res.result
 }

package/src/components/SliderCaptcha/useSliderCaptcha.ts

@@ -4,7 +4,7 @@ import type { CaptchaData, VerifyResult } from './SliderCaptcha.vue'
 export interface UseSliderCaptchaOptions {
   fetchImage?: () => Promise<CaptchaData>
   verify?: (x: number) => Promise<VerifyResult>
-  onSuccess?: () => void
+  onSuccess?: (x: number) => void
   onFail?: () => void
   getContainerWidth?: () => number
 }
@@ -213,7 +213,7 @@ export function useSliderCaptcha(options: UseSliderCaptchaOptions) {
 
         if (result) {
           state.success = true
-          options.onSuccess?.()
+          options.onSuccess?.(state.offsetX)
         } else {
           // 验证失败：显示错误提示，等待1.5秒后再刷新，不显示刷新按钮
           state.error = true

package/src/utils/index.ts

@@ -9,3 +9,4 @@ export * from './crypto'
 export * from './visibility'
 export * from './rowSet'
 export * from './xlsx'
+export * from './request'

package/src/utils/request.ts

@@ -0,0 +1,320 @@
+import axios, {
+  type AxiosRequestConfig,
+  type AxiosInstance,
+  type AxiosError,
+  type InternalAxiosRequestConfig,
+  type AxiosResponse,
+} from 'axios';
+
+// 定义扩展的请求配置接口
+export interface RequestConfig extends AxiosRequestConfig {
+  /** 是否隐藏错误提示 */
+  hideErrMsg?: boolean;
+  /** 是否隐藏 loading */
+  hideLoading?: boolean;
+  useToken?: boolean;
+}
+
+// 定义通用的响应结构
+export type ApiResponse<T = any> = T;
+
+// 消息组件接口
+export interface MessageHandler {
+  loading: (content: string, duration?: number) => (() => void) | undefined;
+  success: (options: { content: string; duration?: number; onClose?: () => void }) => void;
+  error: (options: { content: string; duration?: number; onClose?: () => void }) => void;
+}
+
+// 响应错误结构
+export interface ResponseError {
+  code: number;
+  message?: string;
+}
+
+// 响应结果结构
+export interface ResponseResult {
+  code: number;
+  msg?: string;
+}
+
+// 响应数据结构
+export interface ResponseData {
+  error?: ResponseError;
+  result?: ResponseResult;
+  [key: string]: any;
+}
+
+// 登录错误码
+const LOGIN_ERROR_CODES = [-403];
+const LOGIN_ERROR_MESSAGES = ['会话已超时', 'Session is null'];
+
+// 接口配置接口
+export interface RequestOptions {
+  /** 消息处理组件，默认使用 ant-design-vue */
+  message?: MessageHandler;
+  /** 是否自动处理成功提示（result.code !== 0） */
+  autoSuccessMsg?: boolean;
+  /** 登录跳转路径 */
+  loginUrl?: string;
+  /** 自定义响应处理，返回值将作为最终响应数据 */
+  transformResponse?: (res: ResponseData, config: RequestConfig) => any;
+}
+
+interface CustomAxiosInstance extends AxiosInstance {
+  <T = any>(config: RequestConfig): Promise<ApiResponse<T>>;
+  <T = any>(url: string, config?: RequestConfig): Promise<ApiResponse<T>>;
+  get<T = any, R = ApiResponse<T>>(url: string, config?: RequestConfig): Promise<R>;
+  post<T = any, R = ApiResponse<T>>(url: string, data?: any, config?: RequestConfig): Promise<R>;
+}
+
+// 请求队列，用于处理重复请求
+const pendingMap = new Map<string, AbortController>();
+
+let hideLoadingMessage: (() => void) | null = null;
+const USEAUTHTOKEN = false; // 是否启动headers Authorization token
+
+/**
+ * 生成请求的唯一 key
+ */
+const getRequestKey = (config: InternalAxiosRequestConfig): string => {
+  if (config.params?._t) {
+    delete config.params._t;
+  }
+  return [
+    config.method,
+    config.url,
+    typeof config.params === 'string' ? config.params : JSON.stringify(config.params || {}),
+    typeof config.data === 'string' ? config.data : JSON.stringify(config.data || {}),
+  ].join('&');
+};
+
+/**
+ * 添加loading到队列
+ */
+const addPending = (config: InternalAxiosRequestConfig) => {
+  const key = getRequestKey(config);
+  if (pendingMap.has(key)) {
+    const controller = pendingMap.get(key);
+    controller?.abort();
+    pendingMap.delete(key);
+  }
+  const controller = new AbortController();
+  config.signal = controller.signal;
+  pendingMap.set(key, controller);
+};
+
+/**
+ * 移除loading队列
+ */
+const removePending = (config: InternalAxiosRequestConfig) => {
+  const key = getRequestKey(config);
+  if (pendingMap.has(key)) {
+    pendingMap.delete(key);
+  }
+  // 关闭 Loading
+  if (pendingMap.size === 0 && hideLoadingMessage) {
+    hideLoadingMessage();
+    hideLoadingMessage = null;
+  }
+};
+
+const baseURL =
+  import.meta.env.MODE === 'development'
+    ? (window as any).config?.baseUrl
+    : `/${location.pathname.split('/')[1]}`;
+(window as any).basePath = (window as any).basePath ? (window as any).basePath : baseURL;
+
+// 默认的 ant-design-vue 消息处理
+let defaultMessage: MessageHandler | undefined;
+
+const getDefaultMessage = (): MessageHandler => {
+  if (!defaultMessage) {
+    // 动态导入避免循环依赖
+    const antMessage = (window as any).antMessage;
+    if (antMessage) {
+      defaultMessage = {
+        loading: (content: string, duration = 200) => antMessage.loading(content, duration),
+        success: (options: { content: string; duration?: number; onClose?: () => void }) =>
+          antMessage.success(options),
+        error: (options: { content: string; duration?: number; onClose?: () => void }) =>
+          antMessage.error(options),
+      };
+    }
+  }
+  return defaultMessage!;
+};
+
+// 默认配置
+let globalOptions: RequestOptions = {};
+
+/**
+ * 配置请求实例
+ */
+export const configureRequest = (options: RequestOptions) => {
+  globalOptions = {
+    autoSuccessMsg: true,
+    loginUrl: '#/login',
+    ...options,
+  };
+};
+
+/**
+ * 获取当前配置
+ */
+export const getRequestOptions = (): RequestOptions => globalOptions;
+
+// 创建 axios 实例
+const request: CustomAxiosInstance = axios.create({
+  // 优先使用环境变量，否则回退到空字符串（相对路径）
+  baseURL: baseURL || '',
+  timeout: 30000,
+  method: 'post',
+  headers: {},
+}) as CustomAxiosInstance;
+
+// 获取当前配置的消息处理函数
+const getMessage = (): MessageHandler => {
+  return globalOptions.message || getDefaultMessage();
+};
+
+// 请求拦截器
+request.interceptors.request.use(
+  (config: InternalAxiosRequestConfig & RequestConfig) => {
+    const message = getMessage();
+    if (!isFormData(config.data)) {
+      if (pendingMap.size === 0 && !config.hideLoading) {
+        hideLoadingMessage = message.loading('加载中...', 200);
+      }
+      addPending(config);
+    }
+    if (USEAUTHTOKEN) {
+      const token = config.useToken || localStorage.getItem('token');
+      if (token) {
+        if (!config.headers) {
+          config.headers = {} as any;
+        }
+        (config.headers as any).Authorization = `Bearer ${token}`;
+      }
+    }
+
+    // 添加时间戳防止缓存
+    if (config.method?.toUpperCase() === 'POST' || config.method?.toUpperCase() === 'GET') {
+      config.params = {
+        ...config.params,
+        _t: Date.now(),
+      };
+    }
+
+    return config;
+  },
+  (error: AxiosError) => {
+    return Promise.reject(error);
+  }
+);
+
+// 响应拦截器
+request.interceptors.response.use(
+  (response: AxiosResponse<ResponseData>) => {
+    const { config } = response;
+    if (!isFormData(config.data)) {
+      removePending(config as InternalAxiosRequestConfig);
+    }
+
+    const res = response.data;
+    const message = getMessage();
+
+    // 自定义响应处理
+    if (globalOptions.transformResponse) {
+      return globalOptions.transformResponse(res, config as RequestConfig);
+    }
+
+    // 处理业务错误（error 字段）
+    if (res.error) {
+      const { code, message: errMessage } = res.error;
+
+      // 检查是否是登录超时
+      const isLoginTimeout =
+        LOGIN_ERROR_CODES.includes(code) ||
+        LOGIN_ERROR_MESSAGES.some((msg) => errMessage?.includes(msg));
+
+      if (isLoginTimeout) {
+        message.error({
+          content: '登录超时，请重新登录',
+          duration: 2,
+          onClose: () => {
+            window.location.href = globalOptions.loginUrl || '#/login';
+          },
+        });
+        return Promise.reject(new Error('登录超时'));
+      }
+
+      // 默认业务错误处理
+      if (!(config as RequestConfig).hideErrMsg) {
+        const msg = errMessage?.replace(/0:java.lang.Exception:/g, '') || '请求失败';
+        message.error({ content: msg });
+      }
+      return Promise.reject(new Error(errMessage || '请求失败'));
+    }
+
+    // 处理 result 结构
+    if (res.result) {
+      const { code, msg } = res.result;
+
+      // 成功
+      if (code >= 0) {
+        if (globalOptions.autoSuccessMsg && msg && code !== 1002 && !(config as RequestConfig).hideErrMsg) {
+          // code === 0 时保持静默，其它正数弹出成功提示
+          if (code !== 0) {
+            message.success({ content: msg });
+          }
+        }
+        return res;
+      }
+
+      // 失败
+      if (code < 0) {
+        if (!(config as RequestConfig).hideErrMsg) {
+          message.error({ content: msg || '操作失败' });
+        }
+        return Promise.reject(new Error(msg || '操作失败'));
+      }
+    }
+
+    return res;
+  },
+  (error: AxiosError) => {
+    const message = getMessage();
+    // 移除 pending
+    if (error.config) {
+      if (!isFormData(error.config.data)) {
+        removePending(error.config as InternalAxiosRequestConfig);
+      }
+    }
+
+    // 处理取消请求
+    if (axios.isCancel(error)) {
+      console.log('Request canceled', error.message);
+      return Promise.reject(error);
+    }
+
+    // 处理网络错误
+    const config = error.config as RequestConfig | undefined;
+    if (!config?.hideErrMsg) {
+      let msg = '请求异常';
+      if (error.message.includes('timeout')) msg = '请求超时';
+      if (error.message.includes('Network Error')) msg = '网络错误';
+      if (error.response?.status === 404) msg = '404';
+      if (error.response?.status === 500) msg = '服务器内部错误';
+
+      message.error({ content: msg });
+    }
+
+    return Promise.reject(error);
+  }
+);
+
+function isFormData(value: any) {
+  return Object.prototype.toString.call(value) === '[object FormData]';
+}
+
+export default request;

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 [Your Organization Name]
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/env.d.ts

@@ -1,7 +0,0 @@
-/// <reference types="vite/client" />
-
-declare module '*.vue' {
-  import type { DefineComponent } from 'vue'
-  const component: DefineComponent<{}, {}, any>
-  export default component
-}