autosnippet 3.2.10 → 3.2.11

package/lib/platform/ios/xcode/SaveEventFilter.js

@@ -1,165 +0,0 @@
-/**
- * SaveEventFilter - 区分用户保存与 Xcode 自动保存
- *
- * 三层过滤策略：
- * 1. Self-write 冷却期：AutoSnippet 自身写入的文件在冷却期内忽略变更
- * 2. 内容哈希去重：文件内容未变时跳过处理
- * 3. Xcode 焦点检测：Xcode 不是前台应用时跳过（典型的切窗口自动保存场景）
- *
- * 使用方式：
- *   import { saveEventFilter } from './SaveEventFilter.js';
- *
- *   // 在 handler 写文件时标记
- *   saveEventFilter.markSelfWrite(filePath);
- *   fs.writeFileSync(filePath, content);
- *
- *   // 在 FileWatcher 处理前判断
- *   const verdict = saveEventFilter.shouldProcess(filePath, content);
- *   if (!verdict.process) { console.log(verdict.reason); return; }
- */
-
-import { createHash } from 'node:crypto';
-import { isXcodeFrontmost } from './XcodeAutomation.js';
-
-/* ────────── 配置 ────────── */
-
-/** Self-write 冷却期（ms） */
-const SELF_WRITE_COOLDOWN = 2000;
-
-/** 是否启用 Xcode 焦点过滤（可通过 ASD_SAVE_FILTER=0 关闭） */
-function isFilterEnabled() {
-  return process.env.ASD_SAVE_FILTER !== '0';
-}
-
-/** 是否启用 Xcode 焦点检测（可通过 ASD_XCODE_FOCUS_CHECK=0 单独关闭） */
-function isFocusCheckEnabled() {
-  return process.env.ASD_XCODE_FOCUS_CHECK !== '0';
-}
-
-/* ────────── SaveEventFilter ────────── */
-
-class SaveEventFilter {
-  constructor() {
-    /** @type {Map<string, number>} filePath → 最后一次 self-write 的时间戳 */
-    this._selfWrites = new Map();
-
-    /** @type {Map<string, string>} filePath → 上次处理时的内容 MD5 哈希 */
-    this._contentHashes = new Map();
-
-    // 定期清理过期条目，防止内存泄漏
-    this._cleanupInterval = setInterval(() => this._cleanup(), 60_000);
-    if (this._cleanupInterval.unref) {
-      this._cleanupInterval.unref();
-    }
-  }
-
-  /**
-   * 标记 AutoSnippet 即将写入某个文件
-   * 在 fs.writeFile / writeFileSync 之前调用本方法
-   *
-   * @param {string} filePath 绝对路径
-   */
-  markSelfWrite(filePath) {
-    this._selfWrites.set(filePath, Date.now());
-  }
-
-  /**
-   * 判断是否应该处理该文件的变更事件
-   *
-   * @param {string} filePath 绝对路径
-   * @param {string} content  文件当前的完整内容
-   * @returns {{ process: boolean, reason: string }}
-   */
-  shouldProcess(filePath, content) {
-    if (!isFilterEnabled()) {
-      return { process: true, reason: 'filter-disabled' };
-    }
-
-    // ── Layer 1: Self-write 冷却期 ──
-    const lastSelfWrite = this._selfWrites.get(filePath);
-    if (lastSelfWrite && Date.now() - lastSelfWrite < SELF_WRITE_COOLDOWN) {
-      if (process.env.ASD_DEBUG === '1') {
-      }
-      return { process: false, reason: 'self-write-cooldown' };
-    }
-
-    // ── Layer 2: 内容哈希去重 ──
-    const hash = this._hash(content);
-    const prevHash = this._contentHashes.get(filePath);
-    if (prevHash && prevHash === hash) {
-      if (process.env.ASD_DEBUG === '1') {
-      }
-      return { process: false, reason: 'content-unchanged' };
-    }
-
-    // ── Layer 3: Xcode 焦点检测 ──
-    if (process.platform === 'darwin' && isFocusCheckEnabled()) {
-      if (!isXcodeFrontmost()) {
-        if (process.env.ASD_DEBUG === '1') {
-        }
-        return { process: false, reason: 'xcode-not-frontmost' };
-      }
-    }
-
-    return { process: true, reason: 'ok' };
-  }
-
-  /**
-   * 处理完成后更新内容哈希
-   * 在文件指令处理完毕后调用
-   *
-   * @param {string} filePath 绝对路径
-   * @param {string} content 处理后的文件内容
-   */
-  updateHash(filePath, content) {
-    this._contentHashes.set(filePath, this._hash(content));
-  }
-
-  /**
-   * 在 handler 写文件之前同时标记 self-write + 更新哈希
-   * 方便一步完成
-   *
-   * @param {string} filePath 绝对路径
-   * @param {string} newContent 即将写入的新内容
-   */
-  markWrite(filePath, newContent) {
-    this.markSelfWrite(filePath);
-    this._contentHashes.set(filePath, this._hash(newContent));
-  }
-
-  /**
-   * 清除某文件的所有状态（通常不需要调用）
-   */
-  clear(filePath) {
-    this._selfWrites.delete(filePath);
-    this._contentHashes.delete(filePath);
-  }
-
-  /* ────────── 内部方法 ────────── */
-
-  _hash(content) {
-    return createHash('md5').update(content).digest('hex');
-  }
-
-  _cleanup() {
-    const now = Date.now();
-    const expiry = 10 * 60 * 1000; // 10 分钟
-
-    for (const [k, ts] of this._selfWrites) {
-      if (now - ts > expiry) {
-        this._selfWrites.delete(k);
-      }
-    }
-
-    // 内容哈希保留更长时间，只清理明显过期的
-    // （文件仍被监听期间不应清理，所以这里保守处理）
-    if (this._contentHashes.size > 1000) {
-      // 超过 1000 个文件说明有泄漏，全部清理
-      this._contentHashes.clear();
-    }
-  }
-}
-
-/** 单例 */
-export const saveEventFilter = new SaveEventFilter();
-export default saveEventFilter;

package/lib/platform/ios/xcode/XcodeAutomation.js

@@ -1,350 +0,0 @@
-/**
- * XcodeAutomation — Xcode AppleScript 自动化
- *
- * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
- *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
- *
- * 所有操作都带超时保护（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）
- */
-export function isXcodeRunning() {
-  if (process.platform !== 'darwin') {
-    return false;
-  }
-  try {
-    const result = execSync('pgrep -x Xcode', {
-      encoding: 'utf8',
-      timeout: 2000,
-      stdio: 'pipe',
-    });
-    return result.trim().length > 0;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 检查 Xcode 是否为当前前台应用
- */
-export function isXcodeFrontmost() {
-  if (!isXcodeRunning()) {
-    return false;
-  }
-  try {
-    const result = execSync(
-      'osascript -e \'tell application "System Events" to get name of first process whose frontmost is true\'',
-      { encoding: 'utf8', timeout: OSASCRIPT_TIMEOUT, stdio: 'pipe' }
-    );
-    return result.trim() === 'Xcode';
-  } catch {
-    return false;
-  }
-}
-
-// ─────────────────────────────────────────────
-// 行操作
-// ─────────────────────────────────────────────
-
-/**
- * 跳转到指定行
- *
- * 按键序列：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 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',
-  ]);
-}
-
-/**
- * 删除指定行的文本内容（保留空行，不删除行本身）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
- *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
- */
-export function deleteLineContentInXcode(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',
-    '-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',
-  ]);
-}
-
-// ─────────────────────────────────────────────
-// 粘贴操作
-// ─────────────────────────────────────────────
-
-/**
- * 执行粘贴（Cmd+V）
- *
- * 调用前须确保剪贴板已写入目标内容。
- * @returns {boolean} 是否成功
- */
-export function pasteInXcode() {
-  if (!isXcodeRunning()) {
-    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',
-  ]);
-}
-
-/**
- * 选中当前行内容后粘贴替换
- *
- * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
- * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- *
- * @returns {boolean} 是否成功
- */
-export function selectAndPasteInXcode() {
-  if (!isXcodeRunning()) {
-    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} 是否成功
- */
-export function saveActiveDocumentInXcode() {
-  if (!isXcodeRunning()) {
-    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',
-  ]);
-}