c-ssh

轻量级跨平台 SSH 客户端。Tauri 2 + React + xterm.js + ssh2（Rust），安装包仅约 2–3 MB，内存占用低，内置连接配置管理与主题系统。

功能特性

连接与终端

• 连接管理：分组、搜索、导入/导出（JSON）、新建/编辑表单
• 认证：密码 / 私钥 / SSH Agent（凭据存 OS keyring，不落盘）
• 多标签终端：标签保活（切换不丢内容）、拖动排序、固定序号（跟随连接身份）、Ctrl+Tab 最近使用切换
• 打开方式：连接项 ▶ 按钮单击 或 双击（鼠标悬停有提示）
• 断线自动重连、连接超时配置（3–60s）、Keep-Alive 心跳
• KEX 降级兼容：老服务器/设备（仅支持 group1-sha1/ssh-rsa 等旧算法）自动降级重试
• 终端体验：搜索（Ctrl+Shift+F）、URL 高亮、复制/粘贴（Ctrl+Shift+C、Ctrl+C 复制选中、右键复制、Ctrl+Shift+V/Shift+Insert 粘贴）、字号调节（Ctrl+= / Ctrl+-）
• 最近命令：右侧栏记录当前连接最近 50 条命令（SSH 按 username@host:port 共享、本地命令行共用一份），持久化到配置文件目录，宽度可拖拽，支持复制 / 重跑（重跑会记入历史）/ 删除 / 清空

SFTP 文件栏

• 软件全局右侧栏（📁 文件 / ≡ 最近命令，宽度均可拖拽；文件栏仅真实 SSH 连接）
• 浏览 / 上传 / 下载 / 新建目录 / 删除，每连接缓存目录状态（切换标签不重新拉取）
• 下载自动保留远程文件后缀；删除走系统原生确认对话框

高级

• 本地端口转发（SSH 隧道）、SOCKS5/HTTP 代理
• 软件内本地命令行（portable-pty / Windows ConPTY）：>_ 按钮在软件内打开 cmd/shell 标签

界面与主题

• 三栏布局：连接列表 / 标签+终端 / 文件栏，两侧宽度可拖拽调整（持久化）
• 主题系统：6 套内置主题（One Dark / Dracula / Nord / Solarized Light / 默认亮 / 默认暗）， 亮 / 暗 / 跟随系统三档，连接级覆盖，标题栏颜色跟随主题
• 主题定制：主题编辑器（含 divider 分隔色）、导入改名、导出 JSON；主题卡片直接展示主 UI 配色
• 自绘标题栏（拖拽 / 双击最大化 / 窗口控制）、全局禁用右键菜单
• 界面字号（字体与图标）与终端字号独立调节
• 全局控件风格化：滚动条轨道透明、数字输入框隐藏系统箭头、勾选框主题强调色

可靠性

• 全局错误日志：Rust panic、IPC 命令错误、会话错误、前端 JS 错误统一写入 data_dir/c-ssh/logs/app.log（1MB 轮转，不含密码/密钥），设置内可直接查看
• SSH 会话非阻塞模式 + 锁互斥（避免读写 / keepalive / SFTP 并发卡死）

快捷键

快捷键	功能
Ctrl+Tab	切换回上一个激活的连接标签（无则切下一个，单标签无操作）
Ctrl+Shift+C / Ctrl+C（有选中）	终端复制
Ctrl+Insert	终端复制（同 Ctrl+C，需有选中）
右键点击	终端粘贴（剪贴板内容）
Ctrl+Shift+V / Shift+Insert	终端粘贴
Ctrl+Shift+F	终端搜索
Ctrl+= / Ctrl+-	终端字号增大 / 减小

环境要求

• Node.js 18+（前端构建）
• Rust 工具链（Tauri 编译，首次需安装 rustup default stable）
• Windows 构建额外需要完整 Perl（winget install StrawberryPerl.StrawberryPerl），供 vendored OpenSSL 源码编译

开发

npm install
npm run tauri dev

构建与发布

npm run tauri build

产物：Windows（NSIS/MSI，约 2–3 MB）、macOS（dmg）、Linux（AppImage/deb）。 GitHub Actions 三平台矩阵构建，打 tag（如 v0.2.1）自动发布到 Release。

目录结构

src/            前端（React + TS）
  components/   Sidebar / ConnectionForm / TabBar / TerminalPane / SftpPanel / CommandsPanel / SettingsPanel / LogViewer / TitleBar
  stores/       zustand：connections / tabs / theme / settings
  themes.ts     内置主题定义
src-tauri/      Rust 后端
  src/ssh.rs    SSH/本地 shell 会话（ssh2 + portable-pty）
  src/store.rs  连接配置 JSON + keyring 凭据
  src/logger.rs 全局错误日志
  src/commands.rs  Tauri 命令（异步 + spawn_blocking）

详见 docs/ssh-client-design.md 设计方案与迭代记录。