feat(backend): 兼容 rcfile exec 切换 shell 导致会话起不来的场景

[deepcoldy]

背景

用户（江威峰）配置 botmux + Codex 后会话起不来：首条多行 prompt 落进裸 zsh 报 zsh: parse error near '\n'，手敲 codex 才能 work。

根因：用户 $SHELL=/bin/bash，但 ~/.bashrc 里有 [ -t 1 ] && exec zsh（chsh 失败的 hack）。botmux 在 tmux pane 用 <$SHELL> -i -c '… exec /usr/bin/env <cli>' 启动 CLI（tmux-pipe-backend.ts:createDetachedSession）——-i 会 source .bashrc，pane stdout 是 tty → exec zsh 在 -c body 跑到之前就顶替 bash，CLI 的启动命令永远没机会执行，pane 沦为裸 zsh。

经分析对四种方案做了对抗性压测（含真机验证）。关键约束：tmux new-session 的 pane 不继承 client env，只继承 server 全局 env——所以"抓 rc env 再塞回去"的透明兼容（L1）雷区最多，本 PR 按申晗决定跳过 L1，落 L2 + L3。

改动

L2 · 裸壳检测安全网（worker.ts + session-discovery.ts）

打首条 prompt 前，比对 pane leaf 进程 comm 是否为裸壳（bash/zsh/sh/dash/ash/…）。是则不把多行 prompt 打进去，改发一张飞书诊断卡片，按 $SHELL vs leaf 是否一致分两档点名根因（trampoline / 启动慢·CLI 没找到）+ 修法。

• 检测点 = flushPending 首刷处：首条 prompt 本就被 hold 到 ready 或 15s/45s 超时，届时健康 CLI 早已 exec，只有 trampoline/失败才仍是裸壳 → 误报率极低。
• 跳过 wrapperCli（launcher 合法套壳）/ adoptMode（观察既有 pane）；pty/herdr 直接 exec CLI，leaf 永不是裸壳，天然不触发。
• 必在 runStartupCommands 之前跑（否则 startupCommands 会先被打进裸壳）。

L3 · per-bot launchShell 覆盖

新增 BotConfig.launchShell（shell 名或绝对路径），覆盖 $SHELL 启动 CLI，直接绕开会跳转的 rc。

• 贯通 init payload → SpawnOpts → resolveUserShell(env, override)，三处 call site（tmux-pipe / zellij / 旧 tmux backend）。
• 两套配置面：/config launchShell（CONFIG_FIELDS）+ dashboard「机器人默认设置 → 启动 Shell」，写盘统一走 applyConfigField。
• ⚠️ 注意：PATH/nvm/pnpm 要放进所选 shell 的 rc——已在 hint/docs 标注。

注：workflow-resume / daemon-spawn 两条 init 构造默认 backendType:'pty'（无 shell wrapper，trampoline 免疫），不需要 launchShell，未线程进去。

验证

• 全量单测 375 文件 / 6374 例通过；新增 resolveShellOverride+resolveUserShell override 5 例、isBareShellComm 4 例。
• 真实 tmux pane 端到端：植入 .bashrc=[ -t 1 ] && exec zsh 的 fake HOME（-e HOME 注入 pane env）——
  • bug 变体（bash -i）：pane leaf=zsh、fakecli 未启动 ✓ 复现
  • fix 变体（zsh -l -i，launchShell=zsh）：fakecli 正常拉起 ✓
• 文档：bots-json.md 配置表加 launchShell（中英同步）。

Review 关注点（供 @codex）

• L2 误报/漏报：检测时机、wrapperCli/node 启动 CLI（comm=node）、themed prompt false-ready
• L3 三处 call site 是否齐全、配置两面（/config + dashboard）写盘一致性
• 诊断卡片文案是否会误导（slow-rc vs trampoline 分档）

[chatgpt-codex-connector]

To use Codex here, create a Codex account and connect to github.