# VimagHook

**Repository Path**: fantasy-s/vimag-hook

## Basic Information

- **Project Name**: VimagHook
- **Description**: 文件浏览器文件Hook
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vimag Hook - 文件资源管理器钩子程序

一个基于Windows API的文件资源管理器钩子程序，可以监听键盘事件并获取当前选中的文件信息。程序运行在系统托盘中，提供便捷的控制界面。

## 功能特性

- 🎯 **键盘钩子监听**: 监听全局空格键按下事件
- 📁 **文件选择检测**: 自动检测文件资源管理器中选中的文件
- 🔧 **系统托盘集成**: 在系统托盘显示自定义图标，支持右键菜单操作
- ⏸️ **灵活控制**: 支持启用/禁用钩子、暂停/恢复功能
- 🔄 **多种获取方式**: 支持COM接口和剪贴板两种文件获取方式
- 🎨 **自定义图标**: 使用自定义托盘图标

## 项目结构
vimag-hook/
├── include/
│   └── file_hook.h          # 主要类定义和常量
├── src/
│   ├── main.cpp             # 程序入口点
│   └── file_hook.cpp        # 核心功能实现
├── resources/
│   ├── icon.ico             # 托盘图标文件
│   ├── resource.h           # 资源ID定义
│   └── resource.rc          # 资源配置文件
├── build/                   # 编译输出目录
├── xmake.lua               # 构建配置文件
└── README.md               # 项目说明文档

## 技术栈

- **语言**: C++17
- **构建系统**: XMake
- **平台**: Windows
- **依赖库**: 
  - Windows API (user32, kernel32, shell32)
  - COM组件 (ole32, oleaut32, uuid)
  - Shell API (comctl32)

## 构建要求

- Windows 操作系统
- XMake 构建工具
- 支持C++17的编译器 (推荐 MSVC)
- 管理员权限 (用于安装全局钩子)


# 清理之前的构建
xmake clean

# 编译项目
xmake build

# 或者编译发布版本
xmake build -m release