故障排除
按空格没有预览、语音无反应、OCR 失败、截图快捷键无效、更新失败等常见问题的排查方法。
全部文档
本页目录
先确认程序已在托盘运行，版本为最新，并且程序目录可写。多数问题可以在「设置」与托盘菜单中找到答案。仍未解决时，请附上 Documents/FNSoftware/SigXor/Logs 中的日志到 GitHub Issues 反馈。
安装与启动#
双击 SigXor.exe 没有窗口#
这是预期行为。SigXor 常驻系统托盘，不打开主窗口。请查看任务栏右下角的托盘图标，或运行 SigXor.exe --silent 验证。
SmartScreen 提示未知发布者#
当前发布包未做代码签名。点击「更多信息 → 仍要运行」。如果安全软件拦截，请把 SigXor.exe 及其目录加入信任列表。
提示缺少 .NET 运行时#
安装 .NET 10 Desktop Runtime（64 位）。仅安装 ASP.NET Core Runtime 或 .NET Runtime 不足以运行 WPF 应用。
程序无法保存或更新#
把程序解压到用户可写目录，例如 D:\Apps\SigXor。Program Files 等受保护目录会导致自动更新与部分保存操作失败。
文件预览#
选中文件按空格没有预览#
- 确认文件已在资源管理器中选中，且当前焦点不在输入框。
- 确认 SigXor 正在托盘运行。
- 某些文件管理器或第三方 shell 扩展可能拦截空格键，可改用托盘菜单或命令行打开。
文本文件显示乱码#
在预览工具栏切换编码为 UTF-8、UTF-16 或 GB18030。SigXor 会尝试自动识别，但部分混合编码或损坏文件仍需要手动指定。
大文件打不开或提示切换视图#
文本预览上限为 100 MB，超过后请使用十六进制视图。十六进制视图采用虚拟化读取，1 GB 以内文件可流畅编辑。
Office 预览显示不完整#
- 结构化视图与网页视图可在预览顶部切换；网页视图排版更接近原文件，但 PPT / PPTX 超过 8 MB 时会禁用。
- 旧版
.doc/.ppt（OLE2）不受支持，会提示使用十六进制视图。 - WebView2 缺失时网页视图、Markdown 渲染、音频与 PDF 不可用，但结构化视图与文本编辑不受影响。
WebView2 运行时缺失#
Windows 10/11 通常已预装。如缺失，可从 Microsoft WebView2 页面 下载安装，或使用 Evergreen Bootstrapper。
语音输入#
语音快捷键没有反应#
- 确认「设置 → 语音与截屏」中「启动语音服务」已开启。
- 确认 SenseVoice 模型已下载完成。
- 检查快捷键是否被输入法、游戏或其它全局快捷键软件占用。
- 检查系统麦克风权限与默认输入设备。
识别成功但没有输入到窗口#
- 说话前先让目标输入框获得焦点。
- 如果剪贴板粘贴无效，切换到「键盘模拟」输入方式。
- 管理员权限窗口会阻止普通进程注入输入（UIPI），请以相同权限运行目标程序和 SigXor。
首次使用一直无法下载模型#
检查网络与代理设置；语音模型约 230 MB。可在「服务与模型」中打开模型目录确认下载状态，删除不完整的模型后重试。
截图与 OCR#
截图快捷键 Alt + ` 没有反应#
- 确认「启用区域截屏」已勾选。
- 确认修饰键与语音快捷键不冲突。
- 笔记本键盘的 Fn 组合通常不会传给系统，可启用「无修饰 `」。
混合 DPI 多屏截图位置不准#
当前覆盖层是单个虚拟桌面窗口。同 DPI 多屏可正常使用；混合 DPI 环境仍在实机验证中。可暂时把多屏缩放设为相同比例。
OCR 首次点击没有结果#
首次使用需要下载 PP-OCRv6（约 30 MB），下载失败会回退 PP-OCRv5。等待下载完成或到「服务与模型」手动下载后重试。
OCR 识别率低#
提高截图清晰度与对比度，避免缩放过小的文字。OCR 主要面向屏幕文字，手写体、艺术字体与低分辨率图片的识别率有限。
更新#
检查更新提示无法自动更新#
调试构建、程序目录不可写或更新器缺失时会禁用自动更新。请把程序解压到可写目录，或手动从 Releases 下载新版 ZIP。
更新失败或启动异常#
- 更新器会把旧版本备份为
SigXor.exe.bak，新版本 30 秒内未就绪会自动回滚。 - 详情见程序目录下的
updater.log。 - 若更新器被强制结束，可手动把
SigXor.exe.bak改回SigXor.exe。
从旧版 Velopack 升级后出现问题#
新版便携 ZIP 与旧版 Velopack 安装包不混用。请先卸载旧版，再解压到新的可写目录；用户数据与模型会保留在 Documents/FNSoftware/SigXor。
诊断信息#
反馈问题时请附上：
- SigXor 版本（托盘菜单 →「关于」）。
- Windows 版本与 64 位 / ARM 架构。
- 复现步骤与相关文件类型。
Documents/FNSoftware/SigXor/Logs中的日志。- 如与截图相关，注明显示器数量、分辨率与缩放比例。
更多常见问答见 FAQ。