feat: release OpsXShell 2.1.0 native Tauri edition

docs/testing-acceptance.md

@@ -0,0 +1,114 @@
+# 测试与验收
+
+## 本地门禁
+
+日常开发执行：
+
+```bash
+npm run acceptance:quick
+```
+
+依次检查界面类型、测试 API 契约、全部 Vitest 测试、Rust 格式和 Rust 编译。
+
+提交或发包前执行：
+
+```bash
+npm run acceptance:full
+```
+
+完整门禁额外执行 ESLint、Clippy 零警告、Rust 测试、前端生产构建和发布脚本测试。任何步骤失败都会立即返回非零状态。
+
+## 覆盖重点
+
+- 应用壳在原生 API 可用和不可用时都能稳定渲染
+- 会话新建、密码/私钥认证、代理和跳板配置
+- SSH Config 解析和会话导出真实写盘
+- 批量打开终端、SFTP 和批量命令
+- Tauri 事件监听注册/销毁竞态
+- SSH 连接关闭后的状态回收
+- HTTP CONNECT、SOCKS5 和断点复制
+- 转发规则不持久化运行状态，复制产生新 ID；原生隧道可启动、查询、停止并在 SSH 断开时清理
+- SFTP 本地/远程路径参数方向、原生路径上传、选中文件下载、双栏双向拖拽、目录落点、远程文本读写和错误反馈
+- 终端分屏、剪贴板、快捷键、分片 UTF-8 解码、高输出背压和异步输入错误
+- `ssh://` 安全解析、冷启动队列、IPv6 格式和快速连接预填充
+- AI Provider 的 OpenAI Chat、Responses、Anthropic 响应解析和 HTTP Endpoint 限制
+- models.dev 多种 JSON 形态归一化、目录源部分失败降级和 new-api `/models` 列表
+- API Key 只进入 Rust secrets，不出现在 `ai-providers-v1`、日志或 WebView 返回值中
+- 终端上下文选区优先、当前屏幕显式授权、本地脱敏、单行填入和多行拒绝
+- 新 Provider 测试前不落盘，真实测试成功后才启用保存；任一连接字段变化会使验证快照失效
+- AI 执行任务固定当前 SSH connection，确认前不得调用 `ssh_exec`，真实输出回传分析且不进入历史
+- macOS 原生“编辑”菜单以及所有输入框的复制、剪切、粘贴、全选、撤销；应用快捷键不得覆盖这些系统操作
+- 普通界面右键不出现 WebView 的 Reload/Inspect Element；输入框仍保留系统编辑菜单，自定义右键不受影响
+
+测试替身必须完整实现 `DesktopApiContract`。新增或删除桌面接口后，`typecheck:test` 必须能发现未同步的契约。
+
+## AI 助手验收
+
+自动验收不得使用真实个人 API Key。可以用本机 mock OpenAI Compatible 服务验证以下边界：
+
+1. Provider 没有 Key 时返回明确错误；保存 Key 后普通设置 JSON 中搜索不到明文。
+2. HTTPS 为默认要求，任意公网 HTTP Endpoint 被拒绝；只有显式允许后才能访问可信本机 HTTP 服务。
+3. OpenAI Chat、OpenAI Responses 和 Anthropic 三种响应都能提取文本，错误响应显示 HTTP 状态和供应商消息。
+4. `Authorization: Bearer`、密码字段、AWS Key 和私钥在请求发出前被替换，并显示脱敏计数。
+5. 有选区时即使勾选当前屏幕也只发送选区；无选区且未勾选时只发送用户问题。
+6. 单行命令填入后终端不得出现 `\r` 或 `\n`；多行代码块不显示填入按钮。
+7. 关闭再打开 AI 面板，之前的提示词和回答不存在。
+8. models.dev 三个源全部失败时不影响已保存 Provider；部分成功时仍能生成可导入目录。
+9. 新增 Provider 后测试前“保存”禁用；测试实际发送“你是什么模型？请简短回答。”，期间 settings 与 secrets 均无写入；只有非空成功回答显示 HTTP 200，随后保存才写入加密 Key。
+10. 切换 Endpoint、模型、协议或 API Key 后“保存”立即重新禁用。
+11. “执行任务”只接受唯一单行命令；确认对话框打开前和用户取消后 `ssh_exec` 调用次数必须为 0。
+12. 确认后只向当前 connectionId 执行一次；真实输出交给模型总结，关闭面板后命令与输出消失。
+
+## 真实 SSH/SFTP 探针
+
+真实探针默认标记为 ignored，必须显式提供测试服务器：
+
+```bash
+OPSX_TEST_SSH_HOST=example.com \
+OPSX_TEST_SSH_PORT=22 \
+OPSX_TEST_SSH_USER=root \
+cargo test --manifest-path src-tauri/Cargo.toml \
+  real_ssh_exec_and_sftp_probe -- --ignored --nocapture
+```
+
+该探针会执行 SSH 命令、创建 SFTP 通道，并在远端 `/tmp` 完成一个临时文件的上传、下载、逐字节比对和清理。只有列目录成功不算 SFTP 基础传输验收通过。
+
+ProxyJump 探针额外设置 `OPSX_TEST_SSH_JUMP_HOST`、`OPSX_TEST_SSH_JUMP_PORT`；使用 `OPSX_TEST_SSH_JUMP_COUNT=2` 可验证两级链。
+
+动态 SOCKS5 真实探针使用同一组 SSH 环境变量：
+
+```bash
+OPSX_TEST_SSH_HOST=example.com \
+OPSX_TEST_SSH_PORT=22 \
+OPSX_TEST_SSH_USER=root \
+cargo test --manifest-path src-tauri/Cargo.toml \
+  real_dynamic_forward_probe -- --ignored --nocapture
+```
+
+它会创建随机本地 SOCKS5 监听，通过 SSH `direct-tcpip` 再连回测试主机，读取 `SSH-` 协议头，最后停止监听并确认运行状态已清理。
+
+## 端口转发验收
+
+Rust 单元测试会用随机本地端口验证动态监听器的唯一 ID、运行查询、重复启动拒绝和真实停止。实机验收还必须包含：
+
+1. 在保存会话上一键启动 `127.0.0.1:1080`，用 `curl --proxy socks5h://127.0.0.1:1080 https://example.com` 验证。
+2. 确认连接数和流量会变化，复制出的代理地址正确。
+3. 停止后确认端口无法再连接，不能只检查 UI 颜色。
+4. 重启应用后规则仍在，但状态必须为未运行。
+5. 断开 SSH 主连接后，关联的本地、远程和 SOCKS5 监听器全部清理。
+6. 复制规则后确认新规则 ID 独立且状态为未运行；编辑运行中的规则必须先停止原 Listener。
+
+## ssh:// 验收
+
+macOS 安装版先检查 `Info.plist` 包含 `ssh` URL scheme，然后分别验证冷启动和运行中唤起：
+
+```bash
+plutil -p OpsXShell.app/Contents/Info.plist | grep -A8 CFBundleURLTypes
+open -a OpsXShell 'ssh://root@opsbase.cn:55555'
+```
+
+必须确认只存在一个 OpsXShell 进程、原窗口被聚焦、快速连接目标为 `root@opsbase.cn:55555`。`ssh://root:password@host` 和包含远程路径的链接必须被拒绝。Windows 需要在安装后的注册表和浏览器唤起场景重复验证，macOS 结果不能代替 Windows 验收。
+
+## 发版验收
+
+候选发布必须在目标系统完成：安装、首次启动、窗口操作、SSH、SFTP、代理、跳板、串口枚举、休眠恢复、卸载及重新安装。CI 构建成功不能替代 Windows 或 macOS 实机验收。