故障排查
1FileTool 常见问题的修复：安装器警告、运行报错、OCR 与模型下载卡住、每日限额提示、许可证激活失败、AI Chat 无响应——按症状分节排查，每节给出具体可操作的解决步骤。每条先给症状，再给原因，最后给验证过的修复步骤。并注明验证修复是否生效的方法。
大多数 1FileTool 问题归结为安装器、被拦的首次下载，或 Replace source 完完全全按它说的做了——找到与你症状相符的小节来处理。
安装与更新
Windows 提示 "Windows protected your PC"（SmartScreen）。 Windows 安装包还没做代码签名，所以 SmartScreen 在首次启动时拦它。选 More info → Run anyway——下载来自官方发布。（macOS 构建已签名并公证；此警告仅出现在 Windows。）
AppImage 在 Linux 上起不来。 给它执行权限（chmod +x），如果你的发行版缺 FUSE，装 libfuse2/fuse，或者加 --appimage-extract-and-run 参数运行。Linux 构建未签名——包管理器对 .deb 也可能警告。
Windows 或 Linux 上没有 ARM 构建。 应用只给 Apple Silicon 出 ARM 构建；Windows 和 Linux 支持 x64。
更新： 用应用菜单（macOS）或 File 菜单（Windows/Linux）里的 Check for Updates...。应用也会每 6 小时自己查 GitHub Releases；在 Settings › Updates 里管理。
运行工具
先保护好原始文件
Replace source 默认开启：输出会覆盖原文件且不保留备份。在跟着操作之前，请打开 Settings › General 关闭 Replace source，或另选一个输出文件夹。
我找不到结果。 运行后先看结果卡片，再看 History——每次运行都被记录。如果 Replace source 是开的，输出就是原文件（原位覆盖）；如果是关的，去看 ~/Documents/1FileTool 或你用 Change 选的文件夹。
工具报错。 结果卡片会显示错误文本；重试前先复制下来。常见原因：该工具不支持输入格式（例如 HEIC 只能作为输入——你不能转换成 HEIC）、源文件损坏，或文件被别的应用锁住。
输出文件比原文件还大。 这确实会合法发生——有些源（已优化的文件、被重新编码为 PNG 的低质量 JPEG）压不小。结果卡片总是显示前后体积，什么都不藏。
OCR 输出乱码或空白。 Tesseract.js 仅支持英文，写的是 .txt 文件，不是可搜索 PDF；手写和低分辨率扫描识别不好。
某个 AI 功能要求下载模型。 正常——首次使用某个声音（~63 MB，来自 Hugging Face）或 Background Removal（~178 MB，来自 GitHub）会下载一次模型。如果卡住，检查网络再重试；下载完成后它就离线工作。
限额与许可证
"Daily limit reached — resets tomorrow"。 免费档按自然日计 8 个输出文件；侧边栏计数器显示你的进度。Pro 解除上限——见 免费版与 Pro。
许可证激活失败。 在 Settings › License 里重新粘贴完整密钥，确认没超设备数（1/3/5），并在同一标签页里先反激活一台旧设备再重试。激活需要能访问 Lemon Squeezy 的网络。
AI Chat
AI Chat 不工作。 它是通往你自己安装的 AI CLI 的桥（Claude Code、Gemini CLI、Codex 之类）——CLI 必须已安装且已登录，模型服务商看得到它读到的一切。自动配置覆盖 Claude Code 和 Gemini CLI；其他 CLI 需要手动设置。如果完全没响应，先打开终端确认 CLI 能独立运行。