自助优先
自助排障
先按现象对照处理；仍解决不了，把诊断清单复制进反馈表单，一次定位。
按症自查
以下八种情况覆盖绝大部分求助，按第三列处理即可。
| 现象 | 先检查 | 怎么处理 |
|---|---|---|
| 明明存在的文件搜不到 | 所在文件夹是否在索引范围内；是否命中排除规则（如 node_modules、System Volume Information） | 在「设置 → 索引」添加该目录或调整排除项，然后重建该目录索引 |
| 新文件不出现 | 索引是否已完成（状态栏提示）；文件监听是否被安全软件拦截；是否以管理员身份运行（仅影响根目录级 USN 增量） | 等到索引就绪；提权后 USN 只额外覆盖卷根目录，子目录仍由文件监听负责；必要时手动触发一次增量索引 |
| 图片或扫描件搜不到 | 对应能力是否开启，以及账号是否为 Pro | 在「设置 → 智能与自动化」开启图片 OCR / PDF OCR（PDF OCR 默认关闭）；OCR 属 Pro 能力，免费版无法开启 |
| 代码符号搜不到 | 文件后缀是否在支持的 8 种语法内（JavaScript、TypeScript / TSX、Python、Java、C、C++、Go、Rust）；符号索引白名单是否被后台收窄 | 确认文件类型；单文件超过 2 MB 不建符号索引；企业环境请让管理员确认白名单配置 |
| 云盘文件搜不到内容 | 云盘只索引文件名与路径等元数据；OneDrive / Google Drive / Dropbox 的 OAuth 是否已在后台配置 | 用 WebDAV（如坚果云）连接，或把需要的文件下载到本地索引目录；云端正文不会被下载解析 |
| 登录不上或数据为空 | 是否已登录且会话未过期；浏览器扩展或代理是否拦截了请求；是否用了无痕窗口 | 退出后重新登录；换一个网络或关闭拦截类扩展再试；仍不行请附上浏览器版本 |
| 全局热键无反应 | 该组合是否被其它软件占用（Ctrl+Alt+Space 等） | 在「设置 → 常规 → 快捷键」换一个组合；托盘图标右键菜单里也能打开主窗口 |
| 安装被安全软件拦截 | 安装包当前未做代码签名，Windows 会给出「未知发布者」提示；企业终端可能有软件白名单 | 核对下载页的 SHA-256 后选择「仍要运行」；企业环境请联系 IT 把 QuickFind 加入白名单 |
反馈问题时，附上应用版本（设置 → 关于）、Windows 版本、出问题的文件所在盘符与文件类型，能显著加快定位速度。请不要把包含敏感内容的文件本身发给我们。
诊断信息
带上这四项，一次定位；可直接复制成清单。
版本与运行环境
「设置 → 关于」里有 QuickFind 版本、Electron 版本与 Windows 版本。
日志文件
%APPDATA%\QuickFind\logs\app-YYYY-MM-DD.log（按日期分文件，含启动、索引与异常记录）。
索引概况
「设置 → 索引」里的目录清单、排除项与已索引文件数；不用发索引文件本身。
复现步骤
从启动到出问题的完整操作顺序，以及是否每次都能复现。