快速开始

SigXor 以「便携 ZIP + 内置更新器」的方式发布。程序常驻系统托盘，不打开主窗口；安装完成后，在资源管理器中选中文件按空格即可预览。

下载与安装#

1. 前往 GitHub Releases 下载最新的 SigXor-{版本}-win-x64.zip。
2. 解压到用户可写目录，例如 D:\Apps\SigXor。不要放在 Program Files 等只读目录，自动更新需要写入程序目录。
3. 如未安装，先安装 .NET 10 Desktop Runtime 与 WebView2 运行时（Windows 10/11 通常已预装）。
4. 运行 SigXor.exe。如出现 SmartScreen 提示，选择「更多信息 → 仍要运行」（当前发布包未做代码签名）。
5. 程序启动后只出现在系统托盘。在资源管理器中选中文件并按 Space 开始预览。

便携性： 复制整个解压目录即可迁移到另一台电脑，无需安装程序。目标机同样需要 .NET 10 Desktop Runtime 与 WebView2。

系统要求#

首次运行#

• 托盘菜单： 打开文件预览、区域截图、语音与截屏、启动 / 停止语音服务、设置、检查更新、关于与退出。
• 语音与 OCR 模型： 不打进发布包。首次使用语音或 OCR 时按需下载（SenseVoice 约 230 MB，PP-OCR 约 30 MB，回退版本约 16 MB），下载后完全离线。
• 设置页： 分为「常规」「语音与截屏」「服务与模型」三页，可配置开机自启、静默启动、关闭到托盘、通知、语音与截图快捷键等。
• 命令行： SigXor.exe <file> 直接打开指定文件的预览；SigXor.exe --silent 静默启动，仅驻留托盘。

自动更新#

SigXor 使用自研更新器读取 GitHub Releases 中的 latest.json：

1. 检查更新并比较版本号。
2. 下载完整应用 ZIP，并校验 SHA256。
3. 应用退出后，由内嵌更新器整包替换程序文件。
4. 新版本 30 秒内未就绪时自动回滚到上一版本。

因此程序目录必须可写。若更新器进程被强制结束，可以把 SigXor.exe.bak 改回 SigXor.exe 手动恢复；详细日志见程序目录下的 updater.log。

从旧版 Velopack 安装包升级时，请先退出旧版并在 Windows「设置 → 应用」中卸载，再把新版 ZIP 解压到一个新的可写目录，不要原地覆盖。

数据目录#

用户数据统一存放在文档目录：

Documents/FNSoftware/SigXor/
├─ settings.json      # 常规 / 语音 / 截屏设置
├─ pinned-apps.json   # 启动器固定应用
├─ Backups/           # 保存前自动备份
├─ Logs/              # 未处理异常日志
├─ Models/
│  ├─ Speech/         # SenseVoice 语音模型
│  └─ Ocr/            # PP-OCRv6 / v5 模型
├─ Screenshots/       # 截图默认保存位置
└─ Audio/             # 调试录音 WAV

从更早版本迁移时，SigXor 会自动迁移旧数据目录，并可只读复用或手动迁移旧模型。

卸载#

1. 在托盘菜单选择「退出」。
2. 删除程序目录。
3. 如需彻底清理用户数据，再删除 Documents/FNSoftware/SigXor。

下一步#

• 空格快速预览
• 快捷键
• 安装与故障排除