autosnippet 2.8.3 → 2.10.0

package/lib/infrastructure/external/XcodeAutomation.js

@@ -1,18 +1,50 @@
 /**
- * XcodeAutomation - Xcode AppleScript 自动化
+ * XcodeAutomation — Xcode AppleScript 自动化
  *
- * 提供 Xcode 行操作：跳转行、选中行、剪切行、粘贴等。
- * 所有操作都带超时保护，Xcode 未运行时默认跳过。
+ * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
+ *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
  *
- * V2 ESM 版本，对应 V1 SearchHandler/CreateHandler 中的散落 AppleScript 逻辑。
+ * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
+ * 仅支持 macOS。
  */
 
 import { execSync, spawnSync } from 'node:child_process';
 
 const OSASCRIPT_TIMEOUT = 5000;
 
+// ─────────────────────────────────────────────
+// 内部辅助
+// ─────────────────────────────────────────────
+
+/**
+ * 将行号限制为有效正整数（最小值 1）
+ * @param {number} n 原始行号
+ * @returns {number} 安全的 1-based 行号
+ */
+function _safeLine(n) {
+  return Number.isFinite(n) && n > 0 ? n : 1;
+}
+
+/**
+ * 执行 osascript 并返回是否成功
+ * @param {string[]} args  osascript 参数数组（每对 `-e`, `script`）
+ * @returns {boolean}
+ */
+function _run(args) {
+  try {
+    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
+    return res.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+// ─────────────────────────────────────────────
+// 状态查询
+// ─────────────────────────────────────────────
+
 /**
- * 检查 Xcode 是否正在运行（不启动 Xcode）
+ * 检查 Xcode 是否正在运行（不会启动 Xcode）
  */
 export function isXcodeRunning() {
   if (process.platform !== 'darwin') return false;
@@ -29,7 +61,7 @@ export function isXcodeRunning() {
 }
 
 /**
- * 检查 Xcode 是否是当前焦点应用
+ * 检查 Xcode 是否为当前前台应用
  */
 export function isXcodeFrontmost() {
   if (!isXcodeRunning()) return false;
@@ -44,132 +76,184 @@ export function isXcodeFrontmost() {
   }
 }
 
+// ─────────────────────────────────────────────
+// 行操作
+// ─────────────────────────────────────────────
+
 /**
- * 在 Xcode 中剪切指定行内容（不含换行符，与 V1 一致）
- * Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选中行内容 → Cmd+X 剪切
+ * 跳转到指定行
+ *
+ * 按键序列：Cmd+L → 输入行号 → Return
+ *
+ * @param {number} lineNumber 1-based 行号
+ * @returns {boolean} 是否成功
+ */
+export function jumpToLineInXcode(lineNumber) {
+  if (!isXcodeRunning()) return false;
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.2',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',
+    '-e', '  delay 0.2',
+    '-e', `  keystroke "${String(n)}"`,
+    '-e', '  delay 0.2',
+    '-e', '  key code 36',
+    '-e', 'end tell',
+  ]);
+}
+
+/**
+ * 剪切指定行的文本内容（不含换行符）
+ *
+ * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
+ *
  * @param {number} lineNumber 1-based 行号
  * @returns {boolean} 是否成功
  */
 export function cutLineInXcode(lineNumber) {
   if (!isXcodeRunning()) return false;
-  const safeLineNumber = Number.isFinite(lineNumber) && lineNumber > 0 ? lineNumber : 1;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.5',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "l" using command down',       // Cmd+L: Go to Line
-      '-e', '  delay 0.5',
-      '-e', `  keystroke "${String(safeLineNumber)}"`,  // 输入行号
-      '-e', '  delay 0.5',
-      '-e', '  key code 36',                            // Return
-      '-e', '  delay 0.5',
-      '-e', '  key code 123 using command down',        // Cmd+← 行首
-      '-e', '  delay 0.5',
-      '-e', '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾（不含换行）
-      '-e', '  delay 0.5',
-      '-e', '  keystroke "x" using command down',       // Cmd+X
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.5',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
+    '-e', '  delay 0.5',
+    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
+    '-e', '  delay 0.5',
+    '-e', '  key code 36',                                           // Return
+    '-e', '  delay 0.5',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.5',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.5',
+    '-e', '  keystroke "x" using command down',                      // Cmd+X
+    '-e', 'end tell',
+  ]);
 }
 
 /**
- * 在 Xcode 中跳转到指定行
+ * 删除指定行的文本内容（保留空行，不删除行本身）
+ *
+ * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
+ *
  * @param {number} lineNumber 1-based 行号
- * @returns {boolean}
+ * @returns {boolean} 是否成功
  */
-export function jumpToLineInXcode(lineNumber) {
+export function deleteLineContentInXcode(lineNumber) {
   if (!isXcodeRunning()) return false;
-  const safeLine = Number.isFinite(lineNumber) && lineNumber > 0 ? lineNumber : 1;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.2',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "l" using command down',
-      '-e', '  delay 0.2',
-      '-e', `  keystroke "${String(safeLine)}"`,
-      '-e', '  delay 0.2',
-      '-e', '  key code 36',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.3',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',
+    '-e', '  delay 0.3',
+    '-e', `  keystroke "${String(n)}"`,
+    '-e', '  delay 0.3',
+    '-e', '  key code 36',
+    '-e', '  delay 0.3',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.2',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.2',
+    '-e', '  key code 51',                                           // Delete 键
+    '-e', '  delay 0.3',
+    '-e', 'end tell',
+  ]);
 }
 
+// ─────────────────────────────────────────────
+// 粘贴操作
+// ─────────────────────────────────────────────
+
 /**
- * 在 Xcode 中执行粘贴（Cmd+V）
- * @returns {boolean}
+ * 执行粘贴（Cmd+V）
+ *
+ * 调用前须确保剪贴板已写入目标内容。
+ * @returns {boolean} 是否成功
  */
 export function pasteInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.2',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "v" using command down',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.2',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "v" using command down',
+    '-e', 'end tell',
+  ]);
 }
 
 /**
- * 在 Xcode 中选中当前行内容后粘贴替换（V1 _tryAutoPasteXcode 逻辑）
- * 光标已在目标行（由 jumpToLineInXcode 定位）
- * Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- * @returns {boolean}
+ * 选中当前行内容后粘贴替换
+ *
+ * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
+ * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
+ *
+ * @returns {boolean} 是否成功
  */
 export function selectAndPasteInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.5',
-      '-e', 'tell application "System Events"',
-      '-e', '  key code 123 using command down',        // Cmd+← 行首
-      '-e', '  delay 0.1',
-      '-e', '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾
-      '-e', '  delay 0.2',
-      '-e', '  keystroke "v" using command down',       // Cmd+V 粘贴替换选中内容
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.5',
+    '-e', 'tell application "System Events"',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.1',
+    '-e', '  key code 124 using {command down, shift down}',         // Cmd+Shift+→ 选到行尾
+    '-e', '  delay 0.2',
+    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴替换
+    '-e', 'end tell',
+  ]);
 }
 
+/**
+ * 跳转到指定行行首并粘贴剪贴板内容
+ *
+ * 用于在 import 区域插入新行。
+ * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
+ *
+ * @param {number} lineNumber 1-based 行号
+ * @returns {boolean} 是否成功
+ */
+export function insertAtLineStartInXcode(lineNumber) {
+  if (!isXcodeRunning()) return false;
+  const n = _safeLine(lineNumber);
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.3',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "l" using command down',                      // Cmd+L: Go to Line
+    '-e', '  delay 0.3',
+    '-e', `  keystroke "${String(n)}"`,                              // 输入行号
+    '-e', '  delay 0.3',
+    '-e', '  key code 36',                                           // Return
+    '-e', '  delay 0.3',
+    '-e', '  key code 123 using command down',                       // Cmd+← 行首
+    '-e', '  delay 0.2',
+    '-e', '  keystroke "v" using command down',                      // Cmd+V 粘贴
+    '-e', '  delay 0.3',
+    '-e', 'end tell',
+  ]);
+}
+
+// ─────────────────────────────────────────────
+// 文档操作
+// ─────────────────────────────────────────────
+
 /**
  * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns {boolean}
+ * @returns {boolean} 是否成功
  */
 export function saveActiveDocumentInXcode() {
   if (!isXcodeRunning()) return false;
-  try {
-    const args = [
-      '-e', 'tell application "Xcode" to activate',
-      '-e', 'delay 0.1',
-      '-e', 'tell application "System Events"',
-      '-e', '  keystroke "s" using command down',
-      '-e', 'end tell',
-    ];
-    const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-    return res.status === 0;
-  } catch {
-    return false;
-  }
+  return _run([
+    '-e', 'tell application "Xcode" to activate',
+    '-e', 'delay 0.1',
+    '-e', 'tell application "System Events"',
+    '-e', '  keystroke "s" using command down',
+    '-e', 'end tell',
+  ]);
 }

package/lib/infrastructure/realtime/RealtimeService.js

@@ -17,6 +17,8 @@ export class RealtimeService {
         methods: ['GET', 'POST'],
       },
       transports: ['websocket', 'polling'],
+      pingInterval: 25000,   // 25s 心跳间隔（默认值，显式声明）
+      pingTimeout: 20000,    // 20s 超时（默认值）
     });
 
     this.setupEventHandlers();
@@ -27,7 +29,7 @@ export class RealtimeService {
    */
   setupEventHandlers() {
     this.io.on('connection', (socket) => {
-      Logger.info(`[Socket.io] Client connected: ${socket.id}`);
+      Logger.debug(`[Socket.io] Client connected: ${socket.id}`);
 
       // 加入通知房间
       socket.on('join-notifications', () => {
@@ -45,7 +47,7 @@ export class RealtimeService {
 
       // 处理断开连接
       socket.on('disconnect', () => {
-        Logger.info(`[Socket.io] Client disconnected: ${socket.id}`);
+        Logger.debug(`[Socket.io] Client disconnected: ${socket.id}`);
       });
 
       // 健康检查
@@ -79,6 +81,16 @@ export class RealtimeService {
     });
   }
 
+  /**
+   * 广播 Token 用量变化事件（Sidebar 指标刷新用）
+   */
+  broadcastTokenUsageUpdated() {
+    this.io.to('notifications').emit('token-usage-updated', {
+      type: 'token_usage_updated',
+      timestamp: Date.now(),
+    });
+  }
+
   /**
    * 广播食谱创建事件
    */