Files
XCTerminal/README.md

73 lines
1.4 KiB
Markdown
Raw Normal View History

2026-03-20 13:39:10 +08:00
# XCTerminal
2026-03-20 13:39:58 +08:00
基于 Electron 的无头终端应用,通过浏览器访问,支持 3x2 网格布局。
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
## 功能特性
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
- 网格布局终端面板3 列 x 2 行)
- 实时终端输出,支持 PowerShell
- 支持 WebSocket 和 HTTP 输入
- 自动选择空闲端口
- 跨平台Windows、macOS、Linux
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
## 快速开始
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
### 开发
2026-03-20 13:39:10 +08:00
```bash
npm install
npm run dev
```
2026-03-20 13:39:58 +08:00
### 构建
2026-03-20 13:39:10 +08:00
```bash
npm run electron:build
```
2026-03-20 13:39:58 +08:00
构建产物位于 `release/XCTerminal.exe`
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
### 使用
2026-03-20 13:39:10 +08:00
```bash
2026-03-20 13:39:58 +08:00
# 使用默认端口3002
2026-03-20 13:39:10 +08:00
./release/XCTerminal.exe
2026-03-20 13:39:58 +08:00
# 指定端口
2026-03-20 13:39:10 +08:00
./release/XCTerminal.exe --port=8080
2026-03-20 13:39:58 +08:00
# 或使用环境变量
2026-03-20 13:39:10 +08:00
PORT=8080 ./release/XCTerminal.exe
```
2026-03-20 13:39:58 +08:00
启动后访问 `http://localhost:3002`(或你指定的端口)。
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
## 项目结构
2026-03-20 13:39:10 +08:00
```
XCTerminal/
2026-03-20 13:39:58 +08:00
├── electron/ # Electron 主进程
│ ├── main.js # 入口文件
│ └── preload.js # 预加载脚本
├── src/ # React 前端
│ ├── App.tsx # 主组件
│ └── components/ # UI 组件
├── server/ # 独立服务器(可选)
│ └── index.js # 服务器入口
└── release/ # 构建产物
2026-03-20 13:39:10 +08:00
```
2026-03-20 13:39:58 +08:00
## 技术栈
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
- Electron无头模式
2026-03-20 13:39:10 +08:00
- React 19
- Vite
2026-03-20 13:39:58 +08:00
- Ghostty Web终端模拟
- node-ptyPTY 管理)
- ExpressHTTP 服务器)
- WebSocket实时 I/O
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
## 许可证
2026-03-20 13:39:10 +08:00
2026-03-20 13:39:58 +08:00
私有项目 - 保留所有权利。