# whoterm

**Repository Path**: Error5o0/whoterm

## Basic Information

- **Project Name**: whoterm
- **Description**: 一个远程终端连接管理工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: feature/aichat
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# WhoTerm

**集成 AI 智能助手的现代化 SSH 终端客户端**

使用AI编辑器Qoder完成的该项目,基于 Tauri 2 + Vue 3 + Rust 构建，跨平台、轻量高性能，\
让服务器运维更智能、更专注。

[![Tauri](https://img.shields.io/badge/Tauri-2-orange)](https://tauri.app)
[![Vue](https://img.shields.io/badge/Vue-3-brightgreen)](https://vuejs.org)
[![Rust](https://img.shields.io/badge/Rust-1.70+-red)](https://www.rust-lang.org)
[![License](https://img.shields.io/badge/License-MIT-blue)](#许可证)

</div>

---

## ✨ 核心亮点

- 🤖 **AI 智能助手(开发中...)**：内置 SSH 运维智能体，支持自然语言提问、命令生成、执行结果分析，多轮计划生成与确认后逐步执行
- 🖥️ **高性能终端**：基于 xterm.js 的终端模拟器，支持 ANSI 转义序列与分屏多会话
- 📁 **SFTP 文件管理**：上传、下载、新建、删除、重命名，一站式文件传输
- 📊 **资源监控**：实时查看远程主机 CPU、内存、磁盘占用
- 🔐 **安全存储**：连接配置本地持久化，密码等敏感信息加密存储，支持 Git 同步
- 🎨 **深色科技感**：玻璃拟态视觉、深色/浅色主题、中英文界面、可自定义快捷键

## 🖼️ 界面预览

### 仪表板 · 使用记录

连接统计与最近连接一目了然。

![仪表板](docs/terminal-home.png)

### 终端 · AI 智能助手(开发中...)

右侧 AI 助手实时分析命令执行结果，生成处理计划并确认后逐步执行。

![终端与 AI 助手](docs/terminal.png)

### 终端 · SFTP 文件列表

终端下方集成文件列表面板，配合 AI 助手完成运维分析。

![SFTP 文件列表](docs/terminal-filelist.png)

### 设置

基础设置、外观、快捷键绑定与存储设置。

![设置](docs/terminal-settings.png)

## 🚀 功能特性

### AI 智能助手(开发中...)

- **多模型供应商**：支持 OpenAI、Anthropic、Ollama 及 OpenAI 兼容接口，可自定义 Base URL 与模型
- **思考过程可视化**：流式展示模型思考（thinking）与执行分析过程
- **执行 + 分析工作流**：生成操作计划 → 用户确认 → 逐条执行 → 结果分析并给出建议
- **上下文管理**：智能压缩会话上下文，控制 token 消耗

### 终端与连接

- **SSH 连接管理**：多会话连接，树形分组管理，可保存与复用连接配置
- **分屏终端**：可拖拽分屏布局，同时操作多个会话
- **命令历史与自动补全**：基于历史记录的智能补全与快速回溯
- **粘贴确认**：敏感命令粘贴前的安全确认提示

### 文件与监控

- **SFTP 文件传输**：浏览远程目录，上传 / 下载 / 新建 / 删除 / 重命名
- **资源监控**：CPU、内存、磁盘实时指标

### 体验与数据

- **仪表板统计**：已配置连接数、连接次数、使用时长等数据可视化
- **多语言**：中文 / 英文界面
- **主题定制**：深色 / 浅色主题切换
- **快捷键自定义**：可配置快捷键系统，支持冲突检测
- **配置持久化与加密**：本地存储连接与认证信息，敏感数据加密，支持 Git 同步

## 🧱 技术栈

### 前端

| 技术                                            | 说明                               |
| ----------------------------------------------- | ---------------------------------- |
| [Vue 3](https://vuejs.org/)                     | 响应式前端框架（`<script setup>`） |
| [TypeScript](https://www.typescriptlang.org/)   | 类型安全的 JavaScript 超集         |
| [Naive UI](https://www.naiveui.com/)            | Vue 3 组件库                       |
| [xterm.js](https://xtermjs.org/)                | 终端模拟器                         |
| [Pinia](https://pinia.vuejs.org/)               | 状态管理                           |
| [Vue Router](https://router.vuejs.org/)         | 路由管理                           |
| [vue-i18n](https://github.com/intlify/vue-i18n) | 国际化                             |
| [ECharts](https://echarts.apache.org/)          | 数据可视化图表                     |
| [Vite](https://vitejs.dev/)                     | 前端构建工具                       |

### 后端

| 技术                                                  | 说明                            |
| ----------------------------------------------------- | ------------------------------- |
| [Tauri 2](https://tauri.app/)                         | 跨平台桌面应用框架              |
| [Rust](https://www.rust-lang.org/)                    | 系统级编程语言                  |
| [russh](https://github.com/warp-tech/russh)           | SSH 客户端库                    |
| [russh-sftp](https://github.com/warp-tech/russh-sftp) | SFTP 协议支持                   |
| [rig](https://github.com/0xPlaygrounds/rig)           | LLM 应用与智能体框架（AI 助手） |
| [tokio](https://tokio.rs/)                            | 异步运行时                      |
| [git2](https://github.com/rust-lang/git2-rs)          | Git 操作库                      |

## 📦 安装与运行

### 环境要求

- Node.js >= 18
- pnpm >= 8
- Rust >= 1.70
- [Tauri 2 前置依赖](https://tauri.app/start/prerequisites/)（各平台系统依赖）

### 安装依赖

```bash
# 安装前端依赖
pnpm install
```

### 开发模式

```bash
# 启动开发服务器（前端 + Tauri）
pnpm tauri dev
```

### 构建应用

```bash
# 构建生产版本
pnpm tauri build
```

### 常用脚本

```bash
pnpm dev          # 仅启动前端 Vite 开发服务器
pnpm build        # 类型检查并构建前端
pnpm preview      # 预览前端构建产物
pnpm format       # Prettier 格式化源码
```

## 📂 项目结构

```
whoterm/
├── src/                     # 前端（Vue 3 + TypeScript）
│   ├── assets/              # 静态资源与样式
│   ├── components/          # 通用与布局组件
│   ├── composables/         # 组合式函数
│   ├── i18n/                # 国际化语言包
│   ├── router/              # 路由与菜单配置
│   ├── services/            # 服务层（Tauri IPC 调用）
│   ├── stores/              # Pinia 状态管理
│   ├── theme/               # 主题预设与管理
│   ├── types/               # TypeScript 类型定义
│   ├── utils/               # 工具函数
│   └── views/               # 页面视图
│       ├── dashboard/       # 仪表板
│       ├── settings/        # 设置页面
│       └── terminal/        # 终端页面（含 aichat / sftp / split-panel）
│
└── src-tauri/               # 后端（Rust + Tauri 2）
    ├── src/
    │   ├── assistant/       # AI 智能助手（providers / agent / context / prompts）
    │   ├── ssh/             # SSH 连接与 SFTP
    │   ├── store/           # 配置与数据存储
    │   ├── task/            # 任务管理
    │   ├── i18n/            # 后端国际化
    │   └── utils/           # 工具模块
    ├── prompts/             # AI 提示词模板（ssh / qa）
    ├── capabilities/        # Tauri 权限配置
    └── icons/               # 应用图标
```

## 🛠️ 开发指南

### 添加新功能

1. 在 `src/types/` 中定义相关类型
2. 在 `src-tauri/src/` 中实现 Rust 后端命令（command）
3. 在 `src/services/` 中封装前端调用
4. 在 `src/views/` 中创建页面组件
5. 在 `src/stores/` 中管理状态

### 国际化

- 前端语言文件位于 `src/i18n/locales/`，后端位于 `src-tauri/src/i18n/`
- 使用 `useLocale()` 组合函数获取翻译文本
- 前后端语言环境保持同步

### 主题定制

- 主题预设位于 `src/theme/presets/`，通过 `html` 的 `data-theme` 属性切换
- 支持深色 / 浅色主题
- 尺寸、颜色等通过 CSS 变量（design tokens）自定义

### AI 助手

- 模型供应商与提示词位于 `src-tauri/src/assistant/` 与 `src-tauri/prompts/`
- 支持 OpenAI / Anthropic / Ollama / OpenAI 兼容接口
- 在设置中配置供应商 Base URL、API Key 与模型即可使用

## 📄 许可证

[MIT License](LICENSE)