+
{t('analyze.scanning')}
) : tab === 'conflicts' ? (
@@ -215,5 +224,7 @@ function EmptyHint({ text }: { text: string }) {
function getEnabledPaths(): string[] {
const { sysPaths, userPaths } = useAppStore.getState();
- return [...sysPaths.filter((e) => e.enabled), ...userPaths.filter((e) => e.enabled)].map((e) => e.path);
+ return [...sysPaths.filter((e) => e.enabled), ...userPaths.filter((e) => e.enabled)].map(
+ (e) => e.path,
+ );
}
diff --git a/src/components/dialogs/HelpDialog.tsx b/src/components/dialogs/HelpDialog.tsx
index 7428d6e..9602216 100644
--- a/src/components/dialogs/HelpDialog.tsx
+++ b/src/components/dialogs/HelpDialog.tsx
@@ -1,7 +1,10 @@
import { useTranslation } from 'react-i18next';
import { Modal } from '@/components/ui/Modal';
-interface HelpDialogProps { open: boolean; onClose: () => void; }
+interface HelpDialogProps {
+ open: boolean;
+ onClose: () => void;
+}
export function HelpDialog({ open, onClose }: HelpDialogProps) {
const { t } = useTranslation();
@@ -9,9 +12,15 @@ export function HelpDialog({ open, onClose }: HelpDialogProps) {
return (
{t('dialog.helpTitle')}
- {t('help.content')}
+
+ {t('help.content')}
+
-
diff --git a/src/components/dialogs/ImportDialog.tsx b/src/components/dialogs/ImportDialog.tsx
index f6a0679..985030c 100644
--- a/src/components/dialogs/ImportDialog.tsx
+++ b/src/components/dialogs/ImportDialog.tsx
@@ -9,7 +9,13 @@ interface ImportDialogProps {
onCancel: () => void;
}
-export function ImportDialog({ open, systemCount, userCount, onSelect, onCancel }: ImportDialogProps) {
+export function ImportDialog({
+ open,
+ systemCount,
+ userCount,
+ onSelect,
+ onCancel,
+}: ImportDialogProps) {
const { t } = useTranslation();
return (
@@ -21,10 +27,40 @@ export function ImportDialog({ open, systemCount, userCount, onSelect, onCancel
{userCount > 0 && t('dialog.importUserCount', { count: userCount })}
- {systemCount > 0 && }
- {userCount > 0 && }
- {systemCount > 0 && userCount > 0 && }
-
+ {systemCount > 0 && (
+
+ )}
+ {userCount > 0 && (
+
+ )}
+ {systemCount > 0 && userCount > 0 && (
+
+ )}
+
);
diff --git a/src/components/dialogs/PathEditDialog.tsx b/src/components/dialogs/PathEditDialog.tsx
index d31e17f..acb33af 100644
--- a/src/components/dialogs/PathEditDialog.tsx
+++ b/src/components/dialogs/PathEditDialog.tsx
@@ -1,4 +1,4 @@
-import { useState, useEffect } from 'react';
+import { useState, useEffect, useRef } from 'react';
import { useTranslation } from 'react-i18next';
import { Modal } from '@/components/ui/Modal';
@@ -10,30 +10,54 @@ interface PathEditDialogProps {
onCancel: () => void;
}
-export function PathEditDialog({ open, title, initialValue, onConfirm, onCancel }: PathEditDialogProps) {
+export function PathEditDialog({
+ open,
+ title,
+ initialValue,
+ onConfirm,
+ onCancel,
+}: PathEditDialogProps) {
const { t } = useTranslation();
const [value, setValue] = useState(initialValue);
+ const prevOpen = useRef(open);
- // 对话框打开时重置输入值 — 此模式不会导致级联渲染
- // eslint-disable-next-line react-hooks/set-state-in-effect
- useEffect(() => { if (open) setValue(initialValue); }, [open, initialValue]);
+ useEffect(() => {
+ if (open && !prevOpen.current) setValue(initialValue);
+ prevOpen.current = open;
+ }, [open, initialValue]);
return (
{title}
setValue(e.target.value)}
- onKeyDown={(e) => { if (e.key === 'Enter') onConfirm(value); }}
+ onKeyDown={(e) => {
+ if (e.key === 'Enter') onConfirm(value);
+ }}
className="w-full min-w-[400px] px-3 py-2 rounded border text-sm outline-none"
- style={{ backgroundColor: 'var(--app-list-bg)', color: 'var(--app-fg)', borderColor: 'var(--app-border)' }}
+ style={{
+ backgroundColor: 'var(--app-list-bg)',
+ color: 'var(--app-fg)',
+ borderColor: 'var(--app-border)',
+ }}
/>
-
diff --git a/src/components/dialogs/ProfileDialog.tsx b/src/components/dialogs/ProfileDialog.tsx
index fc2a028..fc61c57 100644
--- a/src/components/dialogs/ProfileDialog.tsx
+++ b/src/components/dialogs/ProfileDialog.tsx
@@ -65,22 +65,39 @@ export function ProfileDialog({ open, onClose }: Props) {
if (!selected || !selectedData) return;
if (!window.confirm(t('profile.applyConfirm', { name: selected }))) return;
useAppStore.getState().replaceBothPaths(
- selectedData.sys.map(e => e.path),
- selectedData.user.map(e => e.path),
+ selectedData.sys.map((e) => e.path),
+ selectedData.user.map((e) => e.path),
);
// 同步 disabled 状态
await invoke('save_disabled_state', {
- system: selectedData.sys.filter(e => !e.enabled).map(e => e.path),
- user: selectedData.user.filter(e => !e.enabled).map(e => e.path),
+ system: selectedData.sys.filter((e) => !e.enabled).map((e) => e.path),
+ user: selectedData.user.filter((e) => !e.enabled).map((e) => e.path),
});
- await useAppStore.getState().savePaths();
- onClose();
+ const result = await useAppStore.getState().savePaths();
+ if (result.kind === 'success') {
+ onClose();
+ } else if (result.kind === 'warning') {
+ const { ask } = await import('@tauri-apps/plugin-dialog');
+ const confirmed = await ask(t('status.saveWarningLongPaths'), {
+ title: t('dialog.backupTitle'),
+ kind: 'warning',
+ });
+ if (confirmed) {
+ const forceResult = await useAppStore.getState().savePaths(true);
+ if (forceResult.kind === 'success') {
+ onClose();
+ }
+ }
+ }
};
const handleDelete = async (name: string) => {
if (!window.confirm(`删除配置文件 "${name}"？`)) return;
await invoke('delete_profile', { name });
- if (selected === name) { setSelected(null); setSelectedData(null); }
+ if (selected === name) {
+ setSelected(null);
+ setSelectedData(null);
+ }
refreshProfiles();
};
@@ -95,16 +112,23 @@ export function ProfileDialog({ open, onClose }: Props) {
return (
-
+
{t('profile.title')}
setNewName(e.target.value)}
+ onChange={(e) => setNewName(e.target.value)}
placeholder={t('profile.namePlaceholder')}
className="px-2 py-1 text-sm rounded border outline-none w-44"
- style={{ backgroundColor: 'var(--app-list-bg)', color: 'var(--app-fg)', borderColor: 'var(--app-border)' }}
+ style={{
+ backgroundColor: 'var(--app-list-bg)',
+ color: 'var(--app-fg)',
+ borderColor: 'var(--app-border)',
+ }}
/>
+ 
---
+## 截图
+
+### 主界面
+
+
+
+### 路径编辑
+
+
+
+### 冲突检测
+
+
+
+### CLI 命令行
+
+
+
+---
+
## 简介
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 (100 个测试) |
-| Rust 测试 | cargo test (57 个测试) |
-| 构建 | Vite + Cargo |
-| 打包 | NSIS |
+| 层 | 技术 |
+| --------- | --------------------------------- |
+| 前端框架 | React 19 + TypeScript (strict) |
+| UI 样式 | Tailwind CSS 4 |
+| 状态管理 | Zustand |
+| 国际化 | i18next |
+| 桌面框架 | Tauri 2.x |
+| 核心库 | Rust workspace (core + gui + cli) |
+| 前端测试 | Vitest (100 个测试) |
+| Rust 测试 | cargo test (57 个测试) |
+| 构建 | Vite + Cargo |
+| 打包 | NSIS |
### 项目结构
@@ -291,15 +313,15 @@ docs/ # 审查文档
## 快捷键
-| 快捷键 | 功能 |
-|--------|------|
+| 快捷键 | 功能 |
+| -------- | -------- |
| `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/core/Cargo.toml b/core/Cargo.toml
index 8370a58..872688b 100644
--- a/core/Cargo.toml
+++ b/core/Cargo.toml
@@ -13,3 +13,4 @@ log = "0.4"
winreg = "0.52"
dirs = "5"
chrono = "0.4"
+windows-sys = { version = "0.61.2", features = ["Win32_System_Environment", "Win32_UI_WindowsAndMessaging", "Win32_Foundation"] }
diff --git a/core/src/system.rs b/core/src/system.rs
index a5da4af..aef4e12 100644
--- a/core/src/system.rs
+++ b/core/src/system.rs
@@ -1,3 +1,7 @@
+use windows_sys::Win32::System::Environment::ExpandEnvironmentStringsW;
+use windows_sys::Win32::UI::WindowsAndMessaging::{
+ SendMessageTimeoutW, HWND_BROADCAST, SMTO_ABORTIFHUNG, WM_SETTINGCHANGE,
+};
use winreg::enums::*;
use winreg::RegKey;
@@ -26,6 +30,7 @@ pub fn validate_path(path: &str) -> bool {
}
/// 展开路径中的环境变量（如 %JAVA_HOME%\bin → C:\Program Files\Java\jdk-17\bin）
+/// 包含 % 的路径（环境变量路径）无法展开，返回原始路径
pub fn expand_env_vars(path: &str) -> String {
if !path.contains('%') {
return path.to_string();
@@ -46,7 +51,7 @@ pub fn expand_env_vars(path: &str) -> String {
// SAFETY: buffer 容量为 required（API 返回的精确大小），wide_path 以 null 结尾，
// 且两个指针指向不同的内存区域，不存在重叠
- let mut buffer: Vec