用途：在终端里即时创建交互式体验，界面为此任务、此用户当场生成，而非运行现成程序。
主要能力分三层：第一层用 overlay 与 panel 原语定位样式化文本、划出面板区域、捕获输入，适合注释、状态显示、菜单、提示、简单仪表盘；第二层把 overlay、panel 与输入捕获组合成完整交互应用，如带预览面板的选择菜单、实时更新的分区仪表盘、多步向导；第三层把 overlay 和 panel 当作二维绘图面，用带明确尺寸的不透明 overlay 充当窗口和对话框，用命名 span 做局部更新，用区域写入在指定坐标放置文本，配合备用屏幕模式获得用完即清的画布。
选择原则：只显示文本用第一层；需要多个元素交互用第二层；需要窗口、实时更新字段、结构化布局或临时全屏 UI 用第三层。多数生成式 UI 处于第一、二层。
常见模式：实时仪表盘（用命名 span 只更新变化的值，避免闪烁和重绘边框）、交互式浏览器（不透明 overlay 作为窗口，方向键导航、回车查看详情）、对话框、画布式表格与图表渲染、独立更新的状态栏、多步向导、基于上下文变化的预览、使用备用屏幕模式的全屏智能体 UI。
设计原则：贴合终端美学，使用框线字符、等宽对齐和 ASCII 艺术；增量构建，从最简单的有用版本开始；界面应可随时关闭且不留痕迹；根据屏幕 cols 和 rows 自适应布局，小于 80 列用精简单列，80-120 列用标准布局，超过 120 列可多列展示更多细节；按当前上下文呈现相关内容。
执行上下文：具备 wsh_* 工具时直接使用，操作名一般对应工具名；没有这些工具时处于 HTTP/curl 回退模式，此时不要猜测端点或 CLI 子命令，应先在工作区搜索 skills/core/ 并阅读 SKILL.md，其中包含所有端点及可用 curl 示例和引导流程。快速引导命令：curl -sf --unix-socket ${XDG_RUNTIME_DIR:-/tmp}/wsh/default.http.sock http://localhost/health；若失败则运行 wsh server -L agent-$$ --ephemeral & 后重试。
注意事项：不要重复造已有工具，先检查 ranger、lf、lazygit、tig 等是否已安装，已有工具时用 wsh:tui 驱动；不要过度设计；不要随意混用图层，堆叠多个不透明 overlay 或让 overlay 与 panel 争抢注意力会造成混乱，需要干净画布时用备用屏幕模式；在 80x24 等小终端上测试，保证可用。