故障排除

应用程序无法启动

Windows

• SmartScreen 阻止执行：点击 更多信息 → 仍要运行。应用程序将被添加到后续启动的信任列表中。
• WebView2 错误：请确保已安装 Microsoft Edge WebView2 Runtime（在 Windows 11 上预装，在较旧的 Windows 10 版本上需要手动安装）。

macOS

• “无法打开 CineRename，因为无法验证开发者”：
  • 右键单击图标 → 打开（仅需操作一次）
  • 或者：系统偏好设置 → 隐私与安全性 → 仍要打开

Linux

• AppImage 无法启动：检查是否执行了 chmod +x CineRename.AppImage。如果错误提及 FUSE，请安装 libfuse2（在 Ubuntu 上执行 sudo apt install libfuse2）。
• WebKit 错误：在某些精简的发行版上，安装 webkit2gtk-4.0 或 webkit2gtk-4.1。

Plex / Jellyfin 无法识别我的文件

1. 检查文件夹结构是否符合服务器的约定（请参阅 Plex / Jellyfin / Emby）。
2. 检查标题 + 年份是否能被 TheTVDB 或 TMDB 识别。如果不能，请显式添加 ID（例如 {tmdb-12345}）。
3. 执行全面扫描并强制更新元数据。
4. 如果以上都不起作用，请将文件移出媒体库，扫描，然后将文件移回，再次扫描 (Plex Dance)。

字幕未下载

• 检查您的 OpenSubtitles API 密钥（设置 → Providers）。
• 对于非常罕见的文件，视频哈希可能找不到任何结果。此时会回退到元数据搜索 —— 请在 Studio 中检查是否已正确识别了标题 + 季数 + 集数。
• 检查速率限制 (rate limit)：OpenSubtitles 会根据您的计划限制每天的下载次数。

自动模式陷入无限循环

如果 CineRename 在每个周期都重复处理同一个文件：

• 检查最终目标媒体库是否不同于源文件夹。
• 监控程序 (watcher) 应该仅配置在源文件夹上。
• 如果您使用 rsync 推送文件到源文件夹，请确保在 CineRename 开始监控之前它已完成复制（建议使用一个名为 .in-progress 的子文件夹）。

重命名非常慢

• 在机械硬盘上，大规模操作受限于 I/O (磁盘读写速度)。处理 100 个文件大约需要 5-10 秒。
• 在通过 SMB / NFS 挂载的 NAS 上，网络延迟会成倍增加操作时间。对于非常大的卷，请在本地挂载共享文件夹（使用 sshfs / nfs 并加上 noatime 参数）。
• 检查日志（设置 → 高级 → 详细程度 = debug）以识别出速度慢的步骤。

“拒绝访问”错误

• 在 Windows 上，以管理员身份运行应用程序（右键单击 → 以管理员身份运行）。
• 在 macOS 上，Tauri v2 需要显式权限。进入 系统偏好设置 → 隐私与安全性 → 完全磁盘访问权限，并授权给 CineRename。
• 在 Linux 上，检查文件夹权限（ls -la）和用户所有权。

撤销 (Undo) 失败

请参阅 历史记录与撤销 中的专用部分。常见原因：

• 文件在 CineRename 外部被手动删除
• 源卷未挂载
• 文件在被 CineRename 处理后又被重命名了

如何启用详细日志？

设置 → 高级 → 详细程度 (Verbosity)：

• error — 仅限错误（默认）
• warn — 错误 + 警告
• info — 关键事件
• debug — 对诊断有用的详细信息
• trace — 极其繁杂的输出，用于开发调试

或者通过环境变量 CINERENAME_LOG_LEVEL=debug。

我的数据存储在哪里？

操作系统	配置文件夹	日志
Windows	%APPDATA%\CineRename\	%APPDATA%\CineRename\logs\
macOS	~/Library/Application Support/CineRename/	同上 /logs/
Linux	~/.config/CineRename/	同上 /logs/

您可以删除这些文件夹以重新开始（会丢失历史记录和预设）。

我没有找到我想要的答案

• 请写信给 cinerename@gmail.com，并附上：
  • 您的操作系统和 CineRename 的版本
  • 问题的精确描述
  • 最好能提供日志（设置 → 支持 → 复制日志）