用途：wsh 是 Wave Terminal 的 CLI，用于把 Wave 当作可被脚本和智能体编排的工作区，而不仅是终端窗口。它在 Wave 内创建标签页、放置块、向其他终端输入、读取输出，并按内容类型打开文件或 URL。
主要能力：
- 委派任务：用 scripts/wave_delegate.py 在块中启动代理 CLI，传入提示，等待完成并把答案打印到 stdout。示例： scripts/wave_delegate.py --agent claude --prompt "audit ./pkg for data races" scripts/wave_delegate.py --agent codex --prompt-file task.md --tab work --position right --size 40 支持 --keep 保留块、--cwd 指定目录。默认通过 shell 重定向与标记文件判定完成，--mode scrollback 则等待屏幕停止变化。
- 编排工作区： wsh tab create logs wsh tab move logs 1 wsh tab rename 2 build wsh tab delete logs wsh createblock term --target 1 --position right --size 30 wsh view ./report.md wsh run -- npm test
- 驱动与读取其他块： wsh sendkeys -b 2 --enter "npm run dev" wsh sendkeys -b 2 --keys Up Enter wsh sendkeys -b 2 --signal SIGINT wsh termscrollback -b 2 --lastcommand
- 其他：wsh ssh、wsh wsl、wsh file、wsh conn、wsh editconfig、wsh setconfig、wsh getmeta、wsh setmeta。用 wsh badge 或 wsh notify 提示完成。
必要检查：需在 Wave 内运行，wsh 通过 WAVETERM_JWT 认证；[ -n "$WAVETERM_JWT" ] && echo "inside Wave" || echo "not inside Wave"。版本需 v0.17.4+：wsh tab list >/dev/null 2>&1 && echo "v0.17.4+" || echo "too old: no tab/sendkeys/placement"。
限制：在 Wave 块之外所有命令都会失败；块编号按布局叶序变化，脚本应捕获 uuid；this 不跨标签页，--tab X 与默认 -b 同用会被拒绝；委派应使用代理的非交互形式（如 claude 需 -p），否则会挂起。缺少的事实暂未提供。