# OpsXShell 测试计划

> 最后更新：2026-08-16  
> 持续开发默认测试先行：先锁定失败用例或巡检，再改实现。门禁细节见 [docs/testing-acceptance.md](./docs/testing-acceptance.md)。

## 原则

- 改 SSH / SFTP / 转发 / RDP / VNC 后，先跑 `npm run test:patrol`。
- 渲染层只测 `src/platform` 契约与 UI 状态；真实 TCP/SSH 不进默认 Vitest。
- 原生新 command 必须同步 `src/desktop.d.ts`、`src/platform/*.ts`、`test/setup.ts`，否则 `typecheck:test` 应失败。
- 七语种 key 对齐是硬门槛：`test/i18n/localeKeys.test.ts`。
- 没有签名凭据的构建测试不得断言「已公证」。

## 日常命令

```bash
npm run test:patrol          # 基础巡检（优先）
npm run acceptance:quick     # typecheck + 全量 Vitest + Rust fmt/check
npm run acceptance:full      # 发包：再加 lint、clippy -D warnings、Rust test、生产构建
./scripts/build.sh           # 当前平台安装包；内部会跑完整门禁
```

真实探针（需显式主机，默认 ignored）：

```bash
OPSX_TEST_SSH_HOST=… OPSX_TEST_SSH_PORT=… OPSX_TEST_SSH_USER=… \
  cargo test --manifest-path src-tauri/Cargo.toml real_ssh_exec_and_sftp_probe -- --ignored --nocapture
```

## 自动化分层

| 层 | 路径 | 覆盖 |
|----|------|------|
| 巡检 | `test/patrol/` | SSH 开终端、SFTP 双栏/拖拽/冲突、RDP·VNC 对话框、平台契约 |
| 单元 | `test/`、`src-tauri` tests | 转发规则、forwardIntent、resume 回写 tab、错误文案映射、隧道 orphan |
| 门禁 | `scripts/acceptance.mjs` | ESLint、tsc、Vitest、rustfmt、clippy、cargo test |
| 发布 | `scripts/build.sh`、`scripts/release.py --dry-run` | 产物、SHA-256；不自动宣称签名 |

## 下一任务对应的测试（先写再改）

1. **断开原因**  
   keepalive 失败 → 事件/文案不是「用户关闭」。覆盖 `sshDisconnect` reason 与终端/SFTP 回收。

2. **SFTP 自动重连**  
   mock `onConnectionClosed` 后活跃 SFTP tab 有限次重连，并 `loadRemoteDirectory(lastBrowsePath)`。

3. **远程文本冲突**  
   open 记 mtime；save 前 stat 变化 → 确认对话框；取消则不调用 write。

4. **目录冲突文案**  
   同名目录覆盖 vs 跳过；断言文案含「合并/内部同名」，且七语种 key 存在。

5. **远程 bind 展示**  
   请求 `0.0.0.0` 但运行态 bind 为 `127.0.0.1` 时，列表不得显示为全接口已开。

6. **RDP 缩放**  
   回归：K64 协商；DeactivateAll 后 pending 脏区被清空；解压失败不直接 Terminate。

## 发布门槛

1. 本项对应测试或巡检通过。
2. `npm run acceptance:full` 通过后再打安装包。
3. 平台包必须在目标 OS 实机点开验证；macOS 不能替代 Windows。
4. 无 `APPLE_*` / Authenticode 时，文档只写 ad-hoc / 未签名。