故障排查

报告问题时请提供：

• Resrch App 版本和发布通道；
• 操作系统及版本；
• 发生故障前执行的操作；
• 完整可见错误信息；
• 重启 Resrch 后问题是否仍会出现。

启动或 Core 连接失败

1. 完全退出 Resrch，然后重新启动一次。
2. 记录完整启动错误或 core.session.hello 错误，不要只截取最后一行超时信息。
3. 如果 CLI 可用，运行 resrch doctor 和 resrch paths。
4. 打开命令报告的 log_dir，保留相关的 resrch.log.YYYY-MM-DD。只有启用文件日志后才会生成这些文件。

PDF 或预览失败

• 确认源文件仍然存在且可读取。
• 对于项目，确认依赖仍位于已经打开的项目根目录中。
• 保留编译器诊断；缺少 LaTeX 编译器、超时和源文件编译错误是不同问题。
• 首次使用 Tectonic 后端生成 LaTeX 预览时，准备支持文件可能需要更长时间。

分享日志前，请检查其中是否含有本地路径、文档标题、私人源文本、访问令牌或其他凭据。请遮盖敏感值，但不要删除实际错误类型。通过支持页面查看可用支持渠道。