用途：wsh 通过 MCP 工具把终端会话开放给 AI 控制，本地经 Unix 域套接字连接守护进程，用户看到自己的普通终端，AI 通过工具调用操作同一会话，输入输出双向同步。所有工具需指定 session 参数。
主要能力：核心是发送—等待—读取循环。wsh_send_and_read 一次完成发送按键、等待空闲并返回屏幕；wsh_send_keys 发送文本或命名特殊键（enter、tab、escape、ctrl+a 至 ctrl+z、f1-f12 等）；wsh_send_input 为底层字节注入，支持 utf8 或 base64；wsh_await_idle 等待终端空闲；wsh_get_screen 与 wsh_get_scrollback 读取当前屏幕和滚回历史。可视化方面，wsh_overlay 创建浮动叠加层，wsh_panel 在顶部或底部划出面板，均支持颜色、背景、更新、列出和移除；wsh_input_mode 可捕获或释放键盘输入并指定焦点；wsh_screen_mode 可进入与退出备用屏幕模式。会话管理包括 wsh_list_sessions、wsh_create_session、wsh_manage_session（kill、rename、detach、增删标签），并支持联邦多服务器：wsh_list_servers、wsh_add_server、wsh_server_status、wsh_remove_server，会话工具可加 server 参数路由。
使用方式：先确认工具集中存在 wsh_ 前缀工具；若没有，说明 MCP 桥未运行，不要手动启动服务器，应改用 HTTP API 并阅读工作区 skills/core/SKILL.md。随后创建会话，例如 wsh_create_session(name="work")，再用发送/等待/读取循环操作。本地 Unix 域套接字无需认证；仅当通过 --bind 配置 TCP HTTP 远程访问时才需要 Bearer token，token 可在启动时自动生成或经 --token / WSH_TOKEN 设置。默认以 wsh 启动会创建名为 default 的会话。会话名限 1-64 字符，仅字母、数字、点、连字符、下划线；行列数限制 1-1000。
适用场景：驱动 CLI 进程、操作 vim/htop/lazygit/k9s 等全屏 TUI、多会话并行、编排其他 AI 代理、监控人类操作、可视化反馈、输入捕获与生成式终端界面，对应 wsh:drive-process、wsh:tui、wsh:multi-session、wsh:agent-orchestration、wsh:monitor、wsh:visual-feedback、wsh:input-capture、wsh:generative-ui 等专门技能。
限制：等待空闲只表示可能空闲，程序也可能无输出地工作；超过 max_wait_ms 会返回错误标记但仍返回屏幕。远程 TCP 访问才需认证。资料未提供具体收费、价格与平台支持信息。