diff --git a/src/components/layout/TitleBar.tsx b/src/components/layout/TitleBar.tsx
index 5a3f1dc..b2f2129 100644
--- a/src/components/layout/TitleBar.tsx
+++ b/src/components/layout/TitleBar.tsx
@@ -11,9 +11,7 @@ export function TitleBar() {
className="flex items-center justify-between px-4 py-2 border-b select-none"
style={{ borderColor: 'var(--app-border)' }}
>
-
);
diff --git a/src/components/path-list/MergePreview.tsx b/src/components/path-list/MergePreview.tsx
index d57d32a..6f1ad40 100644
--- a/src/components/path-list/MergePreview.tsx
+++ b/src/components/path-list/MergePreview.tsx
@@ -56,8 +56,7 @@ export function MergePreview() {
diff --git a/src/components/path-list/PathTable.tsx b/src/components/path-list/PathTable.tsx
index cc198df..812e304 100644
--- a/src/components/path-list/PathTable.tsx
+++ b/src/components/path-list/PathTable.tsx
@@ -42,7 +42,8 @@ export function PathTable({ tabId }: PathTableProps) {
const result: PathRow[] = [];
for (let i = 0; i < paths.length; i++) {
const p = paths[i];
- if (p.path.toLowerCase().includes(q)) result.push({ path: p.path, index: i, enabled: p.enabled });
+ if (p.path.toLowerCase().includes(q))
+ result.push({ path: p.path, index: i, enabled: p.enabled });
}
return result;
}, [paths, searchQuery]);
@@ -74,15 +75,15 @@ export function PathTable({ tabId }: PathTableProps) {
});
});
- return () => { cancelled = true; };
+ return () => {
+ cancelled = true;
+ };
}, [paths]);
// 异步展开环境变量（用于 tooltip）
useEffect(() => {
let cancelled = false;
- const toExpand = paths.filter(
- (p) => p.path.includes('%') && !expandedRef.current.has(p.path),
- );
+ const toExpand = paths.filter((p) => p.path.includes('%') && !expandedRef.current.has(p.path));
if (toExpand.length === 0) return;
const batch = toExpand.slice(0, 20);
@@ -105,7 +106,9 @@ export function PathTable({ tabId }: PathTableProps) {
});
});
- return () => { cancelled = true; };
+ return () => {
+ cancelled = true;
+ };
}, [paths]);
// 所有路径默认有效（异步验证结果回来后再精确染色）
@@ -194,7 +197,10 @@ export function PathTable({ tabId }: PathTableProps) {
: 'var(--app-list-alt)',
}}
>
- |
+ |
{index + 1}
|
diff --git a/src/components/toolbar/ToolBar.tsx b/src/components/toolbar/ToolBar.tsx
index f45b412..4964054 100644
--- a/src/components/toolbar/ToolBar.tsx
+++ b/src/components/toolbar/ToolBar.tsx
@@ -36,12 +36,7 @@ export function ToolBar(props: ToolBarProps) {
- |
+ 
---
+## 截图
+
+> 📸 将截图放置在此区域（`docs/screenshots/` 目录），并取消注释对应的图片链接。
+
+
+
+---
+
## 简介
PathEditor 是 Windows PATH 环境变量的可视化管理工具。支持系统变量和用户变量的增删改查、拖拽排序、一键清理无效路径、导入导出以及完整的撤销/重做。
@@ -251,18 +273,18 @@ npx tauri build
### 技术栈
-| 层 | 技术 |
-|---|---|
-| 前端框架 | React 19 + TypeScript (strict) |
-| UI 样式 | Tailwind CSS 4 |
-| 状态管理 | Zustand |
-| 国际化 | i18next |
-| 桌面框架 | Tauri 2.x |
-| 核心库 | Rust workspace (core + gui + cli) |
-| 前端测试 | Vitest (72 个测试) |
-| Rust 测试 | cargo test (10 个测试) |
-| 构建 | Vite + Cargo |
-| 打包 | NSIS |
+| 层 | 技术 |
+| --------- | --------------------------------- |
+| 前端框架 | React 19 + TypeScript (strict) |
+| UI 样式 | Tailwind CSS 4 |
+| 状态管理 | Zustand |
+| 国际化 | i18next |
+| 桌面框架 | Tauri 2.x |
+| 核心库 | Rust workspace (core + gui + cli) |
+| 前端测试 | Vitest (72 个测试) |
+| Rust 测试 | cargo test (10 个测试) |
+| 构建 | Vite + Cargo |
+| 打包 | NSIS |
### 项目结构
@@ -290,15 +312,15 @@ tests/unit/ # 前端单元测试
## 快捷键
-| 快捷键 | 功能 |
-|--------|------|
+| 快捷键 | 功能 |
+| -------- | -------- |
| `Ctrl+N` | 新建路径 |
-| `Ctrl+S` | 保存 |
-| `Ctrl+Z` | 撤销 |
-| `Ctrl+Y` | 重做 |
-| `Ctrl+F` | 搜索 |
+| `Ctrl+S` | 保存 |
+| `Ctrl+Z` | 撤销 |
+| `Ctrl+Y` | 重做 |
+| `Ctrl+F` | 搜索 |
| `Delete` | 删除选中 |
-| `F1` | 帮助 |
+| `F1` | 帮助 |
## 贡献
diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 0000000..29b8af0
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,48 @@
+# 路线图
+
+PathEditor 的未来发展方向。
+
+## v5.1 (下一个版本)
+
+- [ ] **CLI 模块化** — `cli/src/main.rs` 拆分为 `commands/` 子模块
+- [ ] **自动更新** — 内置 Tauri updater，无需手动下载安装包
+- [ ] **深色模式优化** — 对齐 Windows 系统主题自动切换
+- [ ] **性能优化** — 虚拟滚动支持超长 PATH 列表（1000+ 条目）
+
+## v5.2
+
+- [ ] **PATH 历史快照** — 保存每次修改的时间线，支持回退到任意历史节点
+- [ ] **规则引擎** — 自定义 PATH 整理规则（如「所有 Python 路径放最前」）
+- [ ] **收藏夹** — 常用路径快速添加
+- [ ] **冲突解决方案引导** — 可视化的可执行文件冲突对比与解决建议
+
+## v6.0 (长期)
+
+- [ ] **跨平台支持** — 适配 Linux (`/etc/environment` + `~/.profile`) 和 macOS (`path_helper`)
+- [ ] **Web 管理面板** — 远程管理多台 Windows 服务器的 PATH 环境变量
+- [ ] **插件系统** — 第三方扩展生态（如 Anaconda/VSCode/VS 自动检测与配置）
+- [ ] **Windows Package Manager 集成** — 与 winget/chocolatey 联动，检测包管理器安装的路径
+
+## 已交付
+
+### v5.0.0
+
+- ✅ Cargo workspace 三层架构 (core + gui + cli)
+- ✅ CLI 命令行工具 (18 条命令)
+- ✅ 冲突检测 + 工具清单
+- ✅ 配置文件管理
+- ✅ 撤销/重做 (10 种操作)
+- ✅ 中英双语界面
+- ✅ CI/CD 自动化
+
+### v4.x 系列
+
+- ✅ Tauri 2.x 重写
+- ✅ 路径验证 (红色/橙色标记)
+- ✅ 导入/导出 JSON/CSV/TXT
+- ✅ 深色/浅色模式
+- ✅ 全局键盘快捷键
+
+---
+
+欢迎通过 [Issues](https://github.com/LHY0125/PathEditor/issues) 提交功能建议！
diff --git a/SUPPORT.md b/SUPPORT.md
new file mode 100644
index 0000000..0edf910
--- /dev/null
+++ b/SUPPORT.md
@@ -0,0 +1,45 @@
+# 获取帮助
+
+## 📖 文档
+
+- [README](README.md) — 项目简介、功能列表、安装指南
+- [CONTRIBUTING](CONTRIBUTING.md) — 贡献指南
+- [CHANGELOG](CHANGELOG.md) — 版本变更记录
+- [ROADMAP](ROADMAP.md) — 未来规划
+- [SECURITY](SECURITY.md) — 安全政策
+
+## 🐛 报告 Bug
+
+1. 先搜索 [Issues](https://github.com/LHY0125/PathEditor/issues) 确认未被报告
+2. 使用 **Bug Report** 模板创建新 Issue
+3. 提供系统信息（Windows 版本、PathEditor 版本）
+4. 附上复现步骤和截图
+
+## 💡 功能建议
+
+1. 检查 [ROADMAP](ROADMAP.md) 确认不在已有计划中
+2. 使用 **Feature Request** 模板创建新 Issue
+3. 描述使用场景和期望行为
+
+## ❓ 常见问题
+
+### CLI 命令找不到？
+
+```bash
+patheditor --help
+```
+
+确保已通过 `cargo install --path cli` 安装，且 `~/.cargo/bin` 在 PATH 中。
+
+### 提示权限不足？
+
+编辑系统 PATH 需要管理员权限。右键以管理员身份运行，或使用 CLI `patheditor check-admin` 检测。
+
+### 保存后环境变量未生效？
+
+PathEditor 会自动广播 `WM_SETTINGCHANGE`，但部分程序需要手动重启才能识别新 PATH。
+
+## 📧 联系
+
+- GitHub Issues: [LHY0125/PathEditor](https://github.com/LHY0125/PathEditor/issues)
+- 安全问题: 参见 [SECURITY.md](SECURITY.md)
diff --git a/commitlint.config.js b/commitlint.config.js
new file mode 100644
index 0000000..c4c9714
--- /dev/null
+++ b/commitlint.config.js
@@ -0,0 +1,12 @@
+/** @type {import('@commitlint/types').UserConfig} */
+export default {
+ extends: ['@commitlint/config-conventional'],
+ rules: {
+ 'type-enum': [
+ 2,
+ 'always',
+ ['feat', 'fix', 'refactor', 'docs', 'test', 'chore', 'perf', 'ci', 'style', 'revert'],
+ ],
+ 'subject-case': [0],
+ },
+};
diff --git a/docs/REMAINING-ISSUES.md b/docs/REMAINING-ISSUES.md
new file mode 100644
index 0000000..9677019
--- /dev/null
+++ b/docs/REMAINING-ISSUES.md
@@ -0,0 +1,36 @@
+# 未修复问题清单
+
+> 从 v5.1 全面代码审查中筛选，暂不修复，留待后续评估。
+
+---
+
+## 1. CLI main.rs 单体文件 (639 行)
+
+**严重级别**: LOW
+**文件**: `cli/src/main.rs`
+
+**问题**: 所有 18 条 CLI 命令集中在一个文件中。
+
+**建议**: 当前规模尚可维护，等到命令数超过 25 条或文件超过 1000 行时再拆分为 `commands/` 子模块。
+
+---
+
+## 2. GUI 命令层零测试
+
+**严重级别**: LOW
+**文件**: `gui/src/commands/*.rs` (8 个文件)
+
+**问题**: GUI 命令层是纯薄包装，无独立测试。
+
+**建议**: 不值得投入 — 命令正确性由编译器类型系统保证，运行期由 57 个 core 测试 + E2E 覆盖。
+
+---
+
+## 已修复（本批次）
+
+- ~~disabled.rs 测试写入真实文件~~ → `#[cfg(test)]` 条件编译重定向到 `std::env::temp_dir()`
+- ~~profiles.rs 同款问题~~ → 同上
+
+---
+
+_更新于: 2026-05-30 | 审查批次: v5.1 代码审查_
diff --git a/docs/code-and-architecture-review.md b/docs/code-and-architecture-review.md
new file mode 100644
index 0000000..8ae629a
--- /dev/null
+++ b/docs/code-and-architecture-review.md
@@ -0,0 +1,79 @@
+# PathEditor v5.0 代码与架构审查报告
+
+## 1. 项目概览
+
+PathEditor v5.0 是一个功能完善的 Windows 系统环境变量 (PATH) 编辑器，支持 GUI 与 CLI 双模式。
+技术栈选型现代化且合理：
+
+- **后端 / 核心逻辑**：Rust (Cargo Workspace)
+- **GUI 框架**：Tauri 2.x
+- **前端**：React 19 + TypeScript + Zustand
+
+整体项目结构清晰，职责划分明确，严格遵循了前后端分离与核心逻辑无平台依赖的设计原则。
+
+## 2. 架构设计审查
+
+### 2.1 Cargo Workspace 三层架构
+
+项目采用了经典的 Cargo Workspace 模式，分为三层：
+
+- `core`: 纯 Rust 库 crate，包含所有的核心业务逻辑（注册表读写、备份、配置文件管理、路径验证与清理等）。该层**完全不依赖** Tauri 或 CLI 库，极大地提高了代码的复用性和可测试性。
+- `gui`: Tauri 桌面应用。仅作为薄包装层（Thin Wrapper），通过 `#[tauri::command]` 将 `core` 的功能暴露为 IPC 接口供前端调用。
+- `cli`: 命令行工具层。依赖 `core` 和 `clap` 库，直接提供命令行交互能力。
+
+**审查结论**：架构设计非常优秀。核心逻辑解耦彻底，无论是 GUI 还是 CLI 都能复用同一套安全、经过测试的核心代码。
+
+### 2.2 IPC 通信与状态同步
+
+前端与 Rust 后端通过 Tauri IPC 进行通信。
+
+- 所有的错误处理均通过 `Result