network-infra-utility 0.2.0 → 0.5.0

data/service/ssh/bin/ssh-client

@@ -0,0 +1,198 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "thor"
+require_relative "../lib/network_infra_utility/ssh/client"
+
+module NetworkInfraUtility
+  module SSH
+    # CLI 入口，Thor 命令行框架。
+    # V1.0：简单读-发-收交互模式
+    # V2.0：升级为 curses 多面板 TUI
+    class CLI < Thor
+      desc "connect HOST", "连接到 SSH 服务器"
+      option :user, aliases: "-u", required: true, desc: "用户名"
+      option :port, aliases: "-p", type: :numeric, default: 22, desc: "端口"
+      option :key, aliases: "-i", desc: "私钥文件路径"
+      option :jump, aliases: "-J", desc: "跳板机 (user@host:port)"
+      option :name, desc: "会话名称"
+      option :password, type: :boolean, desc: "使用密码认证（交互输入）"
+      option :theme, desc: "终端配色主题"
+      option :connect_timeout, type: :numeric, desc: "连接超时（秒），默认60"
+      option :keepalive_interval, type: :numeric, desc: "保活心跳间隔（秒），默认30，设0禁用"
+      option :algorithms, type: :string, desc: "自定义算法，格式: kex=algo1,algo2;cipher=aes256-ctr"
+
+      def connect(host)
+        client = Client.new
+        client.start_engine
+
+        spec = {
+          host: host,
+          port: options[:port],
+          user: options[:user],
+          name: options[:name]
+        }
+        spec[:key_path] = options[:key] if options[:key]
+        spec[:jumps] = parse_jumps(options[:jump]) if options[:jump]
+
+        if options[:password]
+          spec[:auth] = { type: "password", password: ask_password }
+        end
+
+        spec[:terminal] = { theme: options[:theme] } if options[:theme]
+
+        # 场景2: 可配置连接超时
+        spec[:connect_timeout_ms] = options[:connect_timeout] * 1000 if options[:connect_timeout]
+
+        # 场景3: 可配置保活间隔
+        if options[:keepalive_interval]
+          if options[:keepalive_interval] > 0
+            client.ipc.call("keepalive.set_interval", { interval_ms: options[:keepalive_interval] * 1000 })
+          end
+        end
+
+        # 场景1: 自定义算法
+        spec[:algorithms] = parse_algorithms(options[:algorithms]) if options[:algorithms]
+
+        session = client.connect(spec)
+        terminal = session.open_terminal(theme: options[:theme])
+
+        say "Connected to #{options[:user]}@#{host}:#{options[:port]}", :green
+        say "Type 'exit' to disconnect.", :cyan
+        say ""
+
+        start_interactive(session, terminal)
+      rescue => e
+        warn "Error: #{e.message}"
+        exit 1
+      ensure
+        client&.stop
+      end
+
+      desc "batch FILE", "批量在多个会话上执行命令"
+      option :command, aliases: "-c", required: true, desc: "要执行的命令"
+      option :serial, type: :boolean, default: false, desc: "串行执行（默认并行）"
+
+      def batch(file)
+        sessions_spec = load_sessions_from_file(file)
+
+        client = Client.new
+        client.start_engine
+
+        sessions = sessions_spec.map do |spec|
+          session = client.connect(spec)
+          session.open_terminal
+          session
+        end
+
+        say "Executing '#{options[:command]}' on #{sessions.size} sessions...", :cyan
+
+        if options[:serial]
+          sessions.each do |session|
+            say "[#{session.name}] ", :yellow
+            session.terminal.send("#{options[:command]}\r")
+            sleep 2
+          end
+        else
+          threads = sessions.map do |session|
+            Thread.new do
+              session.terminal.send("#{options[:command]}\r")
+            end
+          end
+          threads.each(&:join)
+          sleep 2
+        end
+
+        say "Done.", :green
+      rescue => e
+        warn "Error: #{e.message}"
+        exit 1
+      ensure
+        client&.stop
+      end
+
+      desc "version", "显示版本信息"
+      def version
+        puts NetworkInfraUtility::SSH::VERSION
+      end
+
+      desc "themes", "列出自带配色主题"
+      def themes
+        Terminal::Theme.builtin_names.each { |name| puts "  #{name}" }
+      end
+
+      private
+
+      # V1.0：简单的读-发-收循环
+      # V2.0：升级为 curses 多面板 TUI
+      def start_interactive(session, terminal)
+        loop do
+          line = $stdin.gets
+          break if line.nil? || line.chomp == "exit"
+
+          if line.chomp == "quit"
+            break
+          end
+
+          terminal.puts(line.chomp)
+        end
+      rescue Interrupt
+        # Ctrl+C 退出
+        nil
+      end
+
+      # 解析跳板机参数
+      # @param jump_str [String] "user@host:port,user2@host2:port2"
+      # @return [Array<Hash>] [{user:, host:, port:}, ...]
+      def parse_jumps(jump_str)
+        jump_str.split(",").map do |j|
+          if j =~ /\A([^@]+)@([^:]+):(\d+)\z/
+            { user: Regexp.last_match(1), host: Regexp.last_match(2), port: Regexp.last_match(3).to_i }
+          else
+            raise "Invalid jump format: #{j} (expected user@host:port)"
+          end
+        end
+      end
+
+      # 交互式密码输入（不回显）
+      def ask_password
+        print "Password: "
+        system("stty -echo") if $stdin.tty?
+        password = $stdin.gets&.chomp
+      ensure
+        system("stty echo") if $stdin.tty?
+        puts
+      end
+
+      # 从文件加载会话列表
+      # @param file [String] YAML 文件路径
+      # @return [Array<Hash>]
+      def load_sessions_from_file(file)
+        require "yaml"
+
+        data = YAML.safe_load(File.read(file), symbolize_names: true)
+        raise "Invalid session file format" unless data.is_a?(Array) || data.is_a?(Hash)
+
+        data.is_a?(Hash) ? [data] : data
+      end
+
+      # 解析算法自定义参数
+      # 格式: kex=curve25519-sha256,diffie-hellman-group14-sha256;cipher=aes256-ctr
+      # @param str [String]
+      # @return [Hash] { kex: [...], cipher: [...], ... }
+      def parse_algorithms(str)
+        str.split(";").each_with_object({}) do |pair, result|
+          key, vals = pair.split("=", 2)
+          raise "Invalid algorithms format: #{pair}" unless vals
+
+          result[key.strip.to_sym] = vals.split(",").map(&:strip)
+        end
+      end
+    end
+  end
+end
+
+require_relative "../lib/network_infra_utility/ssh/version"
+require_relative "../lib/network_infra_utility/ssh/terminal/theme"
+
+NetworkInfraUtility::SSH::CLI.start(ARGV)

data/service/ssh/design/SSH/350/277/236/346/216/245/345/256/242/346/210/267/347/253/257/345/212/237/350/203/275/351/234/200/346/261/202/346/226/207/346/241/243.md

@@ -0,0 +1,292 @@
+
+# SSH 连接客户端功能需求文档
+
+> **文档版本**：v1.0  
+> **编写日期**：2026-08-02  
+> **文档状态**：初稿  
+
+---
+
+## 1 文档概述
+
+### 1.1 编写目的
+
+本文档定义 SSH 连接客户端产品的完整功能需求与非功能需求，为产品设计、开发、测试验收提供统一依据。所有功能需求均具有唯一编号与可量化的验收指标，确保可测试、可验收。
+
+### 1.2 产品范围
+
+本产品定位为面向网络工程师、运维人员、开发者的跨平台 SSH 终端管理工具，覆盖远程连接、会话管理、文件传输、端口转发、终端交互、自动化操作等核心场景。
+
+### 1.3 术语定义
+
+| 术语 | 定义 |
+|------|------|
+| SSH | Secure Shell，加密远程登录协议 |
+| SFTP | SSH File Transfer Protocol，基于 SSH 的文件传输协议 |
+| OTP | 一次性密码（One-Time Password），本文中指 2FA 场景 |
+| MOSH | Mobile Shell，支持漫游和丢包恢复的远程连接协议 |
+| X11 | X Window System 协议，用于远程图形应用转发 |
+| RTT | Round-Trip Time，连接往返延迟 |
+| FUR | First Useful Response，首次有效响应时间 |
+
+### 1.4 需求编号规则
+
+- 格式：`FR-<模块代号>-<三位序号>`
+- 模块代号：CONN（连接）、SESS（会话）、FILE（文件传输）、SEC（安全）、NET（网络）、TERM（终端）、AUTO（自动化）、COLLAB（协作）
+- 优先级：P0（必须）、P1（重要）、P2（增强）
+
+---
+
+## 2 总体要求
+
+### 2.1 用户角色
+
+| 角色 | 典型场景 |
+|------|----------|
+| 网络工程师 | 管理大量网络设备（交换机/路由器/防火墙），需要在数十台设备上批量执行命令 |
+| 运维工程师 | 日常服务器运维，文件传输，端口转发排查 |
+| 开发者 | 远程开发，端口转发到本地，多环境切换 |
+
+### 2.2 目标平台
+
+| 平台 | 版本要求 |
+|------|----------|
+| Windows | 10 及以上（x64） |
+| macOS | 12 Monterey 及以上 |
+| Linux | Ubuntu 20.04+ / CentOS 8+ / 通用 x64 |
+
+---
+
+## 3 功能需求
+
+### 3.1 连接管理（CONN）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-CONN-001 | SSH2 协议支持 | P0 | 支持 SSH-2 协议，覆盖主流密钥交换与认证算法 | ① 支持密钥交换算法 ≥ 6 种（curve25519-sha256、diffie-hellman-group14-sha256、diffie-hellman-group16-sha512、ecdh-sha2-nistp256/384/521 等）② 支持公钥算法 ≥ 5 种（rsa-sha2-256/512、ssh-ed25519、ecdsa-sha2-nistp256/384/521）③ 支持对称加密算法 ≥ 6 种（aes256-gcm、aes128-gcm、chacha20-poly1305 等）④ 支持消息认证算法 ≥ 4 种（hmac-sha2-256、hmac-sha2-512 等）⑤ 协议握手完成时间 ≤ 2s（局域网 RTT < 5ms 环境）|
+| FR-CONN-002 | 多认证方式 | P0 | 支持密码、公钥、键盘交互三种认证方式，单次连接支持多认证方式回退 | ① 支持认证方式 ≥ 3 种 ② 认证方式可配置优先级链（如公钥失败 → 密码）③ 密钥格式支持 ≥ 4 种（OpenSSH 格式、PuTTY .ppk、PKCS#8、SEC1）④ 密钥对生成支持 ≥ 3 种类型（RSA 2048/4096、ECDSA、Ed25519）|
+| FR-CONN-003 | 跳板机跳转 | P0 | 支持通过 ProxyJump 配置多级跳板登录目标主机 | ① 支持跳板级数 ≥ 3 级 ② 跳板链可视化配置界面 ③ 每级跳板可独立配置认证方式 ④ 跳板链连接建立总耗时 ≤ 3 × 单跳握手时间 + 1s |
+| FR-CONN-004 | 连接保活 | P0 | 支持 KeepAlive 心跳机制，防止 NAT 超时断连 | ① KeepAlive 间隔可配置，范围 5–300 秒 ② 连续丢失心跳 ≥ 3 次后判定断连并通知用户 ③ 空闲连接在无 KeepAlive 时存活时间 ≥ NAT 超时阈值（默认 30 分钟不主动断开）|
+| FR-CONN-005 | 自动重连 | P1 | 断线后自动重新建立连接，恢复会话上下文 | ① 重连尝试次数可配置，范围 1–10 次 ② 重连间隔可配置，范围 1–60 秒，支持指数退避 ③ 重连成功后终端回滚缓冲内容保留 ④ 网络恢复后自动重连触发延迟 ≤ 5s ⑤ 重连成功率 ≥ 95%（短暂网络中断 < 30s 场景）|
+| FR-CONN-006 | 多协议支持 | P1 | 除 SSH 外，支持 Telnet、Serial（串口）、RDP、VNC 协议连接 | ① 支持协议总数 ≥ 5 种 ② Telnet 协议支持协商终端类型与窗口大小 ③ Serial 支持波特率范围 300–921600，覆盖 ≥ 12 档标准值 ④ 每种协议可独立配置连接参数 |
+| FR-CONN-007 | MOSH 支持 | P2 | 支持 MOSH 协议，提供移动网络环境下的弹性连接 | ① 支持 IP 漫游，切换网络后恢复时间 ≤ 3s ② 丢包率 20% 环境下仍可保持交互 ③ 需要远程端安装 mosh-server |
+
+### 3.2 会话管理（SESS）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-SESS-001 | 标签页与窗口拆分 | P0 | 支持多标签页管理，支持窗口水平/垂直拆分 | ① 单窗口标签页上限 ≥ 50 ② 支持水平拆分、垂直拆分、嵌套拆分 ≥ 3 层 ③ 拖拽可调整拆分面板大小 ④ 拆分面板可独立关闭/最大化 |
+| FR-SESS-002 | 会话分组与树形管理 | P0 | 支持按项目/环境/机房对会话进行文件夹分组 | ① 支持分组嵌套层级 ≥ 5 层 ② 支持拖拽移动会话到不同分组 ③ 支持分组折叠/展开 ④ 单分组下会话数上限 ≥ 500 ⑤ 支持分组级别批量操作（如全部连接）|
+| FR-SESS-003 | 会话导入导出 | P1 | 支持 JSON/CSV 格式会话配置导入导出 | ① 支持导出格式 ≥ 2 种（JSON、CSV）② 导出数据包含完整连接参数，不包含明文密码 ③ 支持选择性导出（按分组/按会话）④ 导入时自动校验格式，冲突项给出明确提示 ⑤ 支持从 SecureCRT/XTerminal/MobaXterm 导入会话（兼容格式 ≥ 3 种第三方工具）|
+| FR-SESS-004 | 会话搜索 | P1 | 在会话列表中按名称/主机/IP/标签快速搜索 | ① 搜索字段覆盖 ≥ 4 个 ② 搜索响应时间 ≤ 200ms（1000 条会话）③ 支持模糊搜索与精确匹配切换 ④ 支持按标签筛选 |
+| FR-SESS-005 | 最近连接列表 | P1 | 快速访问最近使用的会话 | ① 最近列表保留条数 ≥ 20 ② 按使用时间倒序排列 ③ 支持置顶常用会话 |
+| FR-SESS-006 | 会话锁屏 | P2 | 临时离开时锁定全部会话 | ① 锁定后所有终端输入被屏蔽 ② 解锁需输入主密码 ③ 可配置自动锁屏超时时间，范围 1–60 分钟 |
+
+### 3.3 文件传输（FILE）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-FILE-001 | SFTP 可视化浏览器 | P0 | 内置 SFTP 文件浏览器，支持拖拽上传/下载 | ① 支持目录浏览层级无限制 ② 支持拖拽上传/下载 ③ 支持文件列表排序（名称/大小/修改时间/权限）④ 支持 ≥ 3 种视图模式（列表/详细/图标）⑤ 传输速度 ≥ 50 MB/s（千兆局域网，单文件 > 100MB）|
+| FR-FILE-002 | SCP 命令传输 | P0 | 支持命令行方式文件传输 | ① 支持 `scp` 命令完整语法 ② 支持递归传输目录（-r）③ 支持断点续传 ④ 传输完成后校验文件大小与哈希 |
+| FR-FILE-003 | 双面板同步浏览 | P1 | 终端与 SFTP 浏览器联动，当前目录自动同步 | ① 终端 `cd` 切换目录后，SFTP 面板 ≤ 1s 内自动跟随 ② SFTP 面板可手动锁定/解锁同步 ③ 同步延迟 ≤ 500ms |
+| FR-FILE-004 | ZMODEM（rz/sz） | P1 | 支持 rz/sz 命令在终端中直接上传/下载文件 | ① 自动检测 rz/sz 命令触发文件传输窗口 ② 支持批量文件传输 ③ 传输进度实时显示 ④ 传输中断后可重新发起 |
+| FR-FILE-005 | 批量文件传输 | P1 | 支持多选文件批量上传/下载，带进度条 | ① 批量传输文件数上限 ≥ 500 ② 支持并发传输通道数可配置，范围 1–10 ③ 每个文件独立进度条 + 总体进度条 ④ 传输失败自动重试次数可配，默认 3 次 |
+| FR-FILE-006 | 远程文件编辑 | P2 | 远程文件右键调用本地编辑器编辑，保存后自动上传 | ① 支持配置 ≥ 1 种外部编辑器 ② 自动监听文件修改并上传 ③ 上传前可预览 diff ④ 编辑超时阈值可配置，默认 30 分钟 |
+
+### 3.4 安全与凭据管理（SEC）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-SEC-001 | 凭据加密存储 | P0 | 会话密码与密钥使用强加密算法存储在本地 | ① 加密算法为 AES-256-GCM 或同等强度 ② 主密码不可逆存储（PBKDF2/Argon2，迭代 ≥ 100000 次）③ 配置文件中不存在明文凭据 ④ 密钥文件权限自动设为 600（Unix）/ ACL 限制（Windows）|
+| FR-SEC-002 | 主机密钥验证 | P0 | 首次连接记录主机指纹，后续连接校验一致性 | ① 首次连接弹出指纹确认对话框 ② 主机密钥变更时阻断连接并高亮告警 ③ 指纹算法覆盖 SHA-256/SHA-512 ④ 已知主机列表可查看/编辑/清空 ⑤ 支持按主机/IP 管理已知密钥 |
+| FR-SEC-003 | SSH Agent 集成 | P1 | 支持 ssh-agent 密钥管理与 Agent 转发 | ① 自动检测系统 ssh-agent ② 支持 Agent 转发配置（ForwardAgent）③ 支持密钥密码缓存时长可配置 ④ 密钥缓存超时范围 5 分钟–永不超时 |
+| FR-SEC-004 | 密钥对生成 | P1 | 内置密钥对生成功能 | ① 支持密钥类型 ≥ 3 种（RSA、ECDSA、Ed25519）② RSA 密钥长度可选 2048/3072/4096 ③ 生成时可配置密钥注释 ④ 支持设置密钥密码 ⑤ 可导出公钥格式 ≥ 2 种（OpenSSH、PEM）|
+| FR-SEC-005 | 凭据同步加密 | P2 | 跨设备同步凭据时端到端加密 | ① 同步数据客户端加密，服务端零知识 ② 加密密钥派生自主密码 + 设备盐 ③ 同步冲突时提供三方合并界面 |
+| FR-SEC-006 | 2FA/MFA 支持 | P2 | 支持双因素认证登录远程主机 | ① 支持 TOTP（RFC 6238）② 支持 keyboard-interactive 响应链 ③ OTP 种子可加密存储 ④ 支持 OTP 生成周期 30s/60s 可配置 |
+
+### 3.5 网络与代理（NET）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-NET-001 | 端口转发 | P0 | 支持本地/远程/动态端口转发 | ① 支持转发类型 3 种（Local、Remote、Dynamic）② 单会话可配置转发规则数 ≥ 20 条 ③ 可视化规则列表，支持启用/禁用单条规则 ④ 转发规则支持通配符端口 ⑤ 转发延迟开销 ≤ 2ms |
+| FR-NET-002 | SOCKS5/HTTP 代理 | P1 | SSH 连接可通过 HTTP/SOCKS5 代理发起 | ① 支持代理类型 ≥ 2 种（HTTP CONNECT、SOCKS5）② 代理认证支持用户名/密码 ③ 可按会话配置不同代理 ④ 代理连接超时可配置，默认 10s |
+| FR-NET-003 | X11 转发 | P2 | 支持远程图形应用的 X11 转发 | ① 内置 X Server 或可对接外部 X Server ② 支持单个应用窗口转发 ③ X11 转发延迟 ≤ 50ms（局域网）|
+| FR-NET-004 | 连接诊断 | P1 | 内置网络诊断工具 | ① 集成工具 ≥ 4 种（ping、traceroute、TCP 端口检测、DNS 解析）② ping 支持包数/包大小可配置 ③ 端口检测支持超时配置，精度 ≤ 100ms ④ 诊断结果一键复制 |
+| FR-NET-005 | 流量统计 | P2 | 显示每个会话的上下行流量统计 | ① 实时刷新间隔可配置，最小 1s ② 显示上行/下行/总量 ③ 支持按会话/按日/按月汇总 ④ 统计数据可导出 CSV |
+
+### 3.6 终端体验（TERM）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-TERM-001 | 终端仿真 | P0 | 支持多种终端仿真类型 | ① 支持终端类型 ≥ 3 种（xterm-256color、vt100、vt220）② 支持 256 色 + TrueColor（24 位）③ 支持 URL/文件路径/IP 自动识别可点击 ④ 正确处理 ANSI 转义序列覆盖率 ≥ 95% |
+| FR-TERM-002 | 主题与配色 | P0 | 支持自定义配色方案 | ① 内置配色方案 ≥ 10 套 ② 支持导入 iTerm2/VSCode 配色文件 ③ 可自定义 16 色调色板 + 前景/背景色 ④ 主题切换实时生效 |
+| FR-TERM-003 | 字体配置 | P0 | 支持自定义终端字体 | ① 支持任意等宽字体 ② 字号范围 8–32 ③ 支持行距调整 0.8–2.0 ④ 支持 Nerd Font / Powerline 字体正确渲染 ⑤ 中英文混排不错位 |
+| FR-TERM-004 | 快捷键定制 | P1 | 所有快捷键可自定义映射 | ① 可定制快捷键覆盖 ≥ 30 个操作 ② 支持快捷键方案预设 ≥ 3 套（默认/Vim/Emacs）③ 支持 Chord 组合键（如 Ctrl+X Ctrl+C）④ 冲突检测与提示 |
+| FR-TERM-005 | 搜索与高亮 | P1 | 终端内容搜索与关键词高亮 | ① 支持正则表达式搜索 ② 搜索范围可限定（当前屏幕/全缓冲区）③ 输入文本与输出文本视觉区分（颜色/背景）④ 关键词高亮数量无上限 ⑤ 搜索定位高亮，支持上一个/下一个导航 |
+| FR-TERM-006 | 日志记录 | P0 | 会话日志自动保存 | ① 支持自动/手动开启日志 ② 日志带时间戳（可配置格式）③ 单文件日志大小上限可配置，默认 100MB，超出后自动轮转 ④ 轮转文件保留数量可配置，默认 10 个 ⑤ 日志可按会话分文件存储 ⑥ 支持日志格式纯文本/HTML（带颜色还原）|
+| FR-TERM-007 | 回滚缓冲区 | P0 | 大容量回滚缓冲 | ① 默认缓冲行数 ≥ 10000 行 ② 可配置范围 1000–100000 行 ③ 回滚搜索响应 ≤ 200ms（10000 行缓冲）④ 缓冲内容可导出为文本文件 |
+| FR-TERM-008 | 输入同步/广播 | P1 | 同一输入同时发送到多个终端 | ① 支持选择 ≥ 2 个会话进行广播输入 ② 广播时可指定只输入不回车 ③ 支持组广播（按分组）④ 广播状态有明确视觉标识 ⑤ 紧急停止快捷键一键取消广播 |
+| FR-TERM-009 | 代码片段管理 | P1 | 常用命令片段保存和快速插入 | ① 片段支持变量占位符（如 `${ip}`、`${port}`）② 片段可分组管理 ③ 支持快捷搜索插入 ④ 单组片段数上限 ≥ 200 ⑤ 支持导入/导出片段库 |
+| FR-TERM-010 | 智能选中 | P1 | URL/路径/IP 自动识别并高亮 | ① 自动识别类型 ≥ 3 种（URL、文件路径、IP 地址）② 双击选中单词，三击选中整行 ③ Ctrl+点击 URL 在浏览器打开 ④ Ctrl+点击路径在 SFTP 面板定位 |
+| FR-TERM-011 | 窗口透明度 | P2 | 背景透明度调节 | ① 透明度范围 10%–100% ② 可配置是否在失焦时自动降低透明度 ③ 支持背景图片设置 |
+| FR-TERM-012 | 光标样式 | P2 | 光标样式可配置 | ① 光标形状 ≥ 3 种（块状/竖线/下划线）② 闪烁频率可配置 / 可关闭 ③ 光标颜色可自定义 |
+
+### 3.7 自动化（AUTO）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-AUTO-001 | 登录宏/脚本 | P0 | 连接后自动执行预设命令序列 | ① 单会话宏步骤数上限 ≥ 50 步 ② 每步支持配置等待匹配文本/正则后继续 ③ 步骤间延迟可配置 0–30s ④ 支持条件分支（匹配成功 A 路径/失败 B 路径）⑤ 宏执行失败可配置继续/中止/询问 |
+| FR-AUTO-002 | 会话录放 | P2 | 录制和回放终端操作 | ① 录制文件格式为标准 asciicast（asciinema 兼容）② 回放支持倍速 0.5x–4x ③ 回放支持暂停/跳转 ④ 录制时自动标注时间戳 |
+| FR-AUTO-003 | 命令批量执行 | P1 | 选择多个会话，同一命令同时下发 | ① 批量执行目标会话数上限 ≥ 100 ② 执行结果分面板显示 ③ 支持结果聚合对比（关键词高亮差异）④ 执行超时可配置，默认 30s ⑤ 支持串行/并行两种执行模式 |
+| FR-AUTO-004 | 本地 Shell 集成 | P1 | 内置本地终端入口 | ① 支持 Shell 类型 ≥ 3 种（Windows: PowerShell/CMD/WSL；macOS: zsh/bash；Linux: bash/zsh/fish）② 本地与远程会话在同一个标签管理下 ③ 支持 WSL 的自动检测与集成 |
+| FR-AUTO-005 | 脚本引擎扩展 | P2 | 支持 Lua/Python 脚本扩展 | ① 支持脚本语言 ≥ 1 种 ② 提供 API 接口 ≥ 20 个（会话管理、终端读写、文件操作等）③ 支持 Hook 机制（连接前/断开后/数据接收时）④ 脚本可注册自定义命令到菜单 |
+
+### 3.8 团队协作与跨平台（COLLAB）
+
+| 编号 | 功能名称 | 优先级 | 功能描述 | 量化验收指标 |
+|------|----------|--------|----------|--------------|
+| FR-COLLAB-001 | 跨平台支持 | P1 | Windows/macOS/Linux 三端覆盖 | ① 三端功能一致度 ≥ 95% ② 配置文件格式跨平台兼容 ③ 同一配置可在三端直接使用 ④ 安装包体积 ≤ 150MB（单平台）|
+| FR-COLLAB-002 | 配置云同步 | P2 | 会话/设置跨设备云端同步 | ① 同步内容覆盖会话配置、密钥、代码片段、主题 ② 端到端加密，服务端不可解密 ③ 同步延迟 ≤ 5s ④ 支持多设备同时在线 ⑤ 冲突检测与手动解决 |
+| FR-COLLAB-003 | 团队共享 | P2 | 团队共享会话配置，凭据不入库 | ① 共享内容分离：连接参数可共享、凭据不上传 ② 支持 RBAC 角色 ≥ 3 种（管理员/编辑者/只读）③ 共享空间支持分组 ④ 操作审计日志保留 ≥ 90 天 |
+| FR-COLLAB-004 | 便携版 | P2 | 免安装绿色版 | ① 全部配置存储在程序目录下 ② 无需管理员权限运行 ③ 可从 U 盘/云盘直接运行 ④ 便携版与安装版配置可互相迁移 ⑤ 便携版体积 ≤ 80MB |
+
+---
+
+## 4 非功能需求
+
+### 4.1 性能指标
+
+| 编号 | 指标名称 | 量化标准 |
+|------|----------|----------|
+| NFR-PERF-001 | 连接建立时间 | 局域网环境（RTT < 5ms）下 SSH 握手 + 认证完成 ≤ 2s |
+| NFR-PERF-002 | 终端渲染帧率 | 持续输出场景（如 `yes` 命令）下渲染帧率 ≥ 30fps |
+| NFR-PERF-003 | 终端输入延迟 | 按键到屏幕回显延迟 ≤ 50ms（局域网）|
+| NFR-PERF-004 | SFTP 传输速度 | 千兆局域网下单线程传输 ≥ 50 MB/s |
+| NFR-PERF-005 | 内存占用 | 10 个活跃会话同时运行，内存占用 ≤ 500MB |
+| NFR-PERF-006 | 并发会话数 | 单实例可稳定维持 ≥ 50 个活跃 SSH 会话 |
+| NFR-PERF-007 | 大缓冲渲染 | 50000 行回滚缓冲区内搜索，响应时间 ≤ 500ms |
+| NFR-PERF-008 | 启动时间 | 冷启动到主界面可交互 ≤ 3s |
+
+### 4.2 可靠性
+
+| 编号 | 指标名称 | 量化标准 |
+|------|----------|----------|
+| NFR-REL-001 | 连接稳定性 | 连续运行 72h 无崩溃，无内存泄漏（内存增长 ≤ 5%）|
+| NFR-REL-002 | 异常恢复 | 网络中断后程序不崩溃，恢复网络后自动重连成功率 ≥ 95% |
+| NFR-REL-003 | 数据完整性 | 文件传输后 MD5/SHA-256 校验通过率 100% |
+
+### 4.3 安全性
+
+| 编号 | 指标名称 | 量化标准 |
+|------|----------|----------|
+| NFR-SEC-001 | 凭据存储 | 本地配置文件、日志文件、内存 dump 中均无明文凭据 |
+| NFR-SEC-002 | 加密强度 | 密钥派生函数迭代次数 ≥ 100000 次（PBKDF2）或 Argon2id |
+| NFR-SEC-003 | 依赖安全 | 第三方库无已知 CVE 高危漏洞（发布前扫描）|
+
+### 4.4 可用性
+
+| 编号 | 指标名称 | 量化标准 |
+|------|----------|----------|
+| NFR-USE-001 | 学习成本 | 新手从安装到首次成功连接 SSH ≤ 5 分钟 |
+| NFR-USE-002 | 操作效率 | 常用操作（新建会话/连接/断开/传输文件）快捷键覆盖率 100% |
+| NFR-USE-003 | 国际化 | 支持中英文双语界面，语言可切换 |
+
+### 4.5 兼容性
+
+| 编号 | 指标名称 | 量化标准 |
+|------|----------|----------|
+| NFR-COMP-001 | 操作系统兼容 | Windows 10+, macOS 12+, Ubuntu 20.04+, CentOS 8+ |
+| NFR-COMP-002 | SSH 服务端兼容 | 兼容 OpenSSH 7.0+、Dropbear 2019+、Cisco IOS/IOS-XE、华为 VRP |
+| NFR-COMP-003 | 显示器适配 | 支持 HiDPI/4K 显示，1080p/2K/4K 下字体不模糊 |
+
+---
+
+## 5 版本规划
+
+### 5.1 V1.0 — MVP 核心（P0 需求）
+
+> 目标：可用的单用户 SSH 终端
+
+| 需求编号 | 功能名称 |
+|----------|----------|
+| FR-CONN-001 | SSH2 协议支持 |
+| FR-CONN-002 | 多认证方式 |
+| FR-CONN-003 | 跳板机跳转 |
+| FR-CONN-004 | 连接保活 |
+| FR-SESS-001 | 标签页与窗口拆分 |
+| FR-SESS-002 | 会话分组与树形管理 |
+| FR-FILE-001 | SFTP 可视化浏览器 |
+| FR-FILE-002 | SCP 命令传输 |
+| FR-SEC-001 | 凭据加密存储 |
+| FR-SEC-002 | 主机密钥验证 |
+| FR-NET-001 | 端口转发 |
+| FR-TERM-001 | 终端仿真 |
+| FR-TERM-002 | 主题与配色 |
+| FR-TERM-003 | 字体配置 |
+| FR-TERM-006 | 日志记录 |
+| FR-TERM-007 | 回滚缓冲区 |
+| FR-AUTO-001 | 登录宏/脚本 |
+
+### 5.2 V2.0 — 效率增强（P1 需求）
+
+> 目标：多会话批量管理、文件传输增强、网络诊断
+
+| 需求编号 | 功能名称 |
+|----------|----------|
+| FR-CONN-005 | 自动重连 |
+| FR-CONN-006 | 多协议支持 |
+| FR-SESS-003 | 会话导入导出 |
+| FR-SESS-004 | 会话搜索 |
+| FR-SESS-005 | 最近连接列表 |
+| FR-FILE-003 | 双面板同步浏览 |
+| FR-FILE-004 | ZMODEM（rz/sz）|
+| FR-FILE-005 | 批量文件传输 |
+| FR-SEC-003 | SSH Agent 集成 |
+| FR-SEC-004 | 密钥对生成 |
+| FR-NET-002 | SOCKS5/HTTP 代理 |
+| FR-NET-004 | 连接诊断 |
+| FR-TERM-004 | 快捷键定制 |
+| FR-TERM-005 | 搜索与高亮 |
+| FR-TERM-008 | 输入同步/广播 |
+| FR-TERM-009 | 代码片段管理 |
+| FR-TERM-010 | 智能选中 |
+| FR-AUTO-003 | 命令批量执行 |
+| FR-AUTO-004 | 本地 Shell 集成 |
+| FR-COLLAB-001 | 跨平台支持 |
+
+### 5.3 V3.0 — 差异化竞争力（P2 需求）
+
+> 目标：协作、跨平台同步、高级扩展
+
+| 需求编号 | 功能名称 |
+|----------|----------|
+| FR-CONN-007 | MOSH 支持 |
+| FR-SESS-006 | 会话锁屏 |
+| FR-FILE-006 | 远程文件编辑 |
+| FR-SEC-005 | 凭据同步加密 |
+| FR-SEC-006 | 2FA/MFA 支持 |
+| FR-NET-003 | X11 转发 |
+| FR-NET-005 | 流量统计 |
+| FR-TERM-011 | 窗口透明度 |
+| FR-TERM-012 | 光标样式 |
+| FR-AUTO-002 | 会话录放 |
+| FR-AUTO-005 | 脚本引擎扩展 |
+| FR-COLLAB-002 | 配置云同步 |
+| FR-COLLAB-003 | 团队共享 |
+| FR-COLLAB-004 | 便携版 |
+
+---
+
+## 附录 A：需求统计总览
+
+| 维度 | P0 | P1 | P2 | 合计 |
+|------|----|----|----|----|
+| 连接管理（CONN）| 4 | 2 | 1 | 7 |
+| 会话管理（SESS）| 2 | 3 | 1 | 6 |
+| 文件传输（FILE）| 2 | 3 | 1 | 6 |
+| 安全与凭据（SEC）| 2 | 2 | 2 | 6 |
+| 网络与代理（NET）| 1 | 2 | 2 | 5 |
+| 终端体验（TERM）| 5 | 4 | 3 | 12 |
+| 自动化（AUTO）| 1 | 2 | 2 | 5 |
+| 协作与平台（COLLAB）| 0 | 1 | 3 | 4 |
+| **合计** | **17** | **19** | **15** | **51** |