117 lines
4.0 KiB
Markdown
117 lines
4.0 KiB
Markdown
# Ghostty Web
|
|
|
|
基于 Web 的终端模拟器，使用 xterm.js 渲染和 node-pty 提供 PTY 支持。
|
|
|
|
## 当前状态
|
|
|
|
✅ **基础功能已完成**
|
|
- WebSocket + PTY 服务器 (Node.js)
|
|
- xterm.js 终端渲染 (支持 WebGL)
|
|
- Ghostty 风格 UI
|
|
- 跨平台支持 (Windows/macOS/Linux)
|
|
|
|
⏳ **WASM 集成待完成**
|
|
- libghostty-vt 源码已克隆到 `lib/ghostty/`
|
|
- 需要安装 Zig 0.13+ 编译为 WebAssembly
|
|
- WASM 加载框架已就绪 (`src/frontend/ghostty-vt.js`)
|
|
|
|
## 快速开始
|
|
|
|
```bash
|
|
cd ghostty-web
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
然后打开浏览器访问: http://localhost:3000
|
|
|
|
## 安装 Zig (用于编译 WASM)
|
|
|
|
**Windows:**
|
|
```powershell
|
|
winget install Ziglang.Zig
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
brew install zig
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
wget https://ziglang.org/download/0.13.0/zig-linux-x86_64-0.13.0.tar.xz
|
|
tar -xf zig-linux-x86_64-0.13.0.tar.xz
|
|
sudo mv zig-linux-x86_64-0.13.0 /opt/zig
|
|
```
|
|
|
|
## 编译 libghostty-vt WASM
|
|
|
|
```bash
|
|
# macOS/Linux
|
|
./scripts/build-wasm.sh
|
|
|
|
# Windows PowerShell
|
|
./scripts/build-wasm.ps1
|
|
```
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
ghostty-web/
|
|
├── package.json
|
|
├── README.md
|
|
├── Dockerfile
|
|
├── docs/
|
|
│ └── WASM_BUILD.md # WASM 编译详细指南
|
|
├── lib/
|
|
│ └── ghostty/ # ghostty 源码 (含 libghostty-vt)
|
|
├── scripts/
|
|
│ ├── build-wasm.sh # Linux/macOS 构建脚本
|
|
│ ├── build-wasm.ps1 # Windows PowerShell 构建脚本
|
|
│ └── install-zig.sh # Zig 安装脚本
|
|
└── src/
|
|
├── backend/
|
|
│ └── server.js # WebSocket + PTY 服务器
|
|
└── frontend/
|
|
├── index.html # 主页面
|
|
├── styles.css # Ghostty 风格样式
|
|
└── ghostty-vt.js # WASM 加载器
|
|
```
|
|
|
|
## 架构
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ 浏览器 │
|
|
│ ┌─────────────────────────────────────────────────────┐ │
|
|
│ │ xterm.js (终端渲染 + 输入处理) │ │
|
|
│ │ ghostty-vt.js (WASM 加载器，待集成) │ │
|
|
│ └─────────────────────────────────────────────────────┘ │
|
|
│ │ WebSocket │
|
|
└────────────────────────────┼────────────────────────────────┘
|
|
│
|
|
┌────────────────────────────▼────────────────────────────────┐
|
|
│ 后端服务器 │
|
|
│ ┌──────────────────┐ ┌───────────────────────────┐ │
|
|
│ │ WebSocket Server │ ◄─── │ node-pty (PTY 进程) │ │
|
|
│ │ (ws library) │ │ bash/powershell │ │
|
|
│ └──────────────────┘ └───────────────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## 功能
|
|
|
|
- ✅ 跨平台 PTY 支持
|
|
- ✅ WebGL 加速渲染
|
|
- ✅ 终端大小调整
|
|
- ✅ 新标签页
|
|
- ✅ 全屏模式
|
|
- ✅ 自定义外观 (Ghostty 风格深色主题)
|
|
|
|
## 环境变量
|
|
|
|
- `PORT` - 服务器端口 (默认: 3000)
|
|
|
|
## License
|
|
|
|
MIT |