用途：在终端中与人类进行可视化沟通。提供两种元素：overlay（浮动文字，可定位到 (x,y)、可带背景与尺寸形成卡片/对话框，适合提示、警告、标注、通知等临时信息）和 panel（顶部或底部固定区域，按行占高，会压缩 PTY 空间，适合状态栏、进度、仪表板等持久信息）。选择依据：信息是否绑定屏幕位置、需要存在多久。
主要能力：spans 支持粗体、颜色（建议 0-7/8-15 索引色）、暗淡等样式；span 可带 id，实现局部更新而不重绘全部内容；region writes 可在 overlay/panel 内按 (row, col) 绝对定位写入带样式文字，用于表格、网格、图表；overlay 支持 z 值控制叠放顺序。wsh 不提供内置边框、内边距或分隔线，需用制表符和空格自行绘制；读取屏幕返回的 cols、rows 避免越界。
使用方式：若工具集中有 wsh_* 工具（如 wsh_send_input、wsh_get_screen）则直接使用，技能中的操作名通常对应工具名。若无，则处于 HTTP/curl 回退模式，不要猜测端点或 CLI 子命令，先查找工作区 skills/core/ 并阅读 SKILL.md 获取完整 API 参考。快速引导：curl -sf --unix-socket ${XDG_RUNTIME_DIR:-/tmp}/wsh/default.http.sock http://localhost/health，失败则运行 wsh server -L agent-$$ --ephemeral & 后重试。创建后需保存返回的 ID，内容变化时更新，不再需要时删除或全部清除；无内置定时器，临时 overlay 需自行在后续交互中清理。
适用场景：状态栏、进度显示、上下文摘要、错误解释、工具提示、通知、对齐表格、对话框等。
限制与注意：overlay 与 panel 不会自动消失，易产生陈旧元素和视觉杂乱，建议最多 1-2 个 panel、2-3 个 overlay；overlay 可能遮挡终端内容，宜放在右边缘或使用短文本；颜色方案因终端而异，不应仅靠颜色传达含义，需搭配文字或符号；屏幕滚动会导致坐标漂移，可参考屏幕响应的 epoch 字段判断是否需要重新评估位置；panel 每行都占用终端空间，应尽量精简。