PathEditor/CLAUDE.md

CLAUDE.md

项目概述

PathEditor v4.0 — Windows 系统环境变量 (PATH) 编辑器，使用 Tauri 2.x + React 19 + TypeScript + Rust 构建。

构建命令

# 安装前端依赖
npm install

# 开发模式（热更新）
npx tauri dev

# 仅前端
npm run dev

# 前端测试
npm test
npm run test:watch

# 构建生产版本
npm run build

# Rust 后端检查
cd src-tauri && cargo check

# Rust 后端测试
cd src-tauri && cargo test

# 完整构建（安装包）
npx tauri build

架构

前后端分离，通过 Tauri IPC 通信：

src/                      # React 前端 (TypeScript)
├── core/                 # 纯逻辑 — 零 React 依赖
│   ├── string-list.ts    # StringList 数据结构
│   ├── undo-redo.ts      # 撤销/重做管理器（8 种操作类型）
│   ├── path-manager.ts   # 路径增删移清理
│   ├── import-export.ts  # JSON/CSV/TXT 导入导出
│   └── validation.ts     # 路径格式验证
├── store/                # Zustand 状态管理
│   ├── app-store.ts      # 主状态（路径、撤销、CRUD、加载/保存）
│   └── theme-store.ts    # 深色/浅色模式
├── components/           # React UI 组件
│   ├── layout/           # AppShell、TitleBar、StatusBar
│   ├── path-list/        # PathTable、MergePreview
│   ├── toolbar/          # ToolBar、ActionButtons、UndoRedoButtons、SearchInput
│   └── dialogs/          # PathEditDialog、HelpDialog、ImportDialog
├── hooks/                # use-keyboard、use-path-validation
├── i18n/                 # i18next 中英文翻译
└── config/               # default.json UI 参数配置

src-tauri/                # Tauri Rust 后端
├── src/
│   ├── commands/
│   │   ├── registry.rs   # 注册表读写（load/save system & user paths）
│   │   ├── system.rs     # check_admin、validate_path、expand_env_vars、broadcast
│   │   └── backup.rs     # backup_registry、get_appdata_dir
│   ├── error.rs
│   └── lib.rs            # 注册所有 IPC commands
├── Cargo.toml
└── tauri.conf.json

tests/unit/               # Vitest 前端单元测试

IPC 接口（Rust → Frontend）

Command	功能
load_system_paths	从 HKLM 注册表读取系统 PATH
load_user_paths	从 HKCU 注册表读取用户 PATH
save_system_paths	保存系统 PATH 到注册表
save_user_paths	保存用户 PATH 到注册表
check_admin	检测管理员权限
validate_path	验证路径目录是否存在
expand_env_vars	展开 %VAR% 环境变量
broadcast_env_change	广播 WM_SETTINGCHANGE
backup_registry	备份注册表 PATH 到文件
get_appdata_dir	获取备份目录路径

关键约束

• Rust 工具链：stable-x86_64-pc-windows-gnu（项目已设 override）
• .cargo/config.toml 添加了 -lmcfgthread 兼容 GCC 15.2.0 MinGW
• 移除 cdylib crate-type 避免 DLL 导出序数溢出
• 运行需要管理员权限才能编辑系统 PATH