# NovaSearch

**Repository Path**: lisniuse/nova-search

## Basic Information

- **Project Name**: NovaSearch
- **Description**: 一个基于 Wails 框架开发的现代化桌面文件搜索工具，提供快速、直观的文件搜索和管理体验。
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nova Search

一个基于 Wails 框架开发的现代化桌面文件搜索工具，提供快速、直观的文件搜索和管理体验。

## ✨ 功能特性

### 🔍 强大的搜索功能
- **实时搜索**：输入关键词即时显示匹配结果
- **智能匹配**：支持文件名模糊搜索
- **快速定位**：点击搜索结果快速浏览文件位置

### 🌲 直观的文件树
- **层级展示**：清晰的目录结构展示
- **动态加载**：按需加载子目录，提升性能
- **快速导航**：单击展开/折叠，双击打开文件夹

### ⚡ 全局快捷键
- **快速唤起**：支持自定义全局快捷键（默认 Ctrl+Shift+F）
- **后台运行**：最小化到系统托盘，随时可用
- **一键切换**：快捷键显示/隐藏应用窗口

### 🎨 现代化界面
- **深色/浅色主题**：支持主题切换
- **响应式设计**：适配不同屏幕尺寸
- **流畅动画**：优雅的交互体验

### 🔧 灵活配置
- **目标目录**：自定义搜索根目录
- **快捷键设置**：自定义全局快捷键组合
- **行为配置**：自动隐藏、边缘隐藏等选项

### 📱 系统托盘
- **后台运行**：关闭窗口后在托盘中继续运行
- **右键菜单**：显示/退出快捷操作
- **点击唤起**：点击托盘图标快速显示窗口

## 🚀 快速开始

### 环境要求

- Go 1.18+
- Node.js 16+
- Wails v2

### 安装依赖

```bash
# 安装 Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 克隆项目
git clone https://github.com/zhibing/nova-search.git
cd nova-search

# 安装依赖
go mod tidy
```

### 开发模式

```bash
# 启动开发服务器
wails dev
```

### 构建发布

```bash
# 构建可执行文件
wails build

# 构建并压缩（需要安装 UPX）
wails build -upx

# 清理缓存后构建
wails build -clean
```

## 📖 使用说明

### 基本操作

1. **设置目标目录**：在设置中选择要搜索的根目录
2. **搜索文件**：在搜索框中输入关键词
3. **浏览结果**：
   - 单击搜索结果：切换到文件所在目录
   - 双击文件：使用默认程序打开
   - 双击文件夹：在资源管理器中打开
   - 右键：在资源管理器中显示位置

### 快捷键

- `Ctrl+Shift+F`：显示/隐藏应用窗口（可自定义）
- `Esc`：清空搜索框
- `Enter`：打开选中的文件

### 托盘操作

- **左键点击**：显示/隐藏应用窗口
- **右键点击**：显示菜单（显示/退出）

## 🛠️ 技术栈

### 后端
- **Go**：主要编程语言
- **Wails v2**：桌面应用框架
- **golang.design/x/hotkey**：全局快捷键支持
- **energye/systray**：系统托盘功能

### 前端
- **Vue 3**：前端框架
- **Vite**：构建工具
- **CSS3**：样式和动画

## 📁 项目结构

```
nova-search/
├── app.go              # 主要业务逻辑
├── main.go             # 应用入口
├── config.json         # 配置文件
├── build/              # 构建资源
│   ├── appicon.png     # 应用图标
│   └── tray-icon.svg   # 托盘图标
├── frontend/           # 前端代码
│   ├── src/
│   │   ├── App.vue     # 主组件
│   │   └── components/ # 子组件
│   └── package.json
└── README.md
```

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

- [Wails](https://wails.io/) - 优秀的 Go 桌面应用框架
- [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
- [Material Design Icons](https://materialdesignicons.com/) - 图标资源

---

如果这个项目对你有帮助，请给个 ⭐️ 支持一下！