XCTerminal

基于 Electron 的无头终端应用，通过浏览器访问，支持 3x2 网格布局。

功能特性

• 网格布局终端面板（3 列 x 2 行）
• 实时终端输出，支持 PowerShell
• 支持 WebSocket 和 HTTP 输入
• 自动选择空闲端口
• 跨平台（Windows、macOS、Linux）

快速开始

开发

npm install
npm run dev

构建

npm run electron:build

构建产物位于 release/XCTerminal.exe。

使用

# 使用默认端口（3002）
./release/XCTerminal.exe

# 指定端口
./release/XCTerminal.exe --port=8080

# 或使用环境变量
PORT=8080 ./release/XCTerminal.exe

启动后访问 http://localhost:3002（或你指定的端口）。

项目结构

XCTerminal/
├── electron/          # Electron 主进程
│   ├── main.js       # 入口文件
│   └── preload.js    # 预加载脚本
├── src/              # React 前端
│   ├── App.tsx       # 主组件
│   └── components/   # UI 组件
├── server/           # 独立服务器（可选）
│   └── index.js      # 服务器入口
└── release/          # 构建产物

技术栈

• Electron（无头模式）
• React 19
• Vite
• Ghostty Web（终端模拟）
• node-pty（PTY 管理）
• Express（HTTP 服务器）
• WebSocket（实时 I/O）

许可证

私有项目 - 保留所有权利。