FindFiles - 文件搜索工具

一个基于 Tauri + Vue 3 构建的跨平台桌面文件搜索工具，专为 macOS 优化，提供快速、高效的文件搜索体验。

✨ 功能特性

• 🔍 快速搜索: 基于文件名的智能搜索，支持模糊匹配
• 📁 多路径支持: 可搜索指定目录或使用默认用户目录
• 🎯 文件类型过滤: 支持图片、视频、音频、文档、压缩包等类型筛选
• 📏 大小过滤: 可按文件大小范围进行筛选
• 🕒 时间排序: 按修改时间排序，快速找到最新文件
• 🎨 现代界面: 基于 Ant Design Vue 的美观用户界面
• 🚀 高性能: 优化的搜索算法，支持大量文件快速检索
• 💻 跨平台: 基于 Tauri 构建，支持 Windows、macOS、Linux

🛠️ 技术栈

前端

• Vue 3 - 渐进式 JavaScript 框架
• TypeScript - 类型安全的 JavaScript 超集
• Ant Design Vue - 企业级 UI 设计语言
• Vue Router - Vue.js 官方路由管理器
• Vite - 下一代前端构建工具

后端

• Rust - 系统级编程语言
• Tauri - 跨平台桌面应用框架
• WalkDir - 递归目录遍历库
• Serde - 序列化/反序列化框架

📋 系统要求

• 操作系统: macOS 10.15+, Windows 10+, Linux (Ubuntu 18.04+)
• 内存: 最低 4GB RAM
• 存储: 至少 100MB 可用空间
• Node.js: 版本 16.0 或更高

🚀 安装说明

从源码构建

1. 克隆项目

   git clone https://github.com/private-xss/findfiles.git
   cd findfiles

2. 安装依赖

   # 安装前端依赖
   npm install
   
   # 安装 Rust 工具链 (如果未安装)
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

3. 构建应用

   # 开发模式
   npm run tauri dev
   
   # 生产构建
   sudo npm run tauri build

预编译版本

从 Releases 页面下载最新版本的安装包。

📖 使用指南

基本搜索

1. 在搜索框中输入文件名或部分名称
2. 应用会自动搜索并显示匹配结果
3. 点击文件可在 Finder 中显示位置

高级搜索

• 路径限制: 在搜索选项中指定特定目录
• 文件类型: 选择特定文件类型进行筛选
• 大小范围: 设置文件大小的最小值和最大值
• 包含隐藏文件: 勾选选项以搜索隐藏文件

快捷键

• Cmd/Ctrl + F: 聚焦搜索框
• Enter: 执行搜索
• Esc: 清空搜索框
• Cmd/Ctrl + R: 刷新搜索结果

频繁弹窗

• 打开 系统偏好设置 > 安全性与隐私 > 隐私
• 选择 完全磁盘访问权限 (Full Disk Access)
• 添加 FindFiles 应用到权限列表
• 重启应用 使权限生效

🔧 开发指南

项目结构

findfiles/
├── src/                    # Vue 前端源码
│   ├── components/         # Vue 组件
│   ├── views/             # 页面视图
│   ├── utils/             # 工具函数
│   └── types/             # TypeScript 类型定义
├── src-tauri/             # Rust 后端源码
│   ├── src/               # Rust 源代码
│   ├── Cargo.toml         # Rust 依赖配置
│   └── tauri.conf.json    # Tauri 配置文件
├── dist/                  # 构建输出目录
└── package.json           # Node.js 依赖配置

开发命令

# 启动开发服务器
npm run dev

# 启动 Tauri 开发模式
npm run tauri dev

# 构建前端
npm run build

# 构建桌面应用
npm run tauri build

# 预览构建结果
npm run preview

代码规范

• 使用 TypeScript 进行类型检查
• 遵循 Vue 3 Composition API 最佳实践
• Rust 代码遵循 Rust 官方编码规范
• 提交信息使用 Conventional Commits 格式

🐛 故障排除

常见问题

1. 构建失败

   • 确保已安装 Rust 工具链
   • 检查 Node.js 版本是否兼容
   • 清理并重新安装依赖

2. 搜索无结果

   • 检查搜索路径是否正确
   • 确认文件权限设置
   • 尝试包含隐藏文件选项

3. 性能问题

   • 限制搜索深度和结果数量
   • 避免搜索系统目录
   • 使用更具体的搜索关键词

日志查看

在开发模式下，错误日志会显示在终端中。生产版本可通过系统日志查看错误信息。

🤝 贡献指南

我们欢迎所有形式的贡献！

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

贡献类型

• 🐛 Bug 修复
• ✨ 新功能
• 📚 文档改进
• 🎨 UI/UX 优化
• ⚡ 性能提升
• 🧪 测试用例

📄 许可证

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

🙏 致谢

• Tauri - 跨平台桌面应用框架
• Vue.js - 渐进式 JavaScript 框架
• Ant Design Vue - 企业级 UI 组件库
• Rust - 系统编程语言

📞 联系我们

• 项目主页: GitHub Repository
• 问题反馈: Issues
• 功能建议: Discussions

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！