feat: add terminal broadcast, context menu, and shell close

Complete multi-pane broadcast, standard terminal right-click actions, batch host selection with progress, and native ssh_close_shell so closing a pane tears down the remote shell. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-05 19:53:39 +08:00
1 parent 494ef6b9d0
commit 9ce71795b8
@@ -2,12 +2,13 @@

 文档按使用、开发、验收和发布分开维护，避免把规划能力写成已支持功能。

-| 文档                                | 内容                                         |
-| ----------------------------------- | -------------------------------------------- |
-| [使用指南](./user-guide.md)         | SSH、SFTP、代理、串口、AI 助手和数据安全     |
-| [架构说明](./architecture.md)       | Tauri/Rust 分层、原生服务、AI 与安全边界     |
-| [SSH Agent CLI](./ai-agent.md)      | ReAct 执行循环、工具、风险、记忆取舍与评测   |
-| [测试验收](./testing-acceptance.md) | 本地门禁、真实 SSH 探针和发版验收            |
-| [发布指南](./release.md)            | macOS/Windows 构建、签名、产物和临时文件清理 |
+| 文档                                         | 内容                                              |
+| -------------------------------------------- | ------------------------------------------------- |
+| [使用指南](./user-guide.md)                  | SSH、SFTP、代理、串口、AI 助手和数据安全          |
+| [架构说明](./architecture.md)                | Tauri/Rust 分层、原生服务、AI 与安全边界          |
+| [SSH Agent CLI](./ai-agent.md)               | ReAct 执行循环、工具、风险、记忆取舍与评测        |
+| [产品体验全面评估](./ux-foundation-audit.md) | 全产品评分、大众操作习惯、P0/P1/P2 与统一回归清单 |
+| [测试验收](./testing-acceptance.md)          | 本地门禁、真实 SSH 探针和发版验收                 |
+| [发布指南](./release.md)                     | macOS/Windows 构建、签名、产物和临时文件清理      |

 项目定位、功能概览和开发命令见仓库根目录的 [README](../README.md)，未完成事项只在 [ROADMAP](../ROADMAP.md) 维护。
@@ -7,7 +7,7 @@

 OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的 WebSocket、服务器资产库、审计、审批、Kubernetes 专用工具和默认持久化记忆。

-产品目标是：用户在已连接的 SSH 终端中输入自然语言任务，Agent 通过少量、边界清晰的工具获取真实证据，在每次真实执行前展示命令和风险并等待确认，失败后根据输出换方法，最后给出有证据的结论。
+产品目标是：用户在已连接的 SSH 终端中输入自然语言任务，Agent 通过少量、边界清晰的工具获取真实证据，按用户选择的安全模式决定确认阈值，失败后根据输出换方法，最后给出有证据的结论。无论选择哪种模式，目标主机始终可见，critical 命令始终硬拒绝。

 ## 参考来源

@@ -35,7 +35,7 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
  -> LLM 选择下一条单行命令，或返回 FINAL
  -> 五级命令风险评估
  -> critical 破坏性操作硬拒绝
-  -> 显示目标、风险和命令，用户显式确认
+  -> 按本次运行锁定的安全模式决定是否确认
  -> ssh_execute 使用当前 connectionId
  -> 返回 stdout + stderr + exit_code
  -> 输出过长时本地 analyze_output
@@ -43,7 +43,7 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
  -> 失败换方法 / 继续验证 / FINAL
 ```

- 单次任务最多 8 步。aiops 默认 16 轮适合后端异步任务；OpsXShell 每步都显式确认，8 步更符合桌面 GUI 的注意力和成本边界。
+- 单次任务最多 8 步。aiops 默认 16 轮适合后端异步任务；OpsXShell 是前台桌面工具，8 步更符合注意力、时延和成本边界。
 - 相同命令最多出现 2 次，第 3 次在执行前停止。
 - 第 4 轮检查是否已有足够证据，第 8 轮强制优先收敛；连续失败时 Prompt 要求更换排查路径。
 - 单步输出进入 Agent 前有 12,000 字符上限，任务观察上下文有 48,000 字符上限。
@@ -51,15 +51,15 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的

 ### 安全边界

-| 等级     | 示例                              | 当前处理               |
-| -------- | --------------------------------- | ---------------------- |
-| safe     | `df -h`、`journalctl -u nginx`    | 显示后确认             |
-| low      | 未知自定义查询命令                | 显示后确认             |
-| medium   | 文件写入、普通权限变更            | 风险提示后确认         |
-| high     | 服务重启、删除、包安装、K8s 变更  | 红色风险确认           |
-| critical | 格式化磁盘、删除根目录、fork bomb | 硬拒绝，不显示放行按钮 |
+| 等级     | 示例                              | 严格模式 | 均衡模式（默认） | 宽松模式 |
+| -------- | --------------------------------- | -------- | ---------------- | -------- |
+| safe     | `df -h`、`journalctl -u nginx`    | 自动执行 | 自动执行         | 自动执行 |
+| low      | 未知自定义查询命令                | 自动执行 | 自动执行         | 自动执行 |
+| medium   | 文件写入、普通权限变更            | 先确认   | 自动执行         | 自动执行 |
+| high     | 服务重启、删除、包安装、K8s 变更  | 先确认   | 先确认           | 自动执行 |
+| critical | 格式化磁盘、删除根目录、fork bomb | 硬拒绝   | 硬拒绝           | 硬拒绝   |

-此处不直接引入 aiops 的 `strict / balanced / permissive` 三级模式。原因是 OpsXShell 已对用户承诺“AI 每次真实执行前显式确认”，`permissive` 静默执行会破坏这条简单、可理解的规则。未来如需减少确认，应引入边界更明确的“仅允许 Rust 认定的纯只读命令自动执行”，而不是模糊的宽松模式。
+安全模式在任务开始时锁定，运行中不能切换；需要确认时，对话框必须显示本次锁定模式、目标、风险和完整单行命令。宽松模式明确标注“仅适合隔离测试环境”，它不会降低 critical 硬红线。

 终端输出被标记为不可信数据，不得将日志中的“忽略规则”等文字当作指令。常见密码、Token、Authorization Header、AWS Key 和私钥块在 Rust 发送 Provider 前脱敏。

@@ -74,10 +74,10 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
 | OpenAI / Anthropic LLM 适配 | 已吸收         | 保留 OpenAI Chat、Responses、Anthropic Compatible 及自定义 Provider           |
 | `ssh_execute`               | 已吸收         | 固定使用当前活跃 `connectionId`，不重新管理一套凭据                           |
 | `analyze_output`            | 已适配         | 本地确定性摘要，降低 token 和幻觉                                             |
-| ReAct 16 轮                 | 适配为 8 步    | GUI 每步确认，优先快速收敛                                                    |
+| ReAct 16 轮                 | 适配为 8 步    | GUI 前台执行，优先快速收敛                                                    |
 | 失败反馈和循环检测          | 已吸收         | 退出码和真实输出回传，连续失败换路，相同命令限次                              |
-| 五级风险                    | 已吸收         | critical 硬拒绝，其他均显式确认                                               |
-| 三级安全模式                | 暂不吸收       | 保持单一可理解的“每步确认”规则                                                |
+| 五级风险                    | 已吸收         | critical 硬拒绝，其他等级按安全模式阈值确认                                   |
+| 三级安全模式                | 已适配         | 严格从 medium、均衡从 high 确认；宽松仍不可绕过 critical                      |
 | WebSocket 事件流            | 不照搬         | 本地 React/Tauri 没有跨程服务器会话，使用内存状态即可                         |
 | 审计、审批、RBAC            | 不引入         | 属于 aiops/堡垒机，不是本地 SSH 客户端职责                                    |
 | podexec/K8s 专用工具        | 不引入         | `kubectl/helm` 可沿远程 SSH 工具使用，不引入第二套目标和凭据边界              |
@@ -68,7 +68,7 @@ XTerm 当前焦点分屏
  -> AiService (OpenAI Chat / Responses / Anthropic)
  -> 下一条唯一单行命令 / FINAL 结论
  -> 五级风险；critical 硬拒绝
-  -> 展示目标、命令和风险，用户确认
+  -> 按本次运行锁定的安全模式决定是否确认
  -> 当前 connectionId 的 ssh_exec
  -> stdout/stderr/exit_code + 本地 analyze_output
  -> 真实观察脱敏后交给 AI 判断下一步
@@ -83,8 +83,8 @@ XTerm 当前焦点分屏
 - AI 对话、提示词、终端上下文、命令和工具输出只存在当前面板内存中；关闭面板即清空。
 - 新 Provider 的测试命令接收临时 API Key 并发出最小真实完成请求；测试过程不调用凭据存储。只有当前连接字段快照测试成功，界面才允许保存。
 - 模型返回内容按不可信文本处理；终端输出也标记为不可信，其中的指令不能覆盖 system Prompt。
- Agent 只接受唯一单行命令，目标固定为当前活跃 SSH connection；每次调用 `ssh_exec` 前都显示目标、命令和风险确认。
- 命令风险为 safe/low/medium/high/critical 五级；格式化磁盘、删除根目录等 critical 操作硬拒绝。当前不引入会静默执行的“宽松模式”。
+- Agent 只接受唯一单行命令，目标固定为当前活跃 SSH connection；本次运行开始后安全模式锁定，确认框必须显示目标、命令、风险和锁定模式。
+- 命令风险为 safe/low/medium/high/critical 五级。严格模式从 medium 起确认；默认均衡模式从 high 起确认；宽松模式仅适合隔离测试环境。格式化磁盘、删除根目录等 critical 操作在任何模式下都硬拒绝。
 - 相同命令第 3 次在执行前拦截；连续失败时要求更换排查路径。长输出先经本地 `analyze_output` 保留错误行和首尾。
 - 不创建独立 Kubernetes 客户端或 podexec。集群运维命令沿当前 SSH 会话执行，避免引入本机 kubeconfig 与第二套目标/凭据边界。

@@ -9,14 +9,14 @@
 # macOS Apple Silicon 指定版本
 ./build.sh v2.1.1 mac-arm64

-# Windows x86_64（在 Windows Git Bash 中执行）
-./build.sh v2.1.1 win-x64
+# Windows x86_64（推荐在 Windows CMD/PowerShell 中执行）
+build.bat v2.1.1 win-x64

 # 本地重复构建时缩短门禁；正式发布不要跳过
 ./build.sh v2.1.1 mac-arm64 --quick
 ```

-脚本面向 v2.1.x，会检查 Node、npm、Rust target 和五处版本元数据。显式传入不同于当前源码的新版本时，脚本会同步版本文件；它只负责构建，不会自动创建 tag 或推送远程仓库。安装包和 `SHA256SUMS.txt` 输出到：
+`build.sh` 与 `build.bat` 面向 v2.1.x，会检查 Node、npm、Rust target 和五处版本元数据。显式传入不同于当前源码的新版本时，脚本会同步版本文件；它们只负责构建，不会自动创建 tag 或推送远程仓库。安装包和 `SHA256SUMS.txt` 输出到：

 ```text
 release/v2.1.1/macos-arm64/
@@ -25,6 +25,27 @@ release/v2.1.1/windows-x64/

 平台安装包必须在目标系统构建和验证。macOS 不能替代 Windows x86_64 实机打包。

+### Windows 构建环境
+
+建议使用 Windows 10/11 x64，并安装：
+
+- Node.js 18+ 与 npm
+- Rust stable 的 `x86_64-pc-windows-msvc` toolchain
+- Visual Studio 2022 Build Tools，勾选 **Desktop development with C++**
+- Windows 10/11 SDK
+- Microsoft Edge WebView2 Runtime
+
+首次准备：
+
+```bat
+rustup default stable-x86_64-pc-windows-msvc
+rustup target add x86_64-pc-windows-msvc
+npm ci
+build.bat v2.1.1 win-x64
+```
+
+默认执行完整门禁；`--quick` 适合开发期重复构建，正式发布不要使用 `--skip-checks`。输出位于 `release\v2.1.1\windows-x64\`。没有代码签名证书时可以生成开发安装包，但 Windows SmartScreen 可能提示未知发布者。
+
 ## Gitee Release

 构建、提交并推送对应 tag 后执行：
@@ -36,7 +36,7 @@ npm run acceptance:full
 - API Key 只进入 Rust secrets，不出现在 `ai-providers-v1`、日志或 WebView 返回值中
 - Agent CLI 单任务入口、回车发送、选区上下文、本地脱敏、单行命令协议和最终结论
 - 新 Provider 测试前不落盘，真实测试成功后才启用保存；任一连接字段变化会使验证快照失效
- Agent 固定当前 SSH connection，每步确认前不得调用 `ssh_exec`，退出码与真实输出反馈下一轮且不进入历史
+- Agent 固定当前 SSH connection；达到当前安全模式确认阈值时，确认前不得调用 `ssh_exec`；退出码与真实输出反馈下一轮且不进入历史
 - Agent 五级命令风险、critical 硬拒绝、连续失败换路、相同命令循环拦截和长输出 `analyze_output`
 - 远程 Shell EOF/TMOUT 事件不得误判为整个 SSH 连接断开；只为对应分屏提供一键重开
 - macOS 原生“编辑”菜单以及所有输入框的复制、剪切、粘贴、全选、撤销；应用快捷键不得覆盖这些系统操作
@@ -58,7 +58,7 @@ npm run acceptance:full
 8. models.dev 三个源全部失败时不影响已保存 Provider；部分成功时仍能生成可导入目录。
 9. 新增 Provider 后测试前“保存”禁用；测试实际发送“你是什么模型？请简短回答。”，期间 settings 与 secrets 均无写入；只有非空成功回答显示 HTTP 200，随后保存才写入加密 Key。
 10. 切换 Endpoint、模型、协议或 API Key 后“保存”立即重新禁用。
-11. 每一轮只接受唯一单行命令；确认对话框打开前和用户取消后 `ssh_exec` 调用次数必须为 0。
+11. 每一轮只接受唯一单行命令；默认均衡模式下 safe/low/medium 自动执行、high 先确认；严格模式从 medium 起确认；宽松模式不允许绕过 critical 硬拒绝。需要确认时，对话框打开前和用户取消后 `ssh_exec` 调用次数必须为 0。
 12. 确认后只向当前 connectionId 执行；真实输出和 exit code 必须交给下一轮，直到 FINAL 或 8 步上限。
 13. `rm -rf /`、`mkfs`、对磁盘覆盖的 `dd` 等 critical 命令必须在确认对话框前硬拒绝。
 14. 相同命令第 3 次必须在执行前拦截；连续失败的下一轮 Prompt 必须要求更换路径。
@@ -74,10 +74,12 @@ SFTP 使用双栏文件管理器。上传和下载先写入 `.opsx-part` 临时

 - `Cmd/Ctrl + D`：分屏当前终端
 - `Cmd/Ctrl + W`：关闭当前标签
+- 终端右键菜单提供复制、粘贴、全选、清屏、向右/向下分屏、最大化/恢复和关闭当前分屏；没有选区时“复制”保持禁用，不会一次右键就直接粘贴。
+- “广播”作用于所有已打开且已连接的 SSH 终端标签和分屏，按钮显示实时目标数；本地 Shell 不加入远程广播。目标不足两个时广播自动关闭。
 - 会话侧栏进入批量模式后，可同时打开终端、SFTP，或在多个主机执行同一条命令
 - 如果远端 Bash 因 `TMOUT` 显示 `timed out waiting for input: auto-logout`，OpsXShell 会标记只有该 Shell/分屏退出。SSH 连接、其他分屏、SFTP 和隧道仍可用，点击“重新打开 Shell”即可继续。

-批量命令结果只保留在当前弹窗。OpsXShell 不持久化终端命令历史。
+批量命令弹框可以再次搜索、全选或调整主机，执行区逐主机显示连接/运行状态、输出、耗时与总进度。结果只保留在当前弹窗；OpsXShell 不持久化终端命令历史。

 ## 本地终端与串口

@@ -99,7 +101,7 @@ SFTP 使用双栏文件管理器。上传和下载先写入 `.opsx-part` 临时

 - 直接输入任务，例如“排查 nginx 为什么启动失败并修复”。回车发送，`Shift+回车` 换行；不需要先选“解释 / 生成命令 / 排障 / 执行”。
 - 有终端选区时会作为初始上下文；没有选区时不抓取整屏，Agent 通过真实 `ssh-exec` 自主取证。
- Agent 最多执行 8 步。每步只能准备一条单行命令，界面会显示当前主机、命令和五级风险；你确认后才真实执行。
+- Agent 最多执行 8 步。每步只能准备一条单行命令，界面会显示当前主机、命令和五级风险。默认“均衡”模式仅高风险命令确认；“严格”从中风险开始确认；“宽松”仅保留 critical 硬拒绝，适合隔离测试环境。
 - 格式化磁盘、删除根目录等 critical 命令会被硬拒绝，不提供确认放行。相同命令第 3 次会在执行前拦截。
 - 执行后的真实输出和退出码会回给 AI，用于判断下一步或收敛结论。连续失败时 Agent 会被要求换方法。
 - 长输出由本地 `analyze_output` 提取错误行并保留首尾；Rust 在发给云模型前做常见敏感信息脱敏。
@@ -0,0 +1,173 @@
+# 产品体验与基础能力全面评估
+
+> 更新：2026-07-31  
+> 目标：OpsXShell 做成“麻雀虽小、五脏俱全”的轻量 SSH/SFTP 工具。常用操作直接、结果明确、失败可恢复，不用花哨概念增加学习成本。
+
+## 评估结论
+
+当前开发分支已具备 SSH、SFTP、串口、分屏、批量命令、SOCKS5、跳板和 AI Agent 的完整产品骨架，已经不是功能演示，但距离可长期替代 Tabby、Netcatty、Xshell 或 WindTerm 仍有一段可靠性和跨平台发布差距。
+
+综合评分为 **7.1/10**。评分针对当前代码和自动化基线，不等于正式安装包质量；Windows 实机、macOS 安装版、断网/休眠和真实大文件传输未统一验收前，不能按成熟商业终端评价。
+
+| 维度               | 分数 | 判断                                                                               |
+| ------------------ | ---: | ---------------------------------------------------------------------------------- |
+| 产品聚焦           |  8.5 | SSH/SFTP/代理/串口边界清楚，没有堡垒机、审计和 CMDB 噪音                           |
+| 首次连接与会话管理 |  7.8 | 快速连接和保存会话路径短，支持密码、私钥、代理和跳板                               |
+| 终端基础体验       |  7.2 | 复制粘贴、右键、分屏、广播和 Shell 生命周期已补齐；搜索和高压稳定性仍不足          |
+| SFTP               |  6.8 | 双栏、双向拖拽、上传下载、权限和远程编辑已具备；冲突、重试和任务恢复不足           |
+| 隧道与 SOCKS5      |  7.5 | 规则与运行实例分离、真实启停和状态统计方向正确；重连和复用还需压测                 |
+| 批量运维           |  7.0 | 多主机选择、并发、逐机结果清楚；取消和独立超时未完成                               |
+| AI Agent           |  6.8 | 单入口、当前 SSH 执行、风险模式和 ReAct 基线可用；执行内核仍在 React，真正取消不足 |
+| 性能与可靠性       |  6.2 | Tauri/Rust 基础占优，但断网、休眠、大输出和频繁切换仍缺持续压测                    |
+| 跨平台发布         |  5.8 | macOS/Windows 构建脚本已具备；Windows 实机、签名、公证、更新和崩溃诊断未闭环       |
+| 文档与自动化       |  7.8 | 有契约、组件、Rust 和真实探针分层；仍需把实机矩阵纳入每次候选发布                  |
+
+## 产品主旨
+
+OpsXShell 的默认界面只围绕七件事：连接主机、管理会话、操作终端、传输文件、开隧道、批量执行、必要时让 AI 在当前主机协助处理。
+
+必须坚持：
+
+1. 高频动作一步可达，高级选项默认收起。
+2. 当前操作目标始终可见，尤其是广播、批量命令、SFTP 和 AI 执行。
+3. 成功、进行中、失败、断开是四种不同状态，不能只靠颜色或开发日志表达。
+4. 空闲操作不滥用确认框；删除、覆盖、关闭运行任务和高风险 AI 命令才确认。
+5. 不保存终端命令、广播输入、批量命令、AI 对话或工具输出。
+6. 不加入审计、录像、审批、CMDB、独立 podexec 或 Kubernetes 凭据。
+
+## 大众操作习惯基线
+
+### 鼠标与窗口
+
+- 单击负责选择和聚焦，双击负责打开会话/目录或切换窗口最大化，不能让一次双击触发两次相反操作。
+- 右键必须显示与当前位置相关的菜单；普通区域不得出现 WebView 的 Reload/Inspect Element。
+- macOS 使用原生红黄绿窗口控制，Windows 使用系统最小化/最大化/关闭；标题栏空白区可拖动。
+- 拖拽必须显示源、目标和允许/禁止状态；文件落到目录行时传入该目录，落到空白区时传入当前目录。
+
+### 键盘
+
+| 动作                 | macOS          | Windows/Linux                                     |
+| -------------------- | -------------- | ------------------------------------------------- |
+| 复制/粘贴终端        | `Cmd+C/V`      | `Ctrl+Shift+C/V`                                  |
+| 普通输入框复制/粘贴  | `Cmd+C/V`      | `Ctrl+C/V`                                        |
+| 新建会话             | `Cmd+N`        | `Ctrl+N`                                          |
+| 快速连接             | `Cmd+K`        | `Ctrl+K`                                          |
+| 关闭标签             | `Cmd+W`        | `Ctrl+W`                                          |
+| 分屏                 | `Cmd+D`        | `Ctrl+D`，但必须避免与远端 EOF 语义冲突并允许改键 |
+| 终端搜索             | `Cmd+F`        | `Ctrl+F`                                          |
+| 开发工具（开发构建） | `Cmd+Option+I` | `F12`                                             |
+
+- 快捷键不能抢占输入框的复制、粘贴、全选、撤销和输入法组合状态。
+- 菜单和提示必须显示当前平台实际快捷键，不能同时展示两套组合键让用户猜。
+- `Escape` 关闭当前最上层弹框/菜单；`Enter` 触发主动作，文本域需要明确换行组合键。
+
+### 表单
+
+- SSH 目标允许直接粘贴 `user@host:port`，端口默认 22。
+- 保存会话只展示“密码/密钥”两个常用认证入口；代理、跳板、标签和启动命令放在高级区。
+- 端口、路径和 Endpoint 在失焦或提交时给出就地错误，不能无提示恢复默认值。
+- 取消或重新打开快速连接、批量命令、AI 面板时，敏感输入必须清空。
+- 按钮文案说明结果，如“连接”“创建并保存”“执行到 3 台”，避免只显示含义不明的图标。
+
+### 状态与错误
+
+- 错误必须包含“什么失败、作用于谁、如何恢复”，例如“Host A 命令超时，可重试”，而不是 `unknown`。
+- 剪贴板失败、广播目标变为 0、Shell 已退出、隧道端口占用和 SFTP 冲突必须在界面提示。
+- 重试不能重复创建连接、Shell、SFTP 通道或 Listener；状态必须以 Rust 真实资源为准。
+- 加载超过 300ms 显示进行中，超过设置超时显示具体阶段；不能无限转圈。
+
+## 核心用户旅程
+
+| 旅程        |                  目标操作长度 | 当前状态       | 验收标准                                                |
+| ----------- | ----------------------------: | -------------- | ------------------------------------------------------- |
+| 临时连接    |          快捷键 → 粘贴 → 回车 | 已实现         | `user@host:port` 可粘贴；取消重开后密码为空             |
+| 保存会话    |       新建 → 目标/凭据 → 保存 | 已实现         | 默认 22；常用项不超过一屏；错误就地显示                 |
+| 重复连接    |                  双击侧栏会话 | 已实现         | 单击只选择，双击只打开一个终端标签                      |
+| 终端操作    |                  右键或快捷键 | 已实现         | 复制、粘贴、全选、清屏、分屏、最大化、关闭均明确        |
+| 多终端广播  |                 开广播 → 输入 | 已实现，待增强 | 覆盖所有打开 SSH Shell，显示目标数，本地 Shell 永不参与 |
+| 批量命令    |          选主机 → 命令 → 执行 | 已实现，待增强 | 最多并发 5，逐机结果和耗时；关闭后命令销毁              |
+| SFTP        |          会话右键 → SFTP 文件 | 已实现，待实机 | 本地↔远程拖拽、按钮和右键都走明确 upload/download 方向  |
+| SOCKS5      |            会话 → 转发 → 启动 | 已实现，待压测 | 默认 `127.0.0.1:1080`；停止后真实端口不可连接           |
+| 串口        | 快速启动 → 串口 → 参数 → 连接 | 已实现，待实机 | 可枚举设备，默认常用参数，断开和重连状态明确            |
+| AI 处理任务 |   当前 SSH → AI → 描述 → 执行 | 实验可用       | 目标固定、安全模式明确、critical 硬拒、关闭后上下文销毁 |
+
+## 当前已完成的基础修正
+
+- 全局广播覆盖所有打开且已连接的 SSH 标签与分屏，排除本地 Shell；目标不足两个时自动关闭。
+- 终端右键菜单包含复制、粘贴、全选、清屏、向右/向下分屏、最大化/恢复和关闭。
+- 关闭分屏会调用 Rust `ssh_close_shell`，远端关闭失败会记录明确错误，不只移除前端格子。
+- 远端 Shell 的 EOF、`TMOUT` 和 `Ctrl+D` 不再等同整个 SSH 连接断开，可只重开当前 Shell。
+- 批量命令支持搜索、全选当前结果、调整目标、最大并发 5、逐机状态/输出/耗时和总进度。
+- 快速连接和批量命令重新打开会清空敏感输入，结果不落盘。
+- Agent 支持严格、均衡、宽松三级安全模式；默认均衡只确认 high，critical 永久硬拒绝。
+- 普通 WebView 区域禁止 Reload/Inspect Element，文本输入保留系统编辑菜单。
+- 应用版本由 `package.json` 构建时注入，不再在状态栏硬编码旧版本。
+
+## P0：下一候选版本必须完成
+
+| ID    | 优化项                | 当前缺口                                           | 完成标准                                                         |
+| ----- | --------------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
+| P0-01 | 连接生命周期压测      | 断网、睡眠唤醒、快速切标签和连接复用证据不足       | 自动覆盖连接/重连/挂起/恢复；100 次切换无重复连接和监听器泄漏    |
+| P0-02 | 终端搜索接通          | `SearchAddon` 已加载，但分屏工作区没有可用搜索 UI  | `Cmd/Ctrl+F` 搜索当前焦点分屏，支持上一项/下一项/关闭            |
+| P0-03 | 终端高输出稳定性      | 仍出现过 CPU 高占用和操作卡顿                      | 持续输出 10 分钟 UI 可操作；后台标签限流；CPU/内存有基准阈值     |
+| P0-04 | 用户可见 I/O 错误     | 部分剪贴板、关闭 Shell 和事件错误只写日志          | toast/覆盖层说明失败对象和恢复动作；不得产生未处理 Promise       |
+| P0-05 | SFTP 基础传输实机门禁 | 自动测试有方向契约和探针，但真实安装版仍需重复验证 | 上传、下载、覆盖、目录落点、拖拽、取消后临时文件处理全部通过     |
+| P0-06 | SFTP 冲突规则         | 同名文件处理不够显式                               | 每次任务可选择覆盖/跳过/重命名；目录递归不静默覆盖               |
+| P0-07 | 批量任务超时与取消    | 当前只能等待 worker 完成                           | 区分连接/命令超时；停止后不再启动新主机，当前命令标为等待完成    |
+| P0-08 | 隧道重连与清理        | Listener 真实启停已做，网络恢复策略不足            | 主连接断开立即清理；重连后按用户选择恢复；端口冲突显示占用地址   |
+| P0-09 | 最小窗口适配          | 960×720 基础可用，AI 打开后终端区域偏窄            | 960×640 无遮挡；打开 AI 时可自动收起侧栏或提供一键扩展           |
+| P0-10 | 双平台安装验收        | macOS 结果不能代表 Windows                         | macOS arm64 与 Windows x86_64 分别完成安装、升级、卸载和核心冒烟 |
+
+## P1：提升日常效率
+
+| ID    | 优化项          | 建议                                                                          |
+| ----- | --------------- | ----------------------------------------------------------------------------- |
+| P1-01 | 广播目标预览    | 点击目标数查看主机/分屏，允许本次临时排除；默认仍是全部打开 SSH               |
+| P1-02 | 批量失败重试    | 一键仅重试失败主机，可从分组/标签建立目标集合                                 |
+| P1-03 | 终端标题与路径  | 安全解析 OSC 标题/当前目录，允许锁定会话名，防止远端伪装安全提示              |
+| P1-04 | 关闭保护        | 仅当前台有运行任务时提示关闭会结束远端 Shell；空闲时一步关闭                  |
+| P1-05 | SFTP 任务中心   | 统一暂停/继续/取消/重试，显示速度、剩余时间和失败原因；重启后可恢复未完成任务 |
+| P1-06 | SFTP 易用性     | 多选拖拽、复制路径、在终端打开目录、远程编辑冲突提示、校验和验证              |
+| P1-07 | SSH Config 导入 | 展示将导入字段、冲突处理和不可支持项；支持 ProxyJump 链预览                   |
+| P1-08 | 隧道便捷入口    | 状态栏一键查看/复制 SOCKS5 地址；复制规则永不复制运行态                       |
+| P1-09 | Agent Runtime   | 从 React 抽离状态机，增加单步超时、真正取消、结构化 tool calling 和 eval      |
+| P1-10 | 无障碍          | 所有图标按钮有名称；焦点圈清楚；弹框焦点锁定/返回；状态不只靠颜色             |
+
+## P2：专业兼容与发布闭环
+
+- Agent Forwarding、OpenSSH 证书、FIDO2 和更完整的算法策略。
+- 保存常用分屏布局，但不保存 Shell ID、命令或终端输出。
+- 隧道使用明确的共享连接/Multiplexer 策略，避免每个请求重新握手。
+- macOS Developer ID 签名与公证、Windows Authenticode、自动更新清单和回滚。
+- 用户主动导出的脱敏诊断包：版本、平台、错误码、资源统计，不包含命令、密码和终端输出。
+- 可选主题和键位导入；不为了生态而引入重量级插件框架。
+
+## 明确不做
+
+- 不恢复命令历史，不持久化广播、批量命令或 Agent 输入输出。
+- 不增加堡垒机审计、审批流、录像、CMDB、告警大盘或独立 podexec。
+- 不使用“有选区右键复制、无选区右键直接粘贴”这类隐藏行为。
+- 不让本地 Shell 加入远程广播，不允许 `ssh://` 携带密码或静默连接。
+- 不为“专业感”堆无用途状态卡、动画、统计图和多级配置。
+
+## 统一回归场景
+
+1. 快速连接粘贴 `root@opsbase.cn:55555`，取消后重开，目标和密码为空；通过 `ssh://` 唤起时只预填安全目标。
+2. 新建会话默认端口 22，密码/密钥切换不会把另一种凭据落盘；编辑高级配置不影响基础字段。
+3. 打开两个 SSH 标签，其中一个分两屏；广播输入 `date`，三个远端各收到一次，本地 Shell 不收到。
+4. 关闭一个分屏，Rust Shell 释放，广播目标立即减少，兄弟分屏、SFTP 和隧道保持可用。
+5. 终端右键复制、粘贴、全选、清屏、向右/向下分屏、最大化/恢复和关闭均可用，无 Reload/Inspect Element。
+6. `Cmd/Ctrl+F` 只搜索当前焦点分屏；切换分屏后结果随焦点切换。
+7. 批量选择两台执行 `date`，逐机显示耗时和结果；停止后不启动剩余主机；关闭重开命令为空。
+8. SFTP 按钮上传、右键上传、本地拖到远程、远程拖到本地结果一致；文件逐字节校验成功。
+9. 同名文件明确选择覆盖/跳过/重命名；失败不留下被误认为完整文件的目标。
+10. 启动 `127.0.0.1:1080` SOCKS5，代理请求成功且统计变化；停止后端口不可连接，重启应用显示未运行。
+11. 远端 `TMOUT` 只关闭当前 Shell，一键重开可用，SSH connection 和其他资源不被误断。
+12. Agent 均衡模式自动执行 `df -h`，`systemctl restart nginx` 先确认；严格模式修改文件先确认；宽松仍拒绝 `rm -rf /`。
+13. 断网后状态由“已连接”进入“重连中/失败”，恢复后不重复创建标签、连接、Shell 或 Listener。
+14. macOS 窗口可拖动，双击标题栏只切换一次最大化；Windows 系统按钮、快捷键和安装卸载符合平台习惯。
+15. 960×640、125%/150% Windows 缩放以及长主机名、中文分组下，无按钮遮挡、水平溢出或不可达操作。
+
+## 发版判定
+
+自动化全绿只代表代码门禁通过。候选发布还必须分别在 macOS arm64 和 Windows x86_64 完成上述核心旅程，并记录版本、安装包哈希、测试平台、失败项和回归结果。任何“只能偶现”“重试一般能好”的连接、终端输入、SFTP 或隧道问题都按未通过处理。