mirror of
https://github.com/LHY0125/PathEditor.git
synced 2026-06-30 02:25:55 +08:00
91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
# 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`
|