docs: 添加 v4.3 路径启用/禁用 + E2E 测试设计文档

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-29 01:37:22 +08:00 · 2026-05-27 13:19:02 +08:00
parent 8ff02fd88b
commit fcd4796fee
1 changed files with 90 additions and 0 deletions
@@ -0,0 +1,90 @@
+# v4.3 路径启用/禁用 + E2E 测试 — 设计文档
+
+**日期**: 2026-05-27
+**分支**: v4.2（v4.3 后续创建）
+**状态**: 已确认
+
+## 概述
+
+两项独立改进：
+1. 路径启用/禁用（软开关）：`string[]` → `PathEntry[]`，禁用状态存 JSON 文件
+2. E2E 测试：Playwright + Mock IPC，覆盖 4 条关键流程
+
+---
+
+## Part 1: 路径启用/禁用
+
+### 数据模型
+
+```typescript
+// src/core/path-entry.ts (新增)
+export interface PathEntry {
+  path: string;
+  enabled: boolean;
+}
+```
+
+全栈从 `string[]` 迁移到 `PathEntry[]`。注册表读写时做转换。
+
+### 禁用状态持久化
+
+文件：`%APPDATA%/PathEditor/disabled.json`
+格式：`{ "system": ["path1"], "user": ["path2"] }`
+
+加载流程：注册表读取 → `PathEntry[]`（全部 enabled:true）→ 读取 disabled.json → 匹配到的标记 enabled:false
+
+保存流程：只将 enabled:true 的 path join 后写入注册表
+
+切换流程：复选框点击 → 更新内存状态 → 立即调用 `save_disabled_state` 写入 JSON
+
+### 新增 Rust 命令
+
+- `save_disabled_state(system: Vec<String>, user: Vec<String>) -> Result<(), String>`
+- `load_disabled_state() -> Result<Vec<String>, Vec<String>, String>` 返回 `(system_disabled, user_disabled)`
+
+### Undo 适配
+
+- `OpRecord.oldPaths` / `newPaths` 从 `string[]` 改为 `PathEntry[]`
+- 新增 `OperationType.TOGGLE = 8`：单条路径切换启用/禁用，undo 翻转回去
+- 8 种已有操作类型的 switch case 适配 `PathEntry`
+
+### UI
+
+- 路径列表每行前加复选框，`#` 序号列与复选框合并
+- 禁用行：灰色文字 + 删除线（`text-decoration: line-through`）
+- 工具栏不新增按钮（复选框独立操作）
+
+### 状态层
+
+- `app-store.ts` 新增 `togglePath(index, target)` 方法
+- `loadPaths` 加载时合并 disabled 状态
+- `savePaths` 保存时过滤 disabled 路径
+
+---
+
+## Part 2: E2E 测试
+
+### 技术选型
+
+`@playwright/test`，独立于 Vitest。Mock Tauri IPC 通过 `page.addInitScript()` 注入。
+
+### Mock IPC
+
+页面加载前注入 `window.__TAURI_INTERNALS__.invoke` 的 mock 实现，按命令名返回假数据。
+
+### 4 条测试场景
+
+| 场景 | 步骤 |
+|------|------|
+| 启动加载 | 访问页面 → 系统 PATH 显示 2 条 → 用户 PATH 显示 1 条 |
+| CRUD + 撤销 | 添加路径 → 出现在列表 → Ctrl+Z 撤销 → 路径消失 → Ctrl+Y 重做 → 路径恢复 |
+| 禁用 + 保存 | 点击复选框禁用 → 路径灰显+删除线 → 点保存 → 验证 save IPC 只传了 enabled 路径 |
+| 搜索 + 清理 | 输入搜索词 → 列表过滤 → 清空搜索 → 点清理 → 无效路径红色 |
+
+### 运行方式
+
+```bash
+npx playwright test
+```
+
+需要先启动 Vite 开发服务器：`npm run dev`