# env-manager-exe

**Repository Path**: dongdong-git/env-manager-exe

## Basic Information

- **Project Name**: env-manager-exe
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EnvManager

> Windows 11 环境变量桌面管理工具 — 开发者与 IT 运维利器

[![Electron](https://img.shields.io/badge/Electron-34-47848F?logo=electron)](https://electronjs.org/)
[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-3178C6?logo=typescript)](https://www.typescriptlang.org/)
[![Vite](https://img.shields.io/badge/Vite-6-646CFF?logo=vite)](https://vitejs.dev/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)

## 功能特性

- 🔍 **变量管理** — 用户/系统环境变量的完整 CRUD，模糊搜索 + PATH 穿透搜索
- 📋 **PATH 编辑器** — 逐行编辑 PATH 条目，拖拽排序，自动检测重复与无效路径
- ⏱️ **操作历史** — SQLite 持久化所有操作，时间线回溯 + 一键回滚
- 🏥 **环境体检** — 一键扫描：重复变量、无效 PATH、空值变量、NODE_OPTIONS 冲突等
- 🔄 **快照对比** — 任意两个时间点的变量差异可视化
- 💾 **备份恢复** — 操作前自动备份，支持导出 `.reg` 注册表文件
- 👤 **配置方案** — 多套 Profile 一键切换（开发 / 测试 / 生产）
- 🌓 **暗色模式** — 跟随系统主题自动切换
- 📌 **系统托盘** — 托盘最小化 + 开机自启
- 🤖 **AI 助手** — 内置 LLM 对话面板，Ollama（本地）/ DeepSeek（云端），可一键执行修复

## 技术栈

| 层级 | 技术 |
|------|------|
| 桌面框架 | Electron 34 |
| 前端框架 | React 19 + TypeScript 5.6 |
| 构建工具 | electron-vite 5 + Vite 6 |
| 状态管理 | Zustand 5 |
| 表格组件 | TanStack Table 8 |
| 图标库 | Lucide React |
| 数据库 | better-sqlite3 |
| 安装打包 | electron-builder (NSIS) |

## 快速开始

### 环境要求

- Windows 11
- Node.js >= 22，npm >= 10
- Windows C++ 编译工具（用于 `better-sqlite3` 原生模块）

### 安装与运行

```bash
# 克隆仓库
git clone https://gitee.com/dongdong-git/env-manager-exe.git
cd env-manager-exe/env-manager-app

# 安装依赖（首次会自动编译原生模块）
npm install

# 开发模式启动
npm run dev

# 构建
npm run build

# 打包为 Windows 安装程序
npm run package

# 一键构建 + 打包
npm run build && npm run package
```

打包输出在 `release/` 目录：
- `EnvManager Setup 0.1.0.exe` — NSIS 安装程序
- `win-unpacked/EnvManager.exe` — 便携版

## 项目结构

```
env-manager-exe/
├── docs/                                  # 需求/设计文档
│   ├── REQUIREMENTS.md                    # 需求分析文档
│   ├── REQUIREMENTS_PHASE2.md             # Phase 2 增强需求
│   ├── ANTD_INTEGRATION_PLAN.md           # Ant Design 集成计划
│   └── backups/                           # 环境备份
├── IMPLEMENTATION_PLAN.md                 # 实施计划
└── env-manager-app/                       # 项目源码
    ├── src/
    │   ├── main/                          # Electron 主进程
    │   │   ├── index.ts                   # 窗口创建 / 系统托盘 / 开机自启
    │   │   └── services/
    │   │       ├── env-service.ts         # 环境变量 CRUD + 注册表操作 + IPC handlers
    │   │       ├── db-service.ts          # SQLite 数据库（operations/snapshots/health/profiles/ai_config）
    │   │       └── ai-service.ts          # AI 对话服务（Ollama + DeepSeek，支持流式输出）
    │   ├── preload/                       # IPC 桥接层
    │   │   ├── index.ts                   # contextBridge 暴露 window.envApi
    │   │   └── index.d.ts                 # TypeScript 类型声明
    │   └── renderer/                      # React 前端
    │       ├── index.html                 # 入口 HTML
    │       └── src/
    │           ├── main.tsx               # React 入口
    │           ├── App.tsx                # 顶层应用：搜索 / Tab / 对话框调度
    │           ├── assets/
    │           │   └── main.css           # 全局样式（支持暗色模式）
    │           ├── store/
    │           │   └── envStore.ts        # Zustand 状态管理
    │           ├── types/
    │           │   └── env.ts             # TypeScript 类型定义
    │           └── components/
    │               ├── VarTable.tsx        # 变量表格（排序 / 多选 / 右键菜单 / 斑马纹）
    │               ├── VarRow.tsx          # 变量行（可展开，显示详情）
    │               ├── SearchBar.tsx       # 搜索栏（Ctrl+F 快捷键，支持 PATH 穿透搜索）
    │               ├── Toolbar.tsx         # 工具栏（历史 / 体检 / 导出 / Profile / 对比 / AI / 设置）
    │               ├── StatusBar.tsx       # 状态栏（变量计数 / 快捷键提示）
    │               ├── AddDialog.tsx       # 新增变量对话框
    │               ├── EditDialog.tsx      # 编辑变量对话框
    │               ├── DeleteDialog.tsx    # 删除确认对话框（含风险评估）
    │               ├── DiffPreview.tsx     # 修改差异预览
    │               ├── PathEditor.tsx      # PATH 编辑器（逐行编辑 / 拖拽排序 / 重复检测）
    │               ├── HistoryPanel.tsx    # 操作历史面板（筛选 / 回滚）
    │               ├── HealthCheck.tsx     # 环境体检（一键修复）
    │               ├── SnapshotCompare.tsx # 快照对比
    │               ├── ProfileManager.tsx  # 配置方案管理（多套 Profile 切换）
    │               ├── ExportDialog.tsx    # 导出 .reg 对话框
    │               ├── ChatPanel.tsx       # AI 聊天面板（流式输出 / Markdown 渲染 / 拖拽调宽）
    │               ├── SettingsDialog.tsx  # 设置对话框（AI 配置 / 系统提示词）
    │               ├── ContextMenu.tsx     # 右键菜单
    │               └── Toast.tsx           # 通知组件
    ├── resources/
    │   └── icon.png                       # 应用图标
    ├── out/                               # Vite 构建输出（gitignore）
    ├── release/                           # electron-builder 打包输出（gitignore）
    │   ├── EnvManager Setup 0.1.0.exe     # NSIS 安装程序
    │   └── win-unpacked/                  # 便携版
    ├── electron.vite.config.ts            # electron-vite 构建配置
    ├── package.json                       # 项目配置与依赖
    ├── tsconfig.json                      # TypeScript 配置
    └── README.md                          # 子项目文档
```

## 数据存储

- **路径**: `%APPDATA%/env-manager/env-manager.db`
- **表**: `operations`（操作日志）、`snapshots`（快照）、`health_checks`（体检）、`profiles`（配置方案）、`ai_config`（AI 配置）

## 安全设计

- 所有写操作前自动创建备份
- 变更前 Diff 预览 → 用户确认后应用
- 删除时风险评估（被引用检测、PATH 依赖、操作历史）
- 完整操作日志，支持一键回滚

## License

MIT