新闻详情

新闻详情

首页 / 资讯中心 / 详情

wterm本地Shell教程:浏览器里的完整本地终端(node-pty多会话实战)

发布时间:2026/11/17 1:35:30来源:尧图网络
wterm本地Shell教程:浏览器里的完整本地终端(node-pty多会话实战)
wterm本地Shell教程浏览器里的完整本地终端node-pty多会话实战【免费下载链接】wtermA terminal emulator for the web项目地址: https://gitcode.com/gh_mirrors/wterm1/wtermwterm 是一款面向 Web 的终端模拟器terminal emulator for the web核心用 Zig 编写并编译为约 26 KB 的 WASM直接渲染到 DOM原生支持文本选择、复制粘贴、浏览器查找和 24 位色。本文基于 wterm 仓库中的 Local Shell 示例手把手教你用 node-pty WebSocket 在浏览器里跑起一台真实的本地 Shell并管理多个互不干扰的终端会话。一、为什么需要浏览器里的本地终端传统浏览器终端方案通常依赖 Canvas 渲染而 wterm 选择 DOM 渲染带来两个直接好处原生文本能力选择、复制、CtrlF 查找、屏幕阅读器直接作用于已挂载的行元素即插即用的框架组件React、Vue、Svelte 组件开箱即用见 packages/wterm/react、packages/wterm/vue、packages/wterm/svelte。wterm 的完整特性清单24 位色、Kitty 图片、Kitty 键盘协议、宽字符对齐等可以查阅 README.md。二、Local Shell 示例架构一句话讲清本项目的examples/local是一个 Next.js 应用旁边跑着一个自定义服务器用WebSocket 把浏览器和 node-pty 桥接起来浏览器里的每个终端标签页向/api/terminal发起 WebSocket 连接服务器为每个连接用 node-pty 生成一个 PTY 进程加载你的默认登录 Shell你在浏览器敲下的每个键经 WebSocket 发给服务器写入 PTYPTY 输出再经 WebSocket 回传由 wterm 渲染到页面。核心源码就两个文件非常值得精读服务端桥接examples/local/server.ts前端多会话工作区examples/local/app/session-workspace.tsx三、三步启动一键运行本地 Shell 前置要求Zig 0.16、Node.js 24、pnpm 11详见 README.md 的 Development 章节。git clone https://gitcode.com/gh_mirrors/wterm1/wterm cd wterm pnpm install zig build pnpm --filter local dev启动后浏览器打开local-example.wterm.localhost开发服务器通过 portless 分配地址若提示缺失可执行npm i -g portless即可看到一个左侧为会话列表、右侧为终端的完整本地 Shell 界面。⚠️ 注意Linux 上 node-pty 需要 C/Python 编译工具链见 README.md。四、多会话实战创建、切换、关闭三个按钮全搞定打开页面后体验 wterm 的多会话能力只需三个动作操作位置效果➕ 新建侧边栏右上角加号新增一个独立 PTY 独立终端自动获得焦点切换点击侧边栏任意会话项终端画面切换其他会话保持存活正在跑的任务不中断✖ 关闭悬停会话项右侧销毁该会话的 WebSocket 与 PTY 进程侧边栏每个会话项还会实时显示当前工作目录家目录缩写为~服务端每 500ms 轮询一次 PTY 进程的 cwdLinux 读/proc/pid/cwdmacOS 用 lsof你在终端里cd之后侧边栏标签会同步更新——实现见 examples/local/server.ts。切换会话时旧终端只是被visibility: hiddeninert遮住而非销毁examples/local/app/session-workspace.tsx所以你在 Terminal 1 里挂着htop切去 Terminal 2 干完活再切回来画面分毫未动。五、node-pty 桥接细节终端尺寸如何同步一个常见痛点浏览器窗口缩放后PTY 的列/行数必须跟着变否则vim、ls输出会错位。wterm 示例的做法很优雅前端通过onResize回调拿到核心实际应用的网格尺寸再拼一条自定义转义序列\x1b[RESIZE:cols;rows;像素宽;像素高]发给服务器examples/local/app/session-workspace.tsx服务器解析该序列后调用ptyProcess.resize(cols, rows)同时把像素尺寸写入 PTYmacOS/Linux 下通过 ioctl这样连按像素探测终端的工具也能正确工作examples/local/server.ts。由于 wterm 的autoResize基于 ResizeObserver窗口变化会即时触发onResize整条链路无需手动干预。六、进阶玩法 图形能力更强的 Ghostty 核心访问/ghostty路由终端切换为带图形能力的wterm/ghosttylibghostty 后端Kitty 图片协议可渲染 PNG/RGB 图像示例中限制在 640×480 CSS 像素内入口见 examples/local/app/ghostty/page.tsx。调试模式URL 加?debug参数可在 WTerm 实例上打开DebugAdapter检查转义序列、单元格数据与渲染性能examples/local/app/session-workspace.tsx。换主题给Terminal传themesolarized-dark/monokai/light即可文档见 packages/wterm/react/README.md。七、常见问题速查Q为什么打不开页面所有开发服务器使用 portless请留意终端里打印的实际.localhost地址而非写死的端口。QLinux 下 node-pty 安装失败需要 C 与 Python 工具链用于编译原生模块先装好再pnpm install。Q会话关闭后进程会泄漏吗不会。WebSocket 断开时服务器会立即ptyProcess.kill()并清理 cwd 轮询定时器examples/local/server.ts。八、小结wterm 的 Local Shell 示例用不到 500 行代码演示了一套完整的浏览器本地终端方案node-pty 负责真实 ShellWebSocket 负责双向传输wterm 负责高性能 DOM 渲染React 负责多会话状态管理。照着本文的三步启动命令跑起来你就能在浏览器标签页里拥有任意多个互不干扰的本地 Shell——这正是把开发环境搬进 Web 的第一步。【免费下载链接】wtermA terminal emulator for the web项目地址: https://gitcode.com/gh_mirrors/wterm1/wterm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/15 2:04:12

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉