docs: 更新 README 反映 v5.0 workspace 架构 + CLI 命令行
CI / 前端检查 (TypeScript + Lint + Test) (push) Has been cancelled
CI / Rust 检查 (Check + Clippy + Test) (push) Has been cancelled

- 项目结构改为 core / gui / cli 三 crate
- 新增 CLI 命令行使用说明
- 更新构建命令和技术栈
- 修正安装包名称

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-28 23:59:14 +08:00
parent 9b5b57a3ac
commit 7aa5dcd832
+43 -22
View File
@@ -109,6 +109,25 @@ sequenceDiagram
Z->>UI: isModified → false, statusMessage → '保存成功' Z->>UI: isModified → false, statusMessage → '保存成功'
``` ```
## CLI 命令行
```bash
# 安装
cargo install --path cli
# 查看 PATH
patheditor list --system --json
# 冲突检测
patheditor conflicts
# 配置切换
patheditor profile save "Python开发"
patheditor profile apply "Python开发"
```
完整 17 条命令:`patheditor --help`
## 功能 ## 功能
### 路径管理 ### 路径管理
@@ -147,7 +166,7 @@ sequenceDiagram
## 安装 ## 安装
从 [Releases](https://github.com/LHY0125/PathEditor/releases) 下载最新版 `PathEditor_4.2.0_x64-setup.exe` 安装。 从 [Releases](https://github.com/LHY0125/PathEditor/releases) 下载最新版 `PathEditor_5.0.0_x64-setup.exe` 安装。
或从源码构建: 或从源码构建:
@@ -164,7 +183,7 @@ npx tauri build
## 开发 ## 开发
```bash ```bash
# 开发模式(热更新) # 开发模式 GUI(热更新)
npx tauri dev npx tauri dev
# 仅前端 # 仅前端
@@ -173,11 +192,14 @@ npm run dev
# 前端测试 # 前端测试
npm test npm test
# Rust 后端检查 # Rust workspace 检查
cd gui && cargo check cargo check
# Rust 后端测试 # CLI 构建
cd gui && cargo test cargo build --release -p patheditor-cli
# 完整构建
npx tauri build
``` ```
### 技术栈 ### 技术栈
@@ -189,34 +211,33 @@ cd gui && cargo test
| 状态管理 | Zustand | | 状态管理 | Zustand |
| 国际化 | i18next | | 国际化 | i18next |
| 桌面框架 | Tauri 2.x | | 桌面框架 | Tauri 2.x |
| 后端 | Rust (winreg + windows-rs FFI) | | 核心库 | Rust workspace (core + gui + cli) |
| 前端测试 | Vitest (72 个测试) | | 前端测试 | Vitest (72 个测试) |
| Rust 测试 | cargo test (10 个测试) | | Rust 测试 | cargo test (10 个测试) |
| 构建 | Vite | | 构建 | Vite + Cargo |
| 打包 | NSIS | | 打包 | NSIS |
### 项目结构 ### 项目结构
``` ```
core/ # Rust 核心库(零 Tauri 依赖)
├── registry.rs # 注册表读写 + 路径清理
├── system.rs # 权限检测、路径验证、环境变量展开
├── scanner.rs # 冲突检测、工具清单
├── profiles.rs # 配置文件管理
├── backup.rs / disabled.rs # 备份、禁用状态
└── fs.rs # 文件读写、导入导出解析
gui/ # Tauri 桌面应用
└── src/commands/ # 薄包装 → 调用 core
cli/ # 命令行工具
└── src/main.rs # 17 条命令
src/ # React 前端 src/ # React 前端
├── core/ # 纯逻辑 — 零框架依赖、零平台依赖 ├── core/ # 纯逻辑 — 零框架依赖
├── store/ # Zustand 状态管理 ├── store/ # Zustand 状态管理
├── components/ ├── components/ # UI 组件
│ ├── layout/ # AppShell、TitleBar、StatusBar、ErrorBoundary
│ ├── path-list/ # PathTable、MergePreview
│ ├── toolbar/ # ToolBar、ActionButtons、UndoRedoButtons、SearchInput
│ ├── dialogs/ # PathEditDialog、HelpDialog、ImportDialog
│ └── ui/ # Modal、buttons(共享组件)
├── hooks/ # useAppActions、useKeyboard ├── hooks/ # useAppActions、useKeyboard
├── i18n/ # zh-CN / en ├── i18n/ # zh-CN / en
└── config/ # default.json └── config/ # default.json
gui/ # Rust 后端
└── src/commands/
├── registry.rs # 注册表读写
├── system.rs # 权限检测、路径验证、环境变量展开
└── backup.rs # 注册表备份
tests/unit/ # 前端单元测试 tests/unit/ # 前端单元测试
``` ```