[Bug] [0.2.2-rc.1] 侧边栏终端在 VTE 环境下每条命令回显内部 PS0 采样文本（bash）

[qishipai]

一句话：在启用 VTE shell 集成的 Linux 上，侧边栏终端每执行一条命令都会多显示一行内部状态采样文本，并且 busy 状态始终写不进状态文件。

复现、预期与验收

• 复现步骤：
  1. 在 VTE 系终端（GNOME Terminal / Tilix 等，VTE_VERSION >= 3405）中运行 npx @deepseek-ai/dsh@0.2.2-rc.1 web；
  2. 打开任意会话，展开侧边栏，新建终端（默认 bash）；
  3. 执行 echo。
• 实际结果（echo hi 时该行与 hi 连在一起，每条命令必现）：

  user@host:~/proj$ echo
  uiltin printf '%s:%s:busy' "43128" "2" >| '/tmp/dsh-shell-XXXXXX/state')
  user@host:~/proj$
  

• 预期结果：只显示提示符与命令输出，不出现任何内部协议文本。
• 环境：
  • @deepseek-ai/dsh@0.2.2-rc.1（npm latest，2026-11-04）；master 源码同样存在该问题
  • 该问题在 0.2.1-rc.2 已存在，0.2.2-rc.1 仍复现
  • Ubuntu 26.04.1 LTS，GNOME + VTE 8400；/etc/bash.bashrc 会 source /etc/profile.d/vte-2.91.sh
  • bash 5.3.9；浏览器终端 TERM=xterm-256color
  • 通过 npx @deepseek-ai/dsh web 启动
• 验收条件：
  • echo / echo hi 不再出现该文本；
  • 无子进程的内建长命令（如 while :; do :; done）运行期间，/tmp/dsh-shell-*/state 为 busy；
  • 无 VTE 集成（VTE_VERSION 不存在或小于 3405）时行为不变；
  • zsh 终端与 agent 的 bash 工具不受影响。

根因（已定位）

1. 侧边栏终端由 packages/api/terminal-controller/src/index.ts:323 以 shellActivity: true、argv: [bash, "-i"] 创建。
2. packages/subprocess/subprocess-local/src/shell-activity.ts:92 生成 rcfile 时，把采样片段追加到 PS0：

   `  PS0+=${quote(`$(builtin printf '%s:%s:busy' ... >| ${state})`)}`

3. 发行版的 VTE 集成（如 /etc/profile.d/vte-2.91.sh:88、:116）已经把 PS0 设为以 ESC \ 结尾；在 bash 里该值的最后一个字符是字面反斜杠。
4. bash 展开 PS0 时，\ 会转义紧随其后的 $：$(...) 不执行、原文被打印；同时 ST 的 \ 被消费，终端把随后的 ESC $ ( b 当作字符集指定序列消费，于是屏幕从 uiltin 开始（少掉 $(b）。
5. 命令替换从未执行，busy 永远不落盘；state 文件里只剩 PROMPT_COMMAND 写入的 idle。

可直接在交互式 bash 中验证转义行为：

PS0=$'\e]666;vte.shell.preexec!\e\\'
PS0+='$(echo BUSY)'
true
# 期望执行 echo BUSY；实际屏幕上出现字面量 $(echo BUSY)

证据

• 0.2.2-rc.1 现场生成的 rcfile 最后一行：

  PS0+='$(builtin printf '\''%s:%s:busy'\'' "$__dsh_shell_pid" "$__dsh_shell_sequence" >| '\''/tmp/dsh-shell-XXXXXX/state'\'')'

• 用同一 rcfile 启动 PTY 执行 echo，原始字节为
  ...vte.shell.preexec!\x1b$(builtin printf ... )，经 xterm.js 渲染后正好得到上面“实际结果”中的 uiltin printf ...。
• 内建循环 while :; do :; done 运行期间读取 state：43128:2:idle（应为 busy）。
• 把同一行改成前插后，state 变为 ...:busy，屏幕不再出现该文本。

建议修复

单行改动（shell-activity.ts）：

- `  PS0+=${quote(`$(builtin printf '%s:%s:busy' "$__dsh_shell_pid" "$__dsh_shell_sequence" >| ${state})`)}`,
+ `  PS0=${quote(`$(builtin printf '%s:%s:busy' "$__dsh_shell_pid" "$__dsh_shell_sequence" >| ${state})`)}"\${PS0-}"`,

• 前插保证已有的、以 \ 结尾的 PS0 仍在末尾，不会再转义我们的 $；
• "${PS0-}" 而不是 "${PS0}"，兼容用户在 ~/.bashrc 开启 set -u（nounset）；
• VTE 的集成脚本自己也是前插，注释明确写着 “Prepend to the user's PS0”；systemd 的 80-systemd-osc-context.sh 同样如此。

临时规避

• 启动时去掉 VTE 标记（会同时失去终端里的 VTE 集成）：env -u VTE_VERSION npx @deepseek-ai/dsh web（已实测：移除后不再出现该文本）；
• 或对安装包的 dsh-subprocess-local/lib/index.js 应用上面的单行补丁（升级会被覆盖）。

[Shen-Cao]

我们在本地独立定位了同一现象，结论与你一致：rcfile 是 PS0+=（shell-activity.ts#L92），而 VTE 的 PS0 值以反斜杠结尾；提示符展开时 \$ 变成字面 $，命令替换不执行、原样打印，终端再把 ESC $ ( b 当字符集指定（SCS）吃掉，于是屏幕上从 uiltin 开始。

按你建议的前插方案做了补丁分支，并补了两个红绿回归测试（master 上失败、分支上通过）；另外加了一层 shopt -q promptvars 守卫，关闭提示符变量展开的 shell 不再打印该片段（代价是这类 shell 失去 busy 采样，已写进包 README）：

• 补丁分支：https://github.com/Shen-Cao/deepseek-harness/tree/fix/shell-activity-ps0-prepend
• 说明、验证与取舍：[Patch][subprocess] VTE 环境下终端回显 PS0 采样片段并使 busy 检测失效（附修复分支与回归测试） #13294

顺带确认了比视觉噪音更实质的影响：因为 $(...) 从未执行，VTE 会话里循环/长命令期间 activity 一直停在 idle，也就是说 busy 采样在这类终端里此前从未生效。