mirror of https://github.com/LHY0125/PathEditor.git synced 2026-06-29 01:45:54 +08:00

Files

T

Serendipity 3a21891f84 feat: 原生对话框、ErrorBoundary、配置生效、交互打磨

- handleBrowse 改用 @tauri-apps/plugin-dialog 原生目录选择
- handleImport 清理临时 DOM 元素（add input.remove()）
- config/default.json 实际导入生效（maxHistory、path 长度限制）
- app-store.ts 长度检查改用配置值
- 删除 AppShell 中与 store 重复的长度检查
- 新增 ErrorBoundary 组件避免单异常白屏
- StatusBar 加载失败时显示重试按钮
- 取消按钮检查 isModified 未保存提示
- lib.rs 注册 tauri-plugin-dialog
- tsconfig 添加 resolveJsonModule
- CLAUDE.md 添加 cargo test 运行时说明

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-26 00:33:57 +08:00

3.3 KiB

Raw Blame History

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
cargo test 需要 MinGW bin 在 PATH 中（GCC 15.2.0 运行时依赖 libmcfgthread-2.dll），开发模式下可用 npx tauri dev 替代

3.3 KiB Raw Blame History Unescape Escape