TanXinandTanXin
3ed3300613
## 本次版本更新内容 ### feat: SFTP 双击智能打开，不可编辑文件自动转下载（7d74d0f） - 双击文件优先尝试在线编辑：文本文件直接打开编辑器，明确不可编辑（超大/二进制/无法解码）时自动回退下载，目录双击仍为导航 - 回退下载统一走既有串行下载队列，避免与在途下载并发占用二进制流 - `sftp_error` 增加结构化 `code`（`binary`/`too_large`），消息边界白名单校验后进入回退判定；超时/权限等错误保持提示不静默下载 - 编辑读取增加互斥保护，防止并发请求覆盖 waiter/二进制分块归属 - 新增双击智能打开单元测试（`tests/sftp-panel.test.ts`）与 4 条 e2e 回归（`tests/e2e/sftp-dblclick.spec.ts`） - 同步 AGENTS.md #32 双击智能打开行为契约 ### release: 版本号与 CHANGELOG（1c9afb3） - `package.json` / `frontend/package.json` → 1.14.3 - CHANGELOG 追加 v1.14.3 条目（Keep a Changelog 规范） ## 提交列表 - `7d74d0f` feat: SFTP 双击智能打开，不可编辑文件自动转下载 - `1c9afb3` release: 发布 v1.14.3 SFTP 双击智能打开版本 ## 验证结果 - ✅ `pnpm run typecheck`（worker + frontend + tests，含 e2e） - ✅ `pnpm test`：59 个测试文件 / 704 用例全部通过 - ✅ Playwright：新增 `sftp-dblclick` 4/4 通过；SFTP 关联回归（editor/panel-actions/overwrite）13/13 通过 - ✅ `pnpm run build:frontend` 可复现构建成功（html.ts 已随功能提交再生成） ## 关联 Issue 无（本次需求来自直接反馈，无需关闭 Issue）。 --------- Co-authored-by: TanXin <tanxin@example.com>
CloudSSH 测试套件
本目录包含 CloudSSH 的单元测试、协议集成测试、构建回归和浏览器 E2E。测试框架以 Vitest 和 Playwright 为主。
目录结构
tests/
├── build/ # 生产构建、可复现性和原生弹窗回归
├── e2e/ # Chromium 浏览器交互与 axe 无障碍检查
├── ssh/ # SSH 算法、认证、加密、KEX、Packet 与测试密钥夹具
├── worker/ # Worker 路由、安全、DNS、UserDB 与标签测试
├── agent-code-actions.test.ts # Agent 代码块复制/填入规则
├── agent-terminal-selection.test.ts # 终端选区附件和非授权安全边界
├── api-errors.test.ts # API 错误信息边界与状态码
├── auth-challenge-dialog.test.ts # RFC 4256 认证挑战对话框交互
├── clipboard.test.ts # Clipboard API 与旧版复制回退
├── frontend-ux.test.ts # 前端关键交互源码回归（标签栏/状态栏渲染等）
├── host-display.test.ts # IPv4/IPv6 掩码与完整地址复制
├── i18n.test.ts # 中英文词条和语言解析
├── known-hosts.test.ts # 已知主机指纹 TOFU 信任与变更流程
├── mobile-input.test.ts # iOS IME diff 与一次性修饰键帮助函数
├── share-session.test.ts # 分享会话确认/领取幂等与页面状态
├── sftp-selection.test.ts # SFTP 单选、多选、连选和全选模型
├── snippet-local-store.test.ts # 匿名命令片段 localStorage 存储与限额
├── snippet-schema.test.ts # 片段名称/命令/数量校验与规范化
├── terminal-status.test.ts # SSH 状态事件翻译
├── terminal-text.test.ts # 终端文本处理
├── theme.test.ts # 内置/自定义主题
├── types.test.ts # 共享类型和终端尺寸边界
└── README.md
tests/ssh/fixtures/ 中的私钥只用于公开的协议测试，不得用于生产服务器或真实账号。
运行命令
# 运行全部 Vitest 单元与集成测试
pnpm test
# 运行指定测试文件
pnpm test tests/ssh/auth.test.ts
# 生成覆盖率报告（输出到 coverage/）
pnpm run test:coverage
# 监听模式
pnpm test --watch
# 安装并运行 Chromium E2E 与 axe 无障碍检查
pnpm exec playwright install chromium
pnpm run test:e2e
# 类型检查、测试、可复现构建和 E2E 完整门禁
pnpm run verify
测试类型检查：
pnpm run typecheck的 worker 阶段会依次执行tsc --noEmit（src）、tsc -p tests/tsconfig.worker.json（tests/worker|ssh|build， workers-types 环境）与tsc -p tests/tsconfig.frontend.json（tests 根目录 *.test.ts + e2e， DOM 环境）。两个测试配置分开的原因：@cloudflare/workers-types声明的基础 DOM 接口 （如 Element.append）与 DOM lib 合并冲突，不能在同一项目里同时加载。
当前覆盖范围
SSH 协议
- 算法协商列表与兼容性
- 密码认证
- Ed25519、ECDSA P-256/P-384/P-521、RSA-SHA2 私钥认证
- OpenSSH 私钥解析、DER/SSH 签名转换
- AES-GCM/CTR、HMAC、Packet、KEX 辅助和二进制工具
Worker 与安全边界
- Turnstile 验证 token 的结构、过期时间和 HMAC
- Origin 检查、端口范围、连接令牌和错误信息边界
- IPv4/IPv6 保留地址、DoH 解析与 DNS rebinding 防护
- Agent 危险命令拦截、确认规则和 SSRF URL 校验
- 主机密钥信任：首见指纹确认、更换指纹阻断与路由作用域隔离
- 键盘交互认证、OS 检测、跳板链、SFTP 上传冲突、分享会话策略
- UserDB 服务器标签/片段迁移、规范化、序列化、更新与隔离
前端与构建
- 服务器搜索、标签筛选和响应式分页（桌面 9 / 平板 6 / 移动 3）
- SFTP 单选、Cmd/Ctrl 多选、Shift 连选和全选
- Agent 终端选区附件、问题组合和非授权安全边界
- 终端选区自动复制、指针取消和旧版复制回退
- i18n、Theme V3 主题（背景/效果/版式钳制、对比度与 schema）、终端状态/文本、已知主机与片段本地存储
- 构建可复现性、xterm 生产构建兼容和原生弹窗禁用
浏览器 E2E
- 匿名连接表单 axe 检查
- 服务器弹窗的基本对话框语义、初始焦点和 Escape 关闭
- 服务器标签筛选与分页
- Agent 终端选区附件
- 终端选区复制与焦点恢复
- 认证挑战对话框、iOS 输入法、移动端后台连接恢复与分享会话领取
- SFTP 覆盖确认、主题样式与 UI 回归
当前限制
- Playwright 的完整界面与无障碍回归主要运行 Chromium；认证挑战、iOS 输入法和移动端后台连接恢复另在 WebKit 设备项目中执行。Firefox 尚未纳入当前质量门禁。
- 浏览器 E2E 主要通过 mock API 验证前端行为，尚未连接真实 OpenSSH/Dropbear 和 SFTP 服务。
- SSHSessionDO、SSH 会话状态机、SFTP 数据流和 AgentCore 等运行态模块的覆盖率仍偏低。
- 新增协议状态、WebSocket 消息或安全边界时，应优先补充运行时错误、取消、超时和畸形输入测试，而不仅验证成功路径。