PathEditor/docs/superpowers/specs/2026-05-27-v4.3-path-toggle-and-e2e-design.md

v4.3 路径启用/禁用 + E2E 测试 — 设计文档

日期: 2026-05-27 分支: v4.2（v4.3 后续创建） 状态: 已确认

概述

两项独立改进：

1. 路径启用/禁用（软开关）：string[] → PathEntry[]，禁用状态存 JSON 文件
2. E2E 测试：Playwright + Mock IPC，覆盖 4 条关键流程

---

Part 1: 路径启用/禁用

数据模型

// 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 路径
搜索 + 清理	输入搜索词 → 列表过滤 → 清空搜索 → 点清理 → 无效路径红色

运行方式

npx playwright test

需要先启动 Vite 开发服务器：npm run dev