mirror of
https://github.com/LHY0125/PathEditor.git
synced 2026-06-29 01:45:54 +08:00
Serendipity
48129a8908
完全移除旧 C+IUP 代码，改用 Tauri 2.x + React 19 + TypeScript + Rust 技术栈重写。 功能与 v3.1 完全等价： - React 前端：Tailwind CSS 4、Zustand 状态管理、i18next 国际化 - Rust 后端：winreg 注册表读写、Win32 API FFI 调用 - 核心逻辑：StringList、UndoRedoManager、PathManager、Import/Export - 深色模式、中英文切换、键盘快捷键、合并预览 - 66 个 Vitest 单元测试 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
95 lines
3.1 KiB
Markdown
95 lines
3.1 KiB
Markdown
# CLAUDE.md
|
||
|
||
## 项目概述
|
||
|
||
PathEditor v4.0 — Windows 系统环境变量 (PATH) 编辑器，使用 Tauri 2.x + React 19 + TypeScript + Rust 构建。
|
||
|
||
## 构建命令
|
||
|
||
```bash
|
||
# 安装前端依赖
|
||
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
|