# win_helper —— Windows 小助手

Windows 小助手是一个综合性的系统工具面板，集成了工具启动、进程管理、系统信息查看、环境变量读写、快捷文件夹等常用功能。

## 功能模块

| 模块 | 功能 |
|------|------|
| **系统工具** | 记事本、计算器、命令提示符、注册表编辑器、画图、任务管理器 |
| **管理工具** | 设备管理器、磁盘管理、服务管理、事件查看器 |
| **磁盘工具** | 磁盘清理、磁盘碎片整理 |
| **快捷文件夹** | 桌面、文档、下载、图片、音乐、视频、AppData 一键直达 |
| **进程管理** | 列出所有进程（PID + 名称）、终止选定进程 |
| **系统信息** | 计算机名、用户名、OS 版本、CPU 核心/型号、物理内存、Windows 目录 |
| **环境变量** | 查看常用环境变量值、新增/修改变量（当前进程） |

## 演示的 API

### 控件 API

- `create_tabbar` / `tabbar_add_text` / `on_tabbar_select` — 标签页容器，切换不同功能面板
- `create_groupbox` — 分组框，组织每类功能的控件
- `create_listview` / `listview_add_column` / `listview_add_text` / `listview_set_text` / `listview_delete_all` / `listview_get_text` / `listview_selected_index` — 详细列表，展示进程和环境变量
- `statusbar_set_text` — 状态栏提示
- `show` / `hide` — 面板显隐切换
- `str_format` — 格式化字符串

### 工具 API

- `run_process` / `wait_process` — 启动系统工具
- `kill_process_pid` — 按 PID 终止进程
- `enum_processes` + `free` — 枚举系统进程
- `get_sys_info` — 系统信息展示
- `get_env` / `set_env` — 环境变量读写
- `get_special_folder` 配合 `explorer.exe` — 打开系统文件夹
- `log_info` — 日志记录

## 源码位置

`d:\XTU\c-train\samples\win_helper\main.c`

## 编译

```bat
cd samples\win_helper
build.bat
```

## 使用说明

窗口顶部为标签页容器，包含 7 个分类，点击切换不同功能面板：

1. **系统工具** — 点击按钮直接启动对应程序（等待退出后状态栏提示）
2. **管理工具** — 启动 MMC 管理控制台
3. **磁盘工具** — 启动磁盘维护工具
4. **快捷文件夹** — 点击打开资源管理器并定位到对应目录
5. **进程管理** — 点击"刷新列表"获取所有进程，选中后点击"终止进程"
6. **系统信息** — 自动读取并显示本机硬件和系统信息
7. **环境变量** — 显示常见环境变量，可在输入框中自定义变量名和值后点击"设置"
