fix ci

.github/workflows/publish.yml

@@ -31,7 +31,7 @@ jobs:
         run: npm ci
 
       - name: Build
-        run: npm run build -- --define=$VERSION
+        run: npm run build -- --define SimApiVersion="'${{github.ref_name}}'"
 
       - name: Publish to npm
         run: npm publish --access public

AICONTEXT.md

@@ -54,10 +54,11 @@ SimApiBusinessCallback    // { [code]: (data) => void }，支持数字码或 'co
 - 改 Token 存储：替换 `localStorage` 为 `sessionStorage` 或内存变量，修改 `getToken()`/`setToken()`/`removeToken()`
 - 改登录/登出逻辑：修改 `login()`/`logout()` 方法
 - 改超时处理：修改 `fetchWithTimeout()` 函数
+- **版本管理**：版本号通过 `declare const` 声明常量，构建时通过 Vite 的 `define` 注入。未指定时默认为 `0.0.0-dev`
 
 **autoInit 设计约束**：
 
-- 仅读取 `window.simapi` 的三个顶级字段：`endpoints`、`defaultEndpoint`、`debug`
+- 仅读取 `window.simapi` 的顶级字段：`endpoints`、`defaultEndpoint`、`debug`、`uiAppVersion`
 - 业务回调（`businessCallback`/`responseCallback`）不支持从 window 读取，必须在代码中通过 `setBusinessCallback` 注册
 
 ---
@@ -105,6 +106,38 @@ npm run build
   → tsc -p tsconfig.build.json        输出 *.d.ts 类型声明
 ```
 
+**版本号注入：**
+
+版本号通过 `vite.core.config.ts` 的 `define` 配置注入，从 npm config 读取：
+
+```typescript
+define: {
+  'AppVersion': JSON.stringify(process.env.npm_config_AppVersion || '0.0.0-develop'),
+  'SimApiVersion': JSON.stringify(process.env.npm_config_SimApiVersion || '0.0.0-develop'),
+}
+```
+
+**本地构建示例：**
+```bash
+# 通过 npm config 传递（推荐）
+npm run build -- --AppVersion=1.0.0 --SimApiVersion=1.0.0
+
+# 或通过环境变量
+# Windows PowerShell
+$env:AppVersion="1.0.0"; $env:SimApiVersion="1.0.0"; npm run build
+
+# Linux/Mac
+AppVersion=1.0.0 SimApiVersion=1.0.0 npm run build
+```
+
+**GitHub Actions 自动发布：**
+```yaml
+env:
+  AppVersion: ${{ github.ref_name }}
+  SimApiVersion: ${{ github.ref_name }}
+run: npm run build
+```
+
 **dist 输出是平铺的**，core 和 pinia 的编译产物全部在同一目录：
 
 ```
@@ -136,3 +169,4 @@ dist/
 - **无 Cookie**：所有请求不发送 Cookie，Token 通过请求头传递
 - **零依赖**：不需要安装 axios，使用原生 fetch
 - 删除了 Angular 支持，如需恢复参考 git 历史
+- **版本号管理**：使用 `declare const` + Vite `define` 注入，不再需要 sed 替换脚本

README.md

@@ -105,7 +105,7 @@ await api.query('/stats', {}, 'admin')
 
 ## autoInit — 从 window 读取配置
 
-仅支持三个字段：`endpoints`、`defaultEndpoint`、`debug`。业务回调需在代码中通过 `setBusinessCallback` 处理。
+支持字段：`endpoints`、`defaultEndpoint`、`debug`、`uiAppVersion`。业务回调需在代码中通过 `setBusinessCallback` 处理。
 
 ```html
 <script>
@@ -153,6 +153,9 @@ interface SimApiOptions {
   /** 调试模式，默认 true */
   debug?: boolean
 
+  /** UI 应用版本，如果不指定则使用库内置的版本号 */
+  uiAppVersion?: string
+
   /** 认证相关配置 */
   auth?: Partial<SimApiAuthConfig>
 
@@ -305,21 +308,21 @@ api.configure({
 | 方法/属性 | 说明 |
 |-----------|------|
 | `configure(options)` | 批量配置（深合并） |
-| `autoInit()` | 从 `window.simapi` 读取配置（endpoints、defaultEndpoint、debug） |
-| `setEndpoints(map)` | 设置端点，自动触发版本检查 |
+| `autoInit()` | 从 `window.simapi` 读取配置（endpoints、defaultEndpoint、debug、uiAppVersion） |
+| `setEndpoints(map)` | 设置端点 |
 | `setBusinessCallback(code, fn)` | 注册业务错误码回调 |
-| `setDebug(debug)` | 设置调试模式 |
 | `query(uri, params?, endpointKey?, headers?)` | POST 请求，返回 `Promise<SimApiBaseResponse<T>>` |
 | `login(request)` | 登录，自动存 Token |
 | `logout(url?)` | 登出，清除 Token |
 | `checkLogin(url?)` | 主动检查登录状态 |
+| `getVersion(endpointName?)` | 获取版本信息，返回 `Promise<SimApiVersions>` |
 | `getToken()` | 获取 Token |
 | `setToken(token)` | 手动设置 Token |
 | `removeToken()` | 清除 Token |
 | `isLoggedIn` | getter，是否已登录 |
-| `token` | getter，获取当前 Token |
 | `debug` | boolean，调试模式 |
-| `versions` | 版本信息对象 |
+| `uiAppVersion` | UI 应用版本号（可选配置） |
+| `logDebug(...args)` | 日志工具（仅在 debug 模式输出） |
 
 ## 构建
 
@@ -329,6 +332,32 @@ npm run build
 npm link   # 本地调试
 ```
 
+### 版本号注入
+
+库使用 `declare const` 声明版本常量,构建时通过 Vite 的 `define` 注入版本号:
+
+**本地构建:**
+```bash
+# 通过 npm config 传递
+npm run build -- --AppVersion=1.0.0 --SimApiVersion=1.0.0
+
+# 或设置环境变量后构建
+# Windows PowerShell
+$env:AppVersion="1.0.0"; $env:SimApiVersion="1.0.0"; npm run build
+
+# Linux/Mac
+AppVersion=1.0.0 SimApiVersion=1.0.0 npm run build
+```
+
+**CI/CD 构建版本号:**
+```bash
+env:
+  AppVersion: ${{ github.ref_name }}
+  SimApiVersion: ${{ github.ref_name }}
+```
+
+如果未指定环境变量,版本号默认为 `0.0.0-develop`。
+
 ---
 
 ## 从旧版迁移

package.json

@@ -6,20 +6,17 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git@github.com:simcu/simapi-ts.git"
+    "url": "git@github.com:simcu/simapi-vue.git"
   },
   "keywords": [
     "simapi",
     "vue3",
     "pinia",
-    "rxjs",
     "http",
     "fetch"
   ],
   "files": [
     "dist",
-    "simapi.core.ts",
-    "simapi.pinia.ts",
     "README.md",
     "package.json"
   ],
@@ -49,7 +46,6 @@
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "@vitejs/plugin-vue": "^5.0.0",
     "pinia": "^2.2.0",
     "typescript": "~5.9.3",
     "vite": "^5.0.0",

src/simapi.core.ts

@@ -11,8 +11,6 @@
  */
 
 import {
-  AppVersion,
-  SimApiVersion,
   type SimApiVersions,
   type SimApiAuthConfig,
   type SimApiApiConfig,
@@ -20,7 +18,6 @@ import {
   type SimApiBaseResponse,
 } from './types'
 
-export { SimApiVersion, AppVersion } from './types'
 export type {
   SimApiVersions,
   SimApiAuthConfig,
@@ -29,6 +26,8 @@ export type {
   SimApiBaseResponse,
 } from './types'
 
+declare const AppVersion: string;
+declare const SimApiVersion: string;
 // ── Helper: Fetch with Timeout ────────────────────────────────────────
 
 function fetchWithTimeout(
@@ -78,8 +77,6 @@ async function fetchPost<T = any>(
 
 export class SimApiCore {
   debug: boolean = true
-  uiAppVersion?: string
-
   auth: SimApiAuthConfig = {
     token_name: 'simapi-auth-token',
     check_url: '/auth/check',
@@ -120,9 +117,6 @@ export class SimApiCore {
     if (config.debug !== undefined) {
       this.debug = config.debug
     }
-    if (config.uiAppVersion !== undefined) {
-      this.uiAppVersion = config.uiAppVersion
-    }
     if (config.endpoints) {
       this.api.endpoints = { ...this.api.endpoints, ...config.endpoints }
     }
@@ -135,9 +129,6 @@ export class SimApiCore {
     if (options.debug !== undefined) {
       this.debug = options.debug
     }
-    if (options.uiAppVersion !== undefined) {
-      this.uiAppVersion = options.uiAppVersion
-    }
     if (options.auth) {
       this.auth = { ...this.auth, ...options.auth }
     }
@@ -217,8 +208,8 @@ export class SimApiCore {
       if (resp?.data) {
         const d = resp.data
         const versions: SimApiVersions = {
-          uiApp: this.uiAppVersion ?? AppVersion,
-          uiSimApi: SimApiVersion,
+          uiApp: AppVersion ?? "0.0.0-develop",
+          uiSimApi: SimApiVersion ?? "0.0.0-develop",
           apiApp: d.App?.split('+')[0] ?? '0.0.0',
           apiSimApi: d.SimApi?.split('+')[0] ?? '0.0.0',
           apiAppFull: d.App ?? '0.0.0',
@@ -233,8 +224,8 @@ export class SimApiCore {
       // 版本获取失败返回默认值
     }
     return {
-      uiApp: AppVersion,
-      uiSimApi: SimApiVersion,
+      uiApp: "0.0.0-develop",
+      uiSimApi: "0.0.0-develop",
       apiApp: '0.0.0',
       apiSimApi: '0.0.0',
       apiAppFull: '0.0.0',

src/types.ts

@@ -2,10 +2,6 @@
  * SimApi 类型定义
  */
 
-// 版本号占位符，构建时由 GitHub Action 替换
-export const SimApiVersion = '0.0.0-version-placeholder'
-export const AppVersion = '0.0.0-version-placeholder'
-
 /** 版本信息 */
 export interface SimApiVersions {
   uiApp: string
@@ -56,7 +52,7 @@ export interface SimApiApiConfig {
 /** SimApi 完整配置 */
 export interface SimApiOptions {
   debug?: boolean
-  /** UI 应用版本，如果不指定则使用库内置的占位符版本 */
+  /** UI 应用版本，如果不指定则使用库内置的版本号 */
   uiAppVersion?: string
   auth?: Partial<SimApiAuthConfig>
   api?: Partial<SimApiApiConfig>