# Yterminal

**Repository Path**: yanggan2021/yterminal

## Basic Information

- **Project Name**: Yterminal
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# YTerminal

一个用 Python + PySide6 写的桌面终端工具，目标体验接近 WindTerm，并且通过可扩展架构逐步融合/超越 MobaXterm 和 SecureCRT 的常用能力。

> **最新版本**：已集成 **连接历史、SFTP快捷访问、Button Bar、会话日志、XMODEM/YMODEM文件传输、端口转发UI、分屏显示** 等高级功能！

当前终端交互方式：**输入与显示在同一个终端视图中**（输入在底部，类似 WindTerm/MobaXterm）。

## 已实现功能

### ✅ 核心会话支持
- 本地 Shell（PowerShell/CMD/WSL）- 优先使用 ConPTY（Windows）
- SSH（密码 + 密钥认证）
- Serial Port（串口）
- Telnet

### ✅ 终端核心
- VT/ANSI 终端仿真（光标控制、清屏、颜色、私有模式序列）
- Windows ConPTY 后端（真实终端体验）
- 命令历史（上下键）
- 搜索（Ctrl+F）
- 暗色/亮色主题切换

### ✅ 文件传输
- SFTP 文件浏览（列目录、进入目录）
- SFTP 下载/上传
- SFTP 快捷访问（Session Tree → SSH → [SFTP Browser...]）
- 串口文件传输（XMODEM/YMODEM协议）

### ✅ 会话管理
- 会话列表分组（Local/SSH/Serial/Telnet）
- **连接历史记忆**（最近连接自动保存，快速重连）
- 导入/导出会话配置（JSON）
- **会话日志记录**（自动保存到 ~/.yterminal/logs/）

### ✅ 高级功能
- **Button Bar（按钮栏）**：可编程快捷按钮，发送自定义命令（SecureCRT风格）
- **SSH端口转发**：本地/远程端口转发配置UI
- **分屏显示**：水平/垂直分割终端（Ctrl+Shift+H/V）

### ✅ 界面与交互
- 多标签页
- 快捷键：Ctrl+T（新标签）、Ctrl+W（关闭标签）、Ctrl+F（搜索）、Ctrl+L（清屏）
- 菜单：File / Session / Tools / View

## 运行

建议使用虚拟环境：

```powershell
cd D:\code\YTerminal
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -U pip
pip install -e .

yterminal
```

可运行非 GUI 的冒烟测试：

```powershell
yterminal-smoke
python -m unittest discover -s tests -p "test_*.py" -q
```

## 快速入门

**连接 SSH**：左侧树 → SSH (Connect...) → 填写连接信息 → OK（SFTP 面板自动打开）  
**串口通信**：左侧树 → Serial Port (Connect...) → 选择端口/波特率 → OK  
**搜索**：Ctrl+F → 输入关键词 → Next/Prev  
**主题**：View → Dark Theme / Light Theme  
**会话导出**：File → Export Sessions  

详细功能说明见：[docs/quick_start.md](docs/quick_start.md)

## 规划中的增强功能

- 分屏（水平/垂直）- UI 已预留，待完整实现
- SSH 端口转发（Local/Remote/Dynamic）- 后端已实现，待集成 UI
- 工作区保存/恢复
- 宏/脚本（Python/Lua）
- 关键字高亮、触发器
- 跳板机链路
- 更完整的 VT 序列支持（全屏程序如 vim/top）
- 插件系统

## 目标能力（规划）

- 多标签/分屏终端
- 会话与配置文件（Local/SSH/Serial/Telnet 等）
- SSH + SFTP 文件浏览、上传下载
- 端口转发、跳板机、多级代理
- 关键字高亮、命令面板、快捷键体系
- 插件化：把 "更强大" 能力做成可插拔模块

更多功能拆解与路线图见：
- [docs/feature_matrix.md](docs/feature_matrix.md) - 功能对比与规划
- [docs/integration_report.md](docs/integration_report.md) - 集成报告与测试验证
- [docs/quick_start.md](docs/quick_start.md) - 快速入门指南