XCTerminal/README.md

# XCTerminal

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

## 功能特性

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

## 快速开始

### 开发

```bash
npm install
npm run dev
```

### 构建

```bash
npm run electron:build
```

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

### 使用

```bash
# 使用默认端口（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）

## 许可证

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