@xmszm/core 0.0.1 → 0.0.2

package/dist/style.css

@@ -1 +1 @@
-.filter-box[data-v-2aba8b9e]{padding:20px;margin:-16px -28px -20px;box-sizing:border-box}.filter-main[data-v-2aba8b9e]{display:flex;align-content:flex-start;flex-wrap:wrap;min-height:500px;max-height:700px;overflow-y:auto;row-gap:20px;padding:0 0 15px;box-sizing:border-box}.filter-main .filter-item[data-v-2aba8b9e]{--info-color: var(--e0ecc754);--n-border-checked: 1px solid var(--info-color) !important;--n-border-focus: 1px solid var(--info-color) !important;--n-color-checked: var(--info-color) !important;--n-box-shadow-focus: 0 0 0 2px #6a1f7403 !important;width:calc(100% / 3)}.filter-footer[data-v-2aba8b9e]{display:flex;justify-content:space-between;align-items:center}.filter-footer .submit-btn[data-v-2aba8b9e]{width:80px}[data-v-8fbdfcbb] .n-data-table-tr--summary{position:sticky;bottom:0;left:0;right:0;z-index:2}[data-v-8fbdfcbb] .n-data-table-tr--summary .n-data-table-td--summary{border-top:1px solid var(--n-merged-border-color)}.upload-box[data-v-54e2cc87]{width:auto}.upload-box[data-v-54e2cc87] .n-upload-file-list.n-upload-file-list--grid{display:flex;flex-wrap:wrap}.upload-box[data-v-54e2cc87] .n-upload-file.n-upload-file--image-card-type{width:var(--image-w);height:var(--image-h)}.upload-box[data-v-54e2cc87] .n-upload-file.n-upload-file--image-card-type .n-image img{object-fit:var(--image-mode)!important}.upload-box[data-v-54e2cc87] .n-upload-trigger--image-card{width:var(--image-w);height:var(--image-h)}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover) .n-upload-file-info,.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover) .n-upload-file-info{position:relative}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover) .n-upload-file-info:after,.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover) .n-upload-file-info:after{content:"";position:absolute;top:0;left:0;right:0;bottom:0;z-index:5;display:block;background-color:#0006}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover):after{font-size:12px;white-space:nowrap;content:"上传失败~";position:absolute;color:#ffffffbf;top:50%;left:50%;transform:translate(-50%,-50%);z-index:5;display:block}.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover):after{font-size:12px;white-space:nowrap;content:"加载中~";position:absolute;color:#ffffffbf;top:50%;left:50%;transform:translate(-50%,-50%);z-index:5;display:block}.svg-icon[data-v-9dbe5f10]{width:inherit;height:inherit;fill:currentColor;vertical-align:middle}.core-dialog-main,.core-dialog-content{box-sizing:border-box;display:flex;align-items:flex-start}.core-dialog-main{min-height:300px}.core-dialog .n-dialog__content{overflow-y:auto;margin:10px -28px 0;box-sizing:border-box;flex:1;border-top:1px solid #91919147;border-bottom:1px solid #91919147;padding:28px}.core-dialog .n-dialog__action{padding:20px 0 0;box-sizing:border-box}.core-dialog-read .n-dialog__content{border-bottom:unset}.select-text[data-v-a0acb8e2]{min-width:100px;max-width:240px;text-align:center}.select-line-text[data-v-a0acb8e2]{text-align:center;white-space:nowrap;display:inline}
+.filter-box[data-v-2aba8b9e]{padding:20px;margin:-16px -28px -20px;box-sizing:border-box}.filter-main[data-v-2aba8b9e]{display:flex;align-content:flex-start;flex-wrap:wrap;min-height:500px;max-height:700px;overflow-y:auto;row-gap:20px;padding:0 0 15px;box-sizing:border-box}.filter-main .filter-item[data-v-2aba8b9e]{--info-color: var(--e0ecc754);--n-border-checked: 1px solid var(--info-color) !important;--n-border-focus: 1px solid var(--info-color) !important;--n-color-checked: var(--info-color) !important;--n-box-shadow-focus: 0 0 0 2px #6a1f7403 !important;width:calc(100% / 3)}.filter-footer[data-v-2aba8b9e]{display:flex;justify-content:space-between;align-items:center}.filter-footer .submit-btn[data-v-2aba8b9e]{width:80px}[data-v-d6710561] .n-data-table-tr--summary{position:sticky;bottom:0;left:0;right:0;z-index:2}[data-v-d6710561] .n-data-table-tr--summary .n-data-table-td--summary{border-top:1px solid var(--n-merged-border-color)}.upload-box[data-v-54e2cc87]{width:auto}.upload-box[data-v-54e2cc87] .n-upload-file-list.n-upload-file-list--grid{display:flex;flex-wrap:wrap}.upload-box[data-v-54e2cc87] .n-upload-file.n-upload-file--image-card-type{width:var(--image-w);height:var(--image-h)}.upload-box[data-v-54e2cc87] .n-upload-file.n-upload-file--image-card-type .n-image img{object-fit:var(--image-mode)!important}.upload-box[data-v-54e2cc87] .n-upload-trigger--image-card{width:var(--image-w);height:var(--image-h)}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover) .n-upload-file-info,.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover) .n-upload-file-info{position:relative}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover) .n-upload-file-info:after,.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover) .n-upload-file-info:after{content:"";position:absolute;top:0;left:0;right:0;bottom:0;z-index:5;display:block;background-color:#0006}.upload-box[data-v-54e2cc87] .n-upload-file--error-status:not(:hover):after{font-size:12px;white-space:nowrap;content:"上传失败~";position:absolute;color:#ffffffbf;top:50%;left:50%;transform:translate(-50%,-50%);z-index:5;display:block}.upload-box[data-v-54e2cc87] .n-upload-file--info-status:not(:hover):after{font-size:12px;white-space:nowrap;content:"加载中~";position:absolute;color:#ffffffbf;top:50%;left:50%;transform:translate(-50%,-50%);z-index:5;display:block}.svg-icon[data-v-9dbe5f10]{width:inherit;height:inherit;fill:currentColor;vertical-align:middle}.core-dialog-main,.core-dialog-content{box-sizing:border-box;display:flex;align-items:flex-start}.core-dialog-main{min-height:300px}.core-dialog .n-dialog__content{overflow-y:auto;margin:10px -28px 0;box-sizing:border-box;flex:1;border-top:1px solid #91919147;border-bottom:1px solid #91919147;padding:28px}.core-dialog .n-dialog__action{padding:20px 0 0;box-sizing:border-box}.core-dialog-read .n-dialog__content{border-bottom:unset}.select-text[data-v-6ef17b7a]{min-width:100px;max-width:240px;text-align:center}.select-line-text[data-v-6ef17b7a]{text-align:center;white-space:nowrap;display:inline}

package/docs/.vitepress/config.mjs

@@ -0,0 +1,82 @@
+import { defineConfig } from 'vitepress'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+export default defineConfig({
+  title: '@xmszm/core',
+  description: 'naiveui core 组件与工具库 - Vue 3 + Naive UI 的表单、表格、弹窗与工具集合',
+  lang: 'zh-CN',
+  lastUpdated: true,
+  base: '/core/',
+  themeConfig: {
+    nav: [
+      { text: '首页', link: '/' },
+      { text: '指南', link: '/guide/quickstart' },
+      { text: '组件', link: '/components/dataform' },
+      { text: '工具', link: '/components/utils' },
+      { text: '示例 Demo', link: '/guide/demo' },
+    ],
+    sidebar: {
+      '/guide/': [
+        {
+          text: '指南',
+          items: [
+            { text: '快速开始', link: '/guide/quickstart' },
+            { text: '配置指南', link: '/guide/config' },
+            { text: '本地开发', link: '/guide/local-development' },
+            { text: '示例 Demo 说明', link: '/guide/demo' },
+          ],
+        },
+      ],
+      '/components/': [
+        {
+          text: '表单',
+          items: [
+            { text: 'DataForm', link: '/components/dataform' },
+            { text: 'Options（动态项）', link: '/components/options' },
+            { text: 'CommonQuery', link: '/components/query' },
+          ],
+        },
+        {
+          text: '表格',
+          items: [{ text: 'DataTable', link: '/components/datatable' }],
+        },
+        {
+          text: '弹窗',
+          items: [{ text: 'commonDialogMethod', link: '/components/dialog' }],
+        },
+        {
+          text: '工具',
+          items: [
+            { text: '操作列/排序/省略', link: '/components/utils' },
+            { text: '上传', link: '/components/utils#上传工具' },
+            { text: '权限与路由', link: '/components/utils#权限与路由' },
+          ],
+        },
+      ],
+    },
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/xmszm/core' },
+    ],
+    outline: [2, 3],
+    docFooter: {
+      prev: '上一页',
+      next: '下一页',
+    },
+    footer: {
+      message: 'Released under the UNLICENSED License.',
+      copyright: 'Copyright © 2024-present',
+    },
+  },
+  vite: {
+    resolve: {
+      alias: {
+        '@xmszm/core': path.resolve(__dirname, '../../src'),
+        core: path.resolve(__dirname, '../../src'),
+        '@': path.resolve(__dirname, '../../src'),
+      },
+    },
+  },
+})

package/docs/components/dataform.md

@@ -8,7 +8,7 @@ title: DataForm
 ```vue
 <script setup>
 import { ref } from 'vue'
-import { DataForm } from 'core'
+import { DataForm } from '@xmszm/core'
 
 const model = ref({})
 const options = [

package/docs/components/datatable.md

@@ -8,7 +8,7 @@ title: DataTable
 ```vue
 <script setup>
 import { ref } from 'vue'
-import { DataTable } from 'core'
+import { DataTable } from '@xmszm/core'
 
 const columns = [
   { title: '名称', key: 'name', width: 160 },
@@ -29,20 +29,21 @@ const data = ref([
 - `data: Array` 数据源。
 - `columns: Array` 列定义，支持 `label`/`title`、`key`、`width`、`ellipsis`、`sorter` 等。
 - `pagination: Object | null` 透传 `n-data-table` 分页。
-- `oprColumns: Object | null` 右侧操作列配置。
-- `selectColumns: Object | null` 选择列。
-- `defaultColumns: Array` 默认可见列键。
-- `summaryColumns: Function` 汇总行。
+- `oprColumns: Object | null` 右侧操作列配置（模板中使用 `opr-columns`）。
+- `selectColumns: Object | null` 选择列（模板中使用 `select-columns`）。
+- `defaultColumns: Array` 默认可见列键（模板中使用 `default-columns`）。
+- `summaryColumns: Function` 汇总行（模板中使用 `summary-columns`）。
 - `isFilter: boolean` 是否启用列筛选。
 - `isEllipsis: boolean` 默认开启省略，使用内置 `ellipsis` tooltip。
 - `virtual: boolean` 虚拟滚动，默认数据量大时自动开启。
+- `rowKey: Function | String` 行键，用于标识每一行数据。
 
 ## 排序（orderEnum 内置工具）
 `orderEnum` 专为 `DataTable` 列排序提供，离开表格场景单独调用无意义。
 
 用法示例（结合后端查询参数与分页刷新）：
-```js
-import { orderEnum } from 'core'
+```javascript
+import { orderEnum } from '@xmszm/core'
 
 const listQuery = reactive({ sortFieldName: '', desc: false })
 const pageState = {
@@ -68,10 +69,46 @@ const columns = [
 - 弹窗使用 `FilterDialog` 组件记录用户选择，结果存储于 `localStorage`，Key 为 `filter_key + 路由全路径`。
 
 ## 省略
-- 默认对列开启 `ellipsis`，使用 `core/table/utils/ellipsis` 配置 tooltip 样式。
+- 默认对列开启 `ellipsis`，使用 `@xmszm/core/table/utils/ellipsis` 配置 tooltip 样式。
 - 可通过列的 `ellipsisProp` 自定义。
 
 ## 操作列
 - 可搭配 `createActionColumnJsx` 快速生成操作列，或直接传入 `oprColumns`。
 - `useDataColumnButton` / `useDataColumnPop` 组合了按钮与二次确认的通用场景。
 
+### 使用示例
+
+```vue
+<script setup>
+import { DataTable, createActionColumnJsx } from '@xmszm/core'
+
+const columns = [
+  { title: '名称', key: 'name', width: 160 },
+  { title: '类型', key: 'type', width: 120 },
+]
+
+const opr = createActionColumnJsx([
+  {
+    label: '编辑',
+    type: 'primary',
+    onClick: (row) => handleEdit(row),
+  },
+  {
+    label: '删除',
+    type: 'error',
+    mode: 'pop',
+    onClick: (row) => handleDelete(row),
+  },
+])
+</script>
+
+<template>
+  <DataTable
+    :data="tableData"
+    :columns="columns"
+    :opr-columns="opr"
+    :row-key="row => row?.id"
+  />
+</template>
+```
+

package/docs/components/dialog.md

@@ -6,8 +6,8 @@ title: commonDialogMethod
 
 ## 基础用法（用函数包裹触发）
 `commonDialogMethod` 调用即会创建并打开弹窗，推荐用一个函数包裹，在需要时再触发：
-```js
-import { commonDialogMethod } from 'core'
+```javascript
+import { commonDialogMethod } from '@xmszm/core'
 
 function openEditDialog(row) {
   const { cancel, model } = commonDialogMethod(
@@ -54,7 +54,7 @@ openEditDialog(currentRow)
 - `modeEnum` 默认模式枚举。
 
 ## 自定义动作
-```js
+```javascript
 commonDialogMethod({
   action: [
     { label: '关闭', mode: 'cancel' },

package/docs/components/options.md

@@ -8,7 +8,7 @@ title: Options（动态项渲染）
 ```vue
 <script setup>
 import { ref } from 'vue'
-import { Options } from 'core'
+import { Options } from '@xmszm/core'
 
 const model = ref({})
 const formRef = ref()

package/docs/components/query.md

@@ -8,7 +8,7 @@ title: CommonQuery
 ```vue
 <script setup>
 import { ref } from 'vue'
-import { CommonQuery } from 'core'
+import { CommonQuery } from '@xmszm/core'
 
 const query = ref({})
 const options = [
@@ -22,7 +22,53 @@ function onSubmit() {
 </script>
 
 <template>
-  <CommonQuery v-model:query="query" :options="options" @submit="onSubmit" />
+  <CommonQuery v-model:query="query" :options="options" @submit="onSubmit" @reset="onReset" />
+</template>
+```
+
+### 完整示例（结合分页）
+
+```vue
+<script setup>
+import { reactive } from 'vue'
+import { CommonQuery } from '@xmszm/core'
+
+const listQuery = reactive({
+  page: 1,
+  pageSize: 10,
+  likeQuery: {
+    keyword: '',
+    type: '',
+  },
+})
+
+const queryOptions = [
+  { label: '关键词', key: 'keyword', queryType: 'likeQuery', way: 'input' },
+  { label: '类型', key: 'type', queryType: 'likeQuery', way: 'select', options: [
+    { label: '类型A', value: 'A' },
+    { label: '类型B', value: 'B' }
+  ]},
+]
+
+function handleSearch() {
+  listQuery.page = 1
+  fetchData()
+}
+
+function handleReset() {
+  listQuery.likeQuery = { keyword: '', type: '' }
+  listQuery.page = 1
+  fetchData()
+}
+</script>
+
+<template>
+  <CommonQuery
+    :query="listQuery"
+    :options="queryOptions"
+    @submit="handleSearch"
+    @reset="handleReset"
+  />
 </template>
 ```
 

package/docs/components/utils.md

@@ -7,8 +7,8 @@ title: 工具与常量
 ### createActionColumnJsx
 快速生成表格操作列。
 
-```js
-import { createActionColumnJsx } from 'core'
+```javascript
+import { createActionColumnJsx } from '@xmszm/core'
 
 const oprColumn = createActionColumnJsx(
   [
@@ -27,13 +27,13 @@ const oprColumn = createActionColumnJsx(
 
 ### ellipsis
 表格省略 tooltip 配置：
-```js
-import { ellipsis } from 'core/table/utils/ellipsis'
+```javascript
+import { ellipsis } from '@xmszm/core/table/utils/ellipsis'
 ```
 
 ## 上传工具
-```js
-import { registryUpload, customUpload, getFileUrl } from 'core'
+```javascript
+import { registryUpload, customUpload, getFileUrl } from '@xmszm/core'
 
 registryUpload((config) => axios.request(config)) // 注册实际上传实现
 await customUpload({ url: '/upload', data: file })

package/docs/guide/config.md

@@ -0,0 +1,178 @@
+# 配置指南
+
+## 统一配置系统
+
+`@xmszm/core` 提供了统一的配置系统，用于管理外部依赖和业务配置。
+
+## 初始化配置
+
+在应用启动时，使用 `setupConfig` 进行统一配置：
+
+```javascript
+import { setupConfig } from '@xmszm/core'
+import axios from 'axios'
+
+// 初始化配置
+setupConfig({
+  // API 基础地址（用于文件 URL 拼接）
+  baseURL: 'https://api.example.com',
+  
+  // 权限检查函数
+  hasPermission: (permission) => {
+    // 你的权限检查逻辑
+    const permissions = getPermissions() // 从 store、context 等获取权限列表
+    return permissions.includes(permission)
+  },
+  
+  // 上传方法
+  uploadMethod: (config) => {
+    // 你的上传实现
+    return axios.request(config)
+  }
+})
+```
+
+## 配置项说明
+
+### baseURL
+
+API 基础地址，用于 `getFileUrl` 函数拼接文件 URL。
+
+```javascript
+import { setupConfig, getFileUrl } from '@xmszm/core'
+
+setupConfig({
+  baseURL: 'https://api.example.com'
+})
+
+// 使用
+const url = getFileUrl('/images/avatar.jpg')
+// => 'https://api.example.com/images/avatar.jpg'
+```
+
+### hasPermission
+
+权限检查函数，用于表格操作列的权限过滤。
+
+```javascript
+import { setupConfig } from '@xmszm/core'
+
+setupConfig({
+  hasPermission: (permission) => {
+    // 从 Vuex/Pinia store 获取权限
+    const store = useStore()
+    return store.state.permissions.includes(permission)
+    
+    // 或从 localStorage 获取
+    // const permissions = JSON.parse(localStorage.getItem('permissions') || '[]')
+    // return permissions.includes(permission)
+  }
+})
+
+// 在 createActionColumnJsx 中使用
+const opr = createActionColumnJsx([
+  {
+    label: '编辑',
+    permission: 'user:edit', // 会调用 hasPermission('user:edit')
+    onClick: (row) => edit(row)
+  }
+])
+```
+
+### uploadMethod
+
+上传方法实现，用于 `customUpload` 函数。
+
+```javascript
+import { setupConfig, customUpload } from '@xmszm/core'
+import axios from 'axios'
+
+setupConfig({
+  uploadMethod: (config) => {
+    return axios.request({
+      ...config,
+      headers: {
+        'Authorization': `Bearer ${getToken()}`,
+        ...config.headers
+      }
+    })
+  }
+})
+
+// 使用
+await customUpload({
+  url: '/upload',
+  method: 'POST',
+  data: formData
+})
+```
+
+## 兼容旧版 API
+
+为了向后兼容，仍然支持旧的 API：
+
+```javascript
+import { registryUpload } from '@xmszm/core'
+
+// 旧版方式（仍然可用，但不推荐）
+registryUpload((config) => axios.request(config))
+```
+
+## 获取配置
+
+如果需要获取当前配置：
+
+```javascript
+import { getConfig, getBaseURL, getHasPermission, getUploadMethod } from '@xmszm/core'
+
+// 获取所有配置
+const config = getConfig()
+
+// 获取单个配置
+const baseURL = getBaseURL()
+const hasPermission = getHasPermission()
+const uploadMethod = getUploadMethod()
+```
+
+## 完整示例
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import { setupConfig } from '@xmszm/core'
+import App from './App.vue'
+import axios from 'axios'
+import { useStore } from './store'
+
+const app = createApp(App)
+
+// 配置库
+setupConfig({
+  baseURL: import.meta.env.VITE_API_BASE_URL || 'http://localhost:3000',
+  
+  hasPermission: (permission) => {
+    const store = useStore()
+    return store.state.user.permissions?.includes(permission) ?? false
+  },
+  
+  uploadMethod: (config) => {
+    return axios.request({
+      ...config,
+      headers: {
+        'Authorization': `Bearer ${localStorage.getItem('token')}`,
+        ...config.headers
+      }
+    })
+  }
+})
+
+app.mount('#app')
+```
+
+## 注意事项
+
+1. **配置时机**：建议在应用启动时（如 `main.js`）进行配置
+2. **权限检查**：如果未配置 `hasPermission`，默认返回 `true`（会显示警告）
+3. **BASE_URL**：如果未配置 `baseURL`，`getFileUrl` 会返回原始 URL（会显示警告）
+4. **上传方法**：如果未配置 `uploadMethod`，调用 `customUpload` 会抛出错误
+

package/docs/guide/demo.md

@@ -14,7 +14,7 @@ npm install
 ```
 
 2) 在你的宿主工程中引入该组件文件（或复制内容），确保存在以下 alias：
-```js
+```javascript
 // vite / webpack 示例
 resolve: {
   alias: {
@@ -55,7 +55,7 @@ import {
   CommonQuery,
   createActionColumnJsx,
   DataTable,
-} from 'core'
+} from '@xmszm/core'
 
 // 列表数据与查询管理
 const { pageState, listQuery } = useNaivePage(() => {

package/docs/guide/local-development.md

@@ -0,0 +1,109 @@
+# 本地开发配置
+
+## npm/pnpm link 时的路径解析问题
+
+当使用 `npm link` 或 `pnpm link` 进行本地开发时，Vite 可能无法正确解析链接包的路径。这是因为：
+
+1. **符号链接解析问题**：npm/pnpm link 创建的是符号链接，Vite 的模块解析在处理符号链接时可能失败
+2. **package.json exports**：链接包的 `exports` 字段路径解析可能不生效
+3. **CSS 文件路径**：样式文件的路径解析尤其容易出问题
+
+## 最小化配置方案
+
+在测试项目的 `vite.config.js` 中添加以下配置即可：
+
+```javascript
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import vueJsx from '@vitejs/plugin-vue-jsx'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [vue(), vueJsx()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, 'src'),
+      // 解决 npm/pnpm link 时的路径解析问题
+      '@xmszm/core': path.resolve(__dirname, '..'), // 指向库项目根目录
+      '@xmszm/core/dist/style.css': path.resolve(__dirname, '../dist/style.css'),
+    },
+  },
+  server: {
+    port: 3000,
+    open: true
+  }
+})
+```
+
+## 为什么需要这个配置？
+
+### 问题 1: 模块无法解析
+
+**错误信息**：
+```
+Failed to resolve import "@xmszm/core" from "src/App.vue"
+```
+
+**原因**：
+- npm/pnpm link 创建的符号链接路径可能无法被 Vite 正确识别
+- 链接路径如 `link:C:/Users/admin/AppData/Local/pnpm/global/5/node_modules/@xmszm/core` 可能解析失败
+
+**解决方案**：
+```javascript
+'@xmszm/core': path.resolve(__dirname, '..')
+```
+直接指向源项目根目录，绕过符号链接解析问题。
+
+### 问题 2: 样式文件无法解析
+
+**错误信息**：
+```
+Failed to resolve import "@xmszm/core/dist/style.css"
+```
+
+**原因**：
+- CSS 文件的路径解析在链接包中更容易失败
+- `exports` 字段对 CSS 文件的处理可能不一致
+
+**解决方案**：
+```javascript
+'@xmszm/core/dist/style.css': path.resolve(__dirname, '../dist/style.css')
+```
+直接指向源项目的样式文件。
+
+## 生产环境使用
+
+在生产环境中（通过 npm 安装），**不需要**这些配置，因为：
+
+1. 正常安装的包路径解析没有问题
+2. `package.json` 的 `exports` 字段会正确工作
+3. Vite 可以正确解析 `node_modules` 中的包
+
+## 完整示例
+
+```javascript
+// vite.config.js
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import vueJsx from '@vitejs/plugin-vue-jsx'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [vue(), vueJsx()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, 'src'),
+      // 仅在使用 npm/pnpm link 时需要
+      '@xmszm/core': path.resolve(__dirname, '..'),
+      '@xmszm/core/dist/style.css': path.resolve(__dirname, '../dist/style.css'),
+    },
+  },
+})
+```
+
+## 注意事项
+
+1. **仅本地开发需要**：这个配置只在本地开发（使用 link）时需要
+2. **相对路径**：`path.resolve(__dirname, '..')` 假设测试项目在库项目的 `test-app` 目录下
+3. **路径调整**：如果目录结构不同，需要相应调整路径
+

package/docs/guide/quickstart.md

@@ -5,17 +5,21 @@ title: 快速开始
 ## 安装
 
 ```bash
-npm install core
+npm install @xmszm/core
+# 或
+pnpm add @xmszm/core
+# 或
+yarn add @xmszm/core
 ```
 
 同时请在项目中安装（或确保已存在）以下 peer 依赖（版本可按你项目统一）：
 
-- vue 3.x
-- naive-ui
-- vue-router
-- dayjs
-- lodash-es
-- @vicons/ionicons5
+- `vue` >= 3.3.0
+- `naive-ui` >= 2.38.0
+- `vue-router` >= 4.2.0
+- `dayjs` >= 1.11.0
+- `lodash-es` >= 4.17.21
+- `@vicons/ionicons5` >= 0.13.0
 
 > 若项目使用 `@` 路径别名，请确认在构建/运行配置中存在相同的 alias。
 
@@ -24,8 +28,8 @@ npm install core
 ```vue
 <script setup>
 import { ref } from 'vue'
-import { DataForm, DataTable, commonDialogMethod } from 'core'
-import 'core/dist/style.css' // 如需默认样式
+import { DataForm, DataTable, commonDialogMethod } from '@xmszm/core'
+import '@xmszm/core/dist/style.css' // 如需默认样式
 
 const formValue = ref({})
 const formOptions = [
@@ -62,7 +66,7 @@ function openDialog() {
 
 ## 目录结构建议
 
-```
+```text
 docs/                # VitePress 文档
 examples/demo.vue    # 可运行的最小示例
 src/                 # 组件与工具源码
@@ -72,6 +76,6 @@ types/               # 类型定义
 ## 常见问题
 
 - 找不到 `@/utils/...`：请在宿主项目配置 `@` 别名或提供对应实现。
-- 样式缺失：如需库内 less 默认样式，确保引入 `core/dist/style.css`。
+- 样式缺失：如需库内 less 默认样式，确保引入 `@xmszm/core/dist/style.css`。
 - TS 类型：库内已内置 `types/index.d.ts`，可直接获得基础提示。
 

package/docs/index.md

@@ -1,8 +1,8 @@
 ---
 layout: home
-title: Nex Core
+title: '@xmszm/core'
 hero:
-  name: Nex Core
+  name: '@xmszm/core'
   text: Vue 3 + Naive UI 的表单、表格、弹窗与工具集合
   tagline: 开箱即用的配置式表单与表格方案，内置弹窗、上传、权限、路由工具。
   actions: