用途：在 wsh 服务器模式下编排多个并行终端会话，适合任务相互独立、需要隔离环境（不同目录、环境变量、shell），或需一边监控长驻进程一边在另一会话中工作的场景。若单条 shell 用 && 或 & 即可完成、任务严格串行，则不必使用。
主要能力：创建会话时可指定 name、command、rows、cols、cwd、env、tags；带 command 的会话在命令结束后退出，不带 command 的会话启动交互式 shell 并持续存在。支持列出与检查会话、重命名、发送输入、读取屏幕与回滚输出、等待空闲、强制终止。常见模式包括扇出并行执行后汇总结果、长驻进程加工作会话的观察者模式、以及顺序交接的流水线。标签可用于分组、过滤和批量等待空闲。
使用方式：wsh 始终以服务器守护进程运行，会话 API 端点为 /sessions/，各会话通过 /sessions/:name/ 前缀交互。若已有 wsh_* 工具则直接使用；否则处于 HTTP/curl 回退模式，不要猜测端点或 CLI 子命令，应先加载完整 API 参考。快速引导：curl -sf --unix-socket ${XDG_RUNTIME_DIR:-/tmp}/wsh/default.http.sock http://localhost/health，失败则执行 wsh server -L agent-$$ --ephemeral & 后重试。
限制与注意：会话是消耗资源的运行进程，需避免会话蔓延，用完及时退出或销毁，创建前先列出可复用会话。命名与标签应清晰，如 test-unit、build-frontend。轮询时若会话消失说明命令已结束，需提前读取输出或重定向到文件。各会话上下文相互隔离，无法通过 shell 变量共享状态，可用文件或创建时的环境变量。联邦集群下会话可跨服务器，标签为集群级，操作会自动路由；分布式细节参见 wsh:cluster-orchestration 技能。