[Bug] macOS iTerm2 会话启动时窗口卡住/空白

[sortbyiky]

问题描述

在 macOS 上使用 Coding-Tool Web UI 点击会话，选择 iTerm2 作为终端工具时，iTerm2 打开后窗口空白卡住，不执行任何命令。

复现步骤

1. npm install -g coding-tool
2. ct start 启动服务
3. 打开 Web UI (http://localhost:10099)
4. 设置 → 终端工具 → 选择 iTerm2
5. 点击任意会话
6. iTerm2 打开，但窗口空白，不执行 claude -r {sessionId} 命令

环境信息

• 操作系统: macOS Sequoia 15.x
• coding-tool 版本: 2.2.7
• iTerm2 版本: Build 3.5.x
• Node.js 版本: v22.21.1

原因分析

问题出在 src/server/services/terminal-detector.js 第 110 行的 AppleScript 语法：

// 当前代码（有问题）
command: 'osascript -e \'tell application "iTerm" to create window with default profile command "cd {cwd} && claude -r {sessionId}"\''

create window with default profile command "..." 这个一步到位的语法在新版 iTerm2 中不稳定，经常导致窗口创建后不执行命令。

修复方案

将 AppleScript 拆分为三步执行：

1. 激活 iTerm2: tell application "iTerm" to activate
2. 创建窗口: tell application "iTerm" to create window with default profile
3. 写入命令: tell application "iTerm" to tell current session of current window to write text "..."

建议修改

// 修复后的代码
command: 'osascript -e \'tell application "iTerm" to activate\' -e \'tell application "iTerm" to create window with default profile\' -e \'tell application "iTerm" to tell current session of current window to write text "cd \\\'{cwd}\\\' && claude -r {sessionId}"\''

完整 diff

diff --git a/src/server/services/terminal-detector.js b/src/server/services/terminal-detector.js
--- a/src/server/services/terminal-detector.js
+++ b/src/server/services/terminal-detector.js
@@ -107,7 +107,7 @@ function detectMacTerminals() {
       id: 'iterm2',
       name: 'iTerm2',
       available: true,
       isDefault: false,
-      command: 'osascript -e \'tell application "iTerm" to create window with default profile command "cd {cwd} && claude -r {sessionId}"\''
+      command: 'osascript -e \'tell application "iTerm" to activate\' -e \'tell application "iTerm" to create window with default profile\' -e \'tell application "iTerm" to tell current session of current window to write text "cd \\\'{cwd}\\\' && claude -r {sessionId}"\''
     });
   }

验证

修改后测试命令：

osascript -e 'tell application "iTerm" to activate' \
  -e 'tell application "iTerm" to create window with default profile' \
  -e 'tell application "iTerm" to tell current session of current window to write text "echo Hello from fixed iTerm2"'

执行后 iTerm2 正常打开并执行命令。

临时解决方案

在官方修复前，用户可以：

1. 在 Web UI 设置中切换为 Terminal.app（系统终端）
2. 手动修改 $(npm root -g)/coding-tool/src/server/services/terminal-detector.js 文件

---

感谢您开发这个优秀的工具！🎉

[sortbyiky]

补充一个更稳的修复方案（避免 osascript -e 的多层引号/转义问题）。

现象补充

在 macOS 上从 Web UI 打开 iTerm2 会话时，部分环境会出现：

• iTerm2 窗口打开但不执行命令 / 空白卡住
• 或后端执行命令报错：
  • /bin/sh: -c: line 0: unexpected EOF while looking for matching \"'``（引号不匹配）
  • syntax error: 预期是表达式，却找到未知的记号。 (-2741)（AppleScript 解析失败）

这类问题多数不是 iTerm2 本身，而是 exec(command, { shell: true }) + osascript -e ... 的字符串拼接在「JS → shell → AppleScript」三层转义里非常脆弱（尤其 cwd 含中文/引号时）。

推荐修复（stdin/heredoc 喂 AppleScript）

建议把 iTerm2 的启动方式改成 heredoc / stdin，绕开 -e 多层引号拼接，并用 newWindow 显式引用刚创建的窗口：

tell application "iTerm"
  activate
  set newWindow to (create window with default profile)
  tell current session of newWindow
    write text "cd {cwd} && claude -r {sessionId}"
  end tell
end tell

对应 shell 命令（示例）：

osascript <<'APPLESCRIPT'
...上面的 AppleScript...
APPLESCRIPT

进一步建议（从根上解决）

如果愿意做一次结构性修复：

• 把 child_process.exec(command, { shell: true }) 改为 spawn('osascript', ['-e', ...]) 或 spawn('osascript', ['-'], { stdio: ['pipe', ...] })，直接传参/传 stdin，彻底避免 shell quoting。
• 同时在失败时把 stderr 打到 UI 日志（现在只记录 error.message 很难定位）。

如果你愿意，我也可以提交 PR（包含：iTerm2 heredoc 修复 + spawn 化执行 + stderr 回传）。