Skip to content

USER_GUIDE.md

Latest commit

 

History

History
211 lines (143 loc) · 5.39 KB

USER_GUIDE.md

File metadata and controls

211 lines (143 loc) · 5.39 KB
Raw

用户指南

🚀 使用指南

快速开始

  1. 启动应用后会自动检测 Everything 连接状态
  2. 在搜索框中输入查询内容
  3. 支持三种搜索方式：

💬 自然语言搜索 (推荐)

配置 OpenAI API 后可使用自然语言搜索：

今天修改的PDF文件
大于10MB的视频
本周创建的图片
桌面上的Word文档
昨天下载的压缩包
包含"报告"的Excel文件

🔧 Everything 语法搜索

直接使用 Everything 强大的搜索语法：

*.pdf dm:today                    # 今天修改的PDF
size:>10mb *.mp4;*.avi           # 大于10MB的视频文件
dc:thisweek *.jpg;*.png          # 本周创建的图片
path:desktop *.docx              # 桌面上的Word文档
*.zip;*.rar dm:yesterday         # 昨天修改的压缩文件
*报告* *.xlsx                     # 包含"报告"的Excel文件

🔍 简单关键词搜索

直接输入文件名或关键词：

报告.docx                        # 查找包含"报告"的Word文档
*.pdf                           # 查找所有PDF文件
photoshop                       # 查找包含"photoshop"的文件

🎯 高级搜索功能

文件大小筛选

  • size:>100mb - 大于100MB的文件
  • size:<1kb - 小于1KB的文件
  • size:1mb..100mb - 1MB到100MB之间的文件

时间筛选

  • dm:today - 今天修改的文件
  • dc:yesterday - 昨天创建的文件
  • da:thisweek - 本周访问的文件

路径筛选

  • path:desktop - 桌面路径下的文件
  • !path:temp - 排除临时文件夹的文件

文件类型组合

  • *.jpg;*.png;*.gif - 常见图片格式
  • *.mp4;*.avi;*.mkv - 常见视频格式
  • *.doc;*.docx;*.pdf - 常见文档格式

⌨️ 快捷键与操作

搜索操作

  • Enter - 执行搜索
  • ↑/↓ - 浏览搜索历史
  • Esc - 清空搜索框
  • 点击搜索建议 - 快速使用预设搜索

文件操作

  • 双击文件 - 使用默认程序打开文件
  • 右键文件 - 显示文件上下文菜单
  • 点击文件路径 - 在资源管理器中显示文件

界面操作

  • 点击列标题 - 按该列排序（再次点击切换升降序）
  • ⚙️ 设置按钮 - 配置 OpenAI API 和显示选项
  • 标题栏 − □ × - 最小化、最大化、关闭窗口

结果管理

  • 📤 导出结果 - 导出搜索结果为文件
  • 🗑️ 清空结果 - 清除当前搜索结果
  • 搜索历史下拉 - 快速重复之前的搜索

搜索语法示例

自然语言 Everything语法 说明
今天的PDF *.pdf dm:today 今天修改的PDF文件
大于10MB的视频 *.mp4;*.avi size:>10mb 大于10MB的视频文件
桌面上的图片 *.jpg;*.png path:desktop 桌面目录的图片
本周的文档 *.doc;*.docx dm:thisweek 本周修改的文档

🔧 故障排除

应用启动相关问题

应用启动失败

症状: 运行 npm run dev 后应用无法启动 解决步骤:

  1. 确保端口5173未被占用

  2. 终止可能存在的旧进程：taskkill /f /im node.exe

  3. 重新安装依赖：

    rm -rf node_modules
npm install
npm run dev

Electron 窗口空白

症状: 应用启动但显示空白窗口 解决方案:

  1. 等待 Vue 开发服务器完全启动（通常需要10-30秒）
  2. 检查控制台是否有错误信息
  3. 尝试刷新窗口或重启应用

Everything 连接问题

状态显示"未连接"

解决步骤:

  1. 检查 Everything 是否运行: 确保 Everything 软件正在后台运行
  2. 启用 HTTP 服务器:
    • 打开 Everything → 工具 → 选项 → HTTP
    • 勾选"启用 HTTP 服务器"
    • 确认端口为 80（默认）
    • 点击"确定"并重启 Everything
  3. 检查端口占用: 确认端口80未被其他程序占用
  4. 使用一键连接: 在应用设置中点击"一键连接Everything"

Everything HTTP 服务无法启动

解决方案:

  1. 以管理员身份运行 Everything
  2. 更改 HTTP 端口（如改为8080）
  3. 检查 Windows 防火墙设置
  4. 确保 Everything 版本为 1.4.1 或更高

OpenAI API 相关问题

API 请求失败

常见错误及解决方案:

  • 401 Unauthorized: API Key 错误，请检查并重新输入
  • 429 Too Many Requests: 请求频率过高，请稍后重试
  • 403 Forbidden: 账户余额不足或API Key无效
  • 网络错误: 检查网络连接，或尝试更换 API 端点

自然语言转换效果不佳

优化建议:

  1. 使用更具体的描述词汇
  2. 尝试不同的表达方式
  3. 检查是否选择了合适的 AI 模型（推荐 GPT-3.5-turbo）

搜索功能问题

搜索结果为空

排查步骤:

  1. 检查 Everything 索引: 确保 Everything 已完成文件索引
  2. 验证搜索语法: 尝试使用更简单的关键词（如 *.txt）
  3. 检查文件权限: 确保有权限访问目标文件夹
  4. 重建索引: 在 Everything 中选择"工具 → 重建数据库"

搜索速度慢

优化方法:

  1. 减少搜索结果数量限制
  2. 使用更精确的搜索条件
  3. 确保硬盘空间充足
  4. 关闭不必要的后台程序

界面显示问题

文件图标显示异常

解决方案: 重启应用，图标映射会自动修复

窗口大小异常

解决方案:

  1. 双击标题栏恢复窗口
  2. 右键标题栏选择窗口控制选项
  3. 重启应用恢复默认大小