修改了环境变量

README.md

@@ -336,25 +336,34 @@ npm link   # 本地调试
 - **SimApiVersion**：由 simapi 库构建时注入
 - **AppVersion**：不注入，留给调用方 APP 注入
 
+**支持的版本号环境变量（按优先级）：**
+
+1. `VITE_SimApiVersion` — Vite .env 文件
+2. `npm_config_SimApiVersion` — npm 构建时通过 `npm run build` 前设置
+3. `SimApiVersion` — 直接环境变量（如 GitHub Actions）
+
+未指定时默认为 `0.0.0-develop`。
+
 **本地构建：**
 
 ```bash
-# 通过环境变量注入 SimApiVersion
 # Windows PowerShell
 $env:npm_config_SimApiVersion='1.0.0'; npm run build
 
+# Windows CMD
+set npm_config_SimApiVersion=1.0.0 && npm run build
+
 # Linux/Mac
 npm_config_SimApiVersion=1.0.0 npm run build
 ```
 
-未指定时默认为 `0.0.0-develop`。
+**GitHub Actions / CI/CD：**
-
-**CI/CD 构建版本号：**
 
 ```yaml
-env:
+- name: Build
-  SimApiVersion: ${{ github.ref_name }}
+  env:
-run: npm run build
+    SimApiVersion: ${{ github.ref_name }}  # 或其他版本号
+  run: npm run build
 ```
 
 **调用方注入 AppVersion：**

vite.config.ts

@@ -31,8 +31,16 @@ export default defineConfig(({ mode }) => {
       }
     },
     define: {
-      // SimApiVersion 由环境变量注入
+      // SimApiVersion 由环境变量注入，支持：
-      'SimApiVersion': JSON.stringify(env.VITE_SimApiVersion || process.env.npm_config_SimApiVersion || '0.0.0-develop'),
+      // - VITE_SimApiVersion (Vite .env 文件)
+      // - npm_config_SimApiVersion (npm 构建时)
+      // - SimApiVersion (直接环境变量，如 GitHub Actions)
+      'SimApiVersion': JSON.stringify(
+        env.VITE_SimApiVersion || 
+        process.env.npm_config_SimApiVersion || 
+        process.env.SimApiVersion || 
+        '0.0.0-develop'
+      ),
     }
   }
 })