chore: release v1.1.8

zhaowenhao · zhaowenhao · commit 8059efadb2b7 · 2026-03-13T14:14:23.000+08:00
同步版本号到 1.1.8，补充 1.1.8 发版说明，更新忽略规则并准备 macOS 双架构发布产物。
diff --git a/.gitignore b/.gitignore
@@ -25,3 +25,5 @@ dist-ssr
 release
 dist-electron
 package-lock.json
+feature/
+CLAUDE.md
diff --git a/RELEASE_NOTES_1.1.8.md b/RELEASE_NOTES_1.1.8.md
@@ -0,0 +1,63 @@
+# Rest Code v1.1.8 发版说明
+
+## 版本概览
+
+v1.1.8 重点增强了 DSL 对标量类型的表达能力，并进一步统一了参数契约语法，降低脚本编写与代码生成时的歧义。
+
+## 主要变更
+
+### 1) 新增标量响应类型表达
+
+新增以下响应契约，支持直接表达标量结果：
+
+- `>#` → `Result<Long>`
+- `>$` → `Result<String>`
+- `>!` → `Result<Boolean>`
+- `>~` → `Result<BigDecimal>`
+
+同时支持对应 List 变体：
+
+- `>=#` → `Result<List<Long>>`
+- `>=$` → `Result<List<String>>`
+- `>=!` → `Result<List<Boolean>>`
+- `>=~` → `Result<List<BigDecimal>>`
+
+### 2) RequestBody 标量语法统一
+
+将历史表达迁移并统一为：
+
+- `@# / @$` → `@=# / @=$`
+
+并复用为单标量 RequestBody 的统一语法入口，减少同类场景下的记忆负担。
+
+### 3) 新增 Query 标量参数与数组表达
+
+新增 Query 标量参数：
+
+- `?!`（Boolean）
+- `?~`（BigDecimal）
+
+新增 Query 标量数组：
+
+- `?=# / ?=$ / ?=! / ?=~`
+
+用于更精确表达查询场景下的基础类型与集合类型输入。
+
+### 4) 语法细节修正
+
+- 修复 `@PathVariable` 语法，移除不必要引号，简化参数定义。
+- 同步更新文档示例，保证文档与实现一致。
+
+## 兼容性说明
+
+- 本次更新以 DSL 表达能力增强和语法统一为主。
+- 建议在升级后优先检查旧脚本中 `@# / @$` 的使用并迁移至 `@=# / @=$`。
+
+## 关联提交（节选）
+
+- `bd4f048` 新增标量响应类型、RequestBody 标量统一、Query 标量参数与数组表达
+- `ae9999a` 修复 `@PathVariable` 语法并更新示例
+
+---
+
+如在迁移过程中遇到兼容性问题，建议先用最小脚本验证单条契约，再逐步回归到完整业务脚本。
diff --git a/electron/main.ts b/electron/main.ts
@@ -1,15 +1,16 @@
-import { app, ipcMain, dialog, BrowserWindow, Menu, shell } from 'electron';
+import { app, ipcMain, dialog, BrowserWindow, Menu, shell } from "electron";
 import path from "path";
-import { fileURLToPath } from 'url';
-import https from 'https';
+import { fileURLToPath } from "url";
+import https from "https";
 
 // 重建 __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 // 应用版本和更新相关
-const CURRENT_VERSION = '1.1.7';
-const UPDATE_CHECK_URL = 'https://api.github.com/repos/dhslegen/rest-code/releases/latest';
+const CURRENT_VERSION = "1.1.8";
+const UPDATE_CHECK_URL =
+  "https://api.github.com/repos/dhslegen/rest-code/releases/latest";
 
 let win: BrowserWindow | null;
 
@@ -19,33 +20,33 @@ if (!gotTheLock) {
   app.quit();
 } else {
   // 当第二个实例启动时
-  app.on('second-instance', (_event, argv, _workingDirectory) => {
+  app.on("second-instance", (_event, argv, _workingDirectory) => {
     // 当运行第二个实例时，聚焦到主窗口
     if (win) {
       if (win.isMinimized()) win.restore();
       win.focus();
 
       // Windows 平台下，文件路径作为参数传递
-      if (process.platform === 'win32' && argv.length >= 2) {
+      if (process.platform === "win32" && argv.length >= 2) {
         const filePath = argv[argv.length - 1];
-        if (filePath && filePath.endsWith('.rcs')) {
-          win.webContents.send('open-file', filePath);
+        if (filePath && filePath.endsWith(".rcs")) {
+          win.webContents.send("open-file", filePath);
         }
       }
     }
   });
 
   // macOS 下处理 'open-file' 事件
-  app.on('open-file', (event, filePath) => {
+  app.on("open-file", (event, filePath) => {
     event.preventDefault();
     if (win) {
-      win.webContents.send('open-file', filePath);
+      win.webContents.send("open-file", filePath);
     } else {
       // 如果窗口尚未创建，等待窗口创建后再发送事件
       app.whenReady().then(() => {
         createWindow();
-        win!.webContents.once('did-finish-load', () => {
-          win!.webContents.send('open-file', filePath);
+        win!.webContents.once("did-finish-load", () => {
+          win!.webContents.send("open-file", filePath);
         });
       });
     }
@@ -55,11 +56,11 @@ if (!gotTheLock) {
     createWindow();
 
     // 应用启动时，处理传入的文件路径（Windows 平台）
-    if (process.platform === 'win32' && process.argv.length >= 2) {
+    if (process.platform === "win32" && process.argv.length >= 2) {
       const filePath = process.argv[process.argv.length - 1];
-      if (filePath && filePath.endsWith('.rcs')) {
-        win!.webContents.once('did-finish-load', () => {
-          win!.webContents.send('open-file', filePath);
+      if (filePath && filePath.endsWith(".rcs")) {
+        win!.webContents.once("did-finish-load", () => {
+          win!.webContents.send("open-file", filePath);
         });
       }
     }
@@ -75,19 +76,20 @@ function createWindow() {
     width: 1250,
     height: 925,
     frame: false, // 无边框窗口
-    titleBarStyle: process.platform === 'darwin' ? 'hiddenInset' : undefined, // macOS隐藏标题栏但保留交通灯
-    trafficLightPosition: process.platform === 'darwin' ? { x: 20, y: 15 } : undefined, // macOS交通灯位置，稍微
+    titleBarStyle: process.platform === "darwin" ? "hiddenInset" : undefined, // macOS隐藏标题栏但保留交通灯
+    trafficLightPosition:
+      process.platform === "darwin" ? { x: 20, y: 15 } : undefined, // macOS交通灯位置，稍微
     transparent: false, // 保持不透明，避免性能问题
-    vibrancy: process.platform === 'darwin' ? 'under-window' : undefined, // macOS毛玻璃效果
-    backgroundMaterial: process.platform === 'win32' ? 'acrylic' : undefined, // Windows亚克力效果
+    vibrancy: process.platform === "darwin" ? "under-window" : undefined, // macOS毛玻璃效果
+    backgroundMaterial: process.platform === "win32" ? "acrylic" : undefined, // Windows亚克力效果
     webPreferences: {
       preload: path.join(__dirname, "preload.mjs"),
       contextIsolation: true,
       allowRunningInsecureContent: false,
       nodeIntegration: true,
       // 禁用开发者工具
-      devTools: true
-    }
+      devTools: true,
+    },
   });
 
   Menu.setApplicationMenu(null);
@@ -103,7 +105,7 @@ function createWindow() {
   // 禁用快捷键支持开发者工具
   // win.webContents.on('before-input-event', (event, input) => {
   //   // F12 或 Cmd/Ctrl+Shift+I 打开开发者工具
-  //   if (input.key === 'F12' || 
+  //   if (input.key === 'F12' ||
   //       (input.control && input.shift && input.key === 'I') ||
   //       (input.meta && input.alt && input.key === 'I')) {
   //     win!.webContents.toggleDevTools();
@@ -115,7 +117,7 @@ function createWindow() {
   });
 
   // 窗口加载完成后进行自动更新检查
-  win.webContents.once('did-finish-load', () => {
+  win.webContents.once("did-finish-load", () => {
     // 延迟3秒后检查更新，避免影响启动速度
     setTimeout(() => {
       autoCheckForUpdates();
@@ -125,67 +127,80 @@ function createWindow() {
 
 ipcMain.handle("showSaveDialog", async () => {
   const { filePath } = await dialog.showSaveDialog({
-    filters: [{ name: "Rcs Files", extensions: ["rcs"] }]
+    filters: [{ name: "Rcs Files", extensions: ["rcs"] }],
   });
   return filePath;
 });
 
 ipcMain.handle("showOpenDialog", async (_event, options) => {
   const { filePaths, canceled } = await dialog.showOpenDialog({
-    ...options
+    ...options,
   });
   return { filePaths, canceled };
 });
 
-ipcMain.handle('appPath', () => {
+ipcMain.handle("appPath", () => {
   return app.getAppPath();
 });
 
 // 更新检查功能
-function checkForUpdates(): Promise<{ hasUpdate: boolean; latestVersion?: string; downloadUrl?: string; releaseNotes?: string }> {
+function checkForUpdates(): Promise<{
+  hasUpdate: boolean;
+  latestVersion?: string;
+  downloadUrl?: string;
+  releaseNotes?: string;
+}> {
   return new Promise((resolve) => {
-    console.log('开始检查更新，URL:', UPDATE_CHECK_URL);
-    const req = https.get(UPDATE_CHECK_URL, { headers: { 'User-Agent': 'Rest-Code' } }, (res) => {
-      let data = '';
-      res.on('data', (chunk) => data += chunk);
-      res.on('end', () => {
-        try {
-          const release = JSON.parse(data);
-          console.log('获取到发布信息:', release.tag_name, release.name);
-          const latestVersion = release.tag_name?.replace('v', '') || release.name;
-          const hasUpdate = compareVersions(latestVersion, CURRENT_VERSION) > 0;
-
-          console.log(`当前版本: ${CURRENT_VERSION}, 最新版本: ${latestVersion}, 需要更新: ${hasUpdate}`);
-
-          resolve({
-            hasUpdate,
-            latestVersion,
-            downloadUrl: release.html_url,
-            releaseNotes: release.body
-          });
-        } catch (error) {
-          console.error('解析更新信息失败:', error);
-          resolve({ hasUpdate: false });
-        }
-      });
-    });
+    console.log("开始检查更新，URL:", UPDATE_CHECK_URL);
+    const req = https.get(
+      UPDATE_CHECK_URL,
+      { headers: { "User-Agent": "Rest-Code" } },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          try {
+            const release = JSON.parse(data);
+            console.log("获取到发布信息:", release.tag_name, release.name);
+            const latestVersion =
+              release.tag_name?.replace("v", "") || release.name;
+            const hasUpdate =
+              compareVersions(latestVersion, CURRENT_VERSION) > 0;
+
+            console.log(
+              `当前版本: ${CURRENT_VERSION}, 最新版本: ${latestVersion}, 需要更新: ${hasUpdate}`,
+            );
+
+            resolve({
+              hasUpdate,
+              latestVersion,
+              downloadUrl: release.html_url,
+              releaseNotes: release.body,
+            });
+          } catch (error) {
+            console.error("解析更新信息失败:", error);
+            resolve({ hasUpdate: false });
+          }
+        });
+      },
+    );
 
-    req.on('error', (error) => {
-      console.error('检查更新失败:', error);
+    req.on("error", (error) => {
+      console.error("检查更新失败:", error);
       resolve({ hasUpdate: false });
     });
 
     req.setTimeout(10000, () => {
-      console.log('更新检查超时');
+      console.log("更新检查超时");
       req.destroy();
       resolve({ hasUpdate: false });
     });
   });
 }
 
 function compareVersions(version1: string, version2: string): number {
-  const v1parts = version1.split('.').map(Number);
-  const v2parts = version2.split('.').map(Number);
+  const v1parts = version1.split(".").map(Number);
+  const v2parts = version2.split(".").map(Number);
 
   for (let i = 0; i < Math.max(v1parts.length, v2parts.length); i++) {
     const v1part = v1parts[i] || 0;
@@ -205,24 +220,24 @@ async function autoCheckForUpdates() {
       // 添加当前版本号到更新信息中
       const updateDataWithCurrentVersion = {
         ...updateInfo,
-        currentVersion: CURRENT_VERSION
+        currentVersion: CURRENT_VERSION,
       };
-      win.webContents.send('update-available', updateDataWithCurrentVersion);
+      win.webContents.send("update-available", updateDataWithCurrentVersion);
     }
   } catch (error) {
     // 静默失败，不显示错误
-    console.error('检查更新失败:', error);
+    console.error("检查更新失败:", error);
   }
 }
 
 // 窗口控制IPC处理器
-ipcMain.handle('minimize-window', () => {
+ipcMain.handle("minimize-window", () => {
   if (win && !win.isDestroyed()) {
     win.minimize();
   }
 });
 
-ipcMain.handle('maximize-window', () => {
+ipcMain.handle("maximize-window", () => {
   if (win && !win.isDestroyed()) {
     if (win.isMaximized()) {
       win.unmaximize();
@@ -232,21 +247,21 @@ ipcMain.handle('maximize-window', () => {
   }
 });
 
-ipcMain.handle('close-window', () => {
+ipcMain.handle("close-window", () => {
   if (win && !win.isDestroyed()) {
     win.close();
   }
 });
 
 // 更新检查IPC处理器
-ipcMain.handle('check-for-updates', async () => {
+ipcMain.handle("check-for-updates", async () => {
   return await checkForUpdates();
 });
 
-ipcMain.handle('get-current-version', () => {
+ipcMain.handle("get-current-version", () => {
   return CURRENT_VERSION;
 });
 
-ipcMain.handle('open-download-page', (_, url: string) => {
+ipcMain.handle("open-download-page", (_, url: string) => {
   shell.openExternal(url);
-});
+});
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "rest-code",
   "private": true,
-  "version": "1.1.7",
+  "version": "1.1.8",
   "author": "zhaowenhao<https://dahaoshen.com>",
   "description": "Rest Code 是一款基于 Electron 的自动化工具，用于通过简洁的脚本快速生成 REST API 后端代码。",
   "license": "Apache-2.0",
diff --git a/src/App.vue b/src/App.vue
@@ -260,8 +260,8 @@
               <div class="card-content">
                 <label>当前版本</label>
                 <a href="javascript:void(0)"
-                  @click="openLink('https://github.com/dhslegen/rest-code/releases/tag/v1.1.7')" class="link-btn">
-                  v1.1.7
+                  @click="openLink('https://github.com/dhslegen/rest-code/releases/tag/v1.1.8')" class="link-btn">
+                  v1.1.8
                 </a>
               </div>
             </div>

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "rest-code",`
`3`	`3`	`"private": true,`
`4`		`- "version": "1.1.7",`
	`4`	`+ "version": "1.1.8",`
`5`	`5`	`"author": "zhaowenhao<https://dahaoshen.com>",`
`6`	`6`	`"description": "Rest Code 是一款基于 Electron 的自动化工具，用于通过简洁的脚本快速生成 REST API 后端代码。",`
`7`	`7`	`"license": "Apache-2.0",`