# NexTerm

**Repository Path**: lightnehum/nex-term

## Basic Information

- **Project Name**: NexTerm
- **Description**: 基于.Net的现代化SSH工具
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-15
- **Last Updated**: 2026-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NexTerm

基于 **.NET 10 + WPF** 的现代化 Windows SSH 客户端，面向远程 Linux 日常运维。

目标是把多会话终端、SFTP 文件管理、跳板机、端口转发和运维操作整合在一个本地优先的工作台中。

## 使用教程

首次使用请阅读 [详细使用教程](docs/user-guide.md)，包含连接与认证、终端、SFTP、远程编辑、命令库、监控、Docker/Kubernetes、跳板与隧道，以及常见问题排查。

软件内选择 **菜单 → 使用帮助**，或在主窗口按 **F1**，可离线阅读同一份教程，支持章节目录和全文关键词筛选。

## 当前状态

已进入开发阶段，提供可构建的 WPF 工作台、SSH/SFTP/隧道适配及自研原生 WPF 终端组件。主界面布局位于 XAML，设计器可直接预览；不使用 HTML、JavaScript 或 WebView2。

当前为开发版，尚未完成 V1.0 全量功能、真实服务器兼容性和性能验收。实现与验证边界见 [开发指南](docs/development.md)、[验证记录](docs/verification.md) 和 [原生终端决策](docs/adr/0001-native-wpf-terminal.md)。

```powershell
dotnet restore NexTerm.slnx --configfile NuGet.Config
dotnet run --project src/NexTerm.App -c Release
```

开发环境需要 Windows 和 .NET 10 SDK。运行全部测试：`dotnet test NexTerm.slnx -c Release`。

生成可选择安装目录、可勾选桌面快捷方式的单文件 EXE 安装包：`powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-installer.ps1`。工具安装、输出路径和下载分发说明见 [打包命令存档](docs/packaging.md)。安装包产物位于 Git 忽略的 `artifacts/` 目录。

内置公共命令提示：输入 Linux、Docker、Compose 或 kubectl 命令时显示中文用途、用法和常用参数。按 `↓` 选择、`Enter` 填入，或直接单击候选项；填入后再次按 `Enter` 执行。`Ctrl+Space` 手动打开，`Esc` 关闭，`Tab` 保留远端补全。公共 JSON 与用户数据分离，可随 Git 共享；覆盖范围、使用边界与贡献格式见 [公共命令库](src/NexTerm.Application/CommandCatalog/README.md)。

右侧“命令”面板位于监控下方、Docker / K8s 上方，按功能分组展示命令与用途，支持搜索和类别筛选。点击每行“使用”填入当前终端，双击查看用途、用法和参数详情。

## 设计文档

1. [需求与功能范围](docs/design/01-requirements.md)：用户场景、功能清单、版本边界、非功能目标。
2. [界面与交互设计](docs/design/02-ux-design.md)：布局、页面、流程、视觉与键盘规范。
3. [技术架构](docs/design/03-architecture.md)：技术选型、模块、终端链路、接口和状态机。
4. [数据与安全设计](docs/design/04-data-security.md)：实体、凭据、主机信任、备份与安全边界。
5. [实施与验收计划](docs/design/05-delivery-plan.md)：技术验证、迭代、测试矩阵、决策事项。

建议按以上顺序阅读。首发稳定版以需求矩阵中的 **V1.0** 为准。

## 设计基线

- Windows 11 x64、`net10.0-windows`、WPF、MVVM。
- 个人和小团队运维，本地存储，不要求 Linux 安装专用 Agent。
- 自研 C# VT/ANSI 核心 + 原生 WPF 绘制终端，SSH.NET 作为 SSH/SFTP 实现。
- 严格主机身份校验、本地凭据加密、明确的生产环境标识。

## 许可证

[Apache License 2.0](LICENSE)。第三方库、字体和分发运行时的许可证另行核验。