devject-design 0.1.1 → 0.1.2

package/README.md

@@ -35,6 +35,41 @@ npm install vue element-plus
 npm install xlsx
 ```
 
+## 环境变量配置
+
+本库支持通过环境变量配置上传和下载接口。由于这是一个 npm 包，你需要在使用此包的宿主工程（Host Project）的构建配置中注入这些变量。
+
+### 变量说明
+
+| 变量名 | 说明                                           | 默认值 |
+| :--- |:---------------------------------------------| :--- |
+| `VITE_DEVJECT_UPLOAD_URL` | 文件上传接口地址                                     |  |
+| `VITE_DEVJECT_DOWNLOAD_URL` | 文件下载/访问基础路径                                  |  |
+| `VITE_DEVJECT_UPLOAD_PARSE` | 上传响应解析路径 (例如 `data.url`,即为response.data.url) | `data` |
+
+### 在 Vite 项目中配置
+
+在你的 `vite.config.ts` 中使用 `define` 选项注入这些变量：
+
+```typescript
+import { defineConfig, loadEnv } from 'vite'
+
+export default defineConfig(({ mode }) => {
+  // 加载环境变量
+  const env = loadEnv(mode, process.cwd(), '')
+  
+  return {
+    define: {
+      // 注入环境变量供 devject-design 使用
+      'process.env.VITE_DEVJECT_UPLOAD_URL': JSON.stringify(env.VITE_DEVJECT_UPLOAD_URL),
+      'process.env.VITE_DEVJECT_DOWNLOAD_URL': JSON.stringify(env.VITE_DEVJECT_DOWNLOAD_URL),
+      'process.env.VITE_DEVJECT_UPLOAD_PARSE': JSON.stringify(env.VITE_DEVJECT_UPLOAD_PARSE),
+    },
+    // ... 其他配置
+  }
+})
+```
+
 ## 快速开始
 
 ### 引入样式