Prism 中的故障排查与获取帮助

Prism 是一个协作式、AI 原生的 LaTeX 工作空间，基于前沿模型构建，旨在帮助研究人员更快地思考、写作和迭代。其内置智能可提升科研工作的速度和深度。

本指南概述了如何排查常见问题以及在哪里获取更多帮助。

如何访问 Prism

所有使用 Free、Go、Plus 或 Pro ChatGPT 账户，且当前不是、过去也不是 Business 或 Enterprise 工作空间成员的用户，都可以通过 prism.openai.com 访问 Prism。我们将在不久的将来向 Business、Enterprise 和 Edu 扩大访问权限。

1. 使用 Prism 的内置智能

Prism 包含一个由 OpenAI 前沿模型驱动的编辑器原生助手。它能理解您的文档上下文，并可在不离开编辑器的情况下帮助生成 LaTeX、诊断错误并提出修复建议。您可以从工作空间底部的面板访问它。

1. 生成 LaTeX 片段：让 Prism 创建常见的 LaTeX 元素，例如“创建一个 4×4 表格”或“添加一个带标题的图片”。Prism 会返回可直接使用的 LaTeX，并提供 Keep 和 Undo 选项，以便您直接将其插入项目中。

2. 诊断编译问题：如果您的文档编译失败，请在面板中描述问题（例如“我的文档无法编译”）。Prism 会提出澄清性问题，并引导您了解可能的原因，例如缺少命令或未解析的引用。

3. 内联修复错误：错误和警告会以红色或黄色标记显示在编辑器边距中。您可以让 Prism 修复某个具体错误，它会分析相关行、解释问题所在，并提出有针对性的编辑建议。您可以直接应用建议并重新编译，以确认修复是否生效。

4. 校对：让 Prism 校对某个部分，并突出显示任何错误或逻辑漏洞，同时也请它就如何提高该部分的清晰度提出建议。您还可以利用 Skills（如 Paper Review）获取编辑性和事实性反馈。

5. 文献检索：为我的论文添加参考文献，包括推荐我可能遗漏的相关工作。

2. 诊断编译错误

如果您的 LaTeX 文档无法编译，请尝试以下步骤：

1. 检查错误标记：红色和黄色标记会突出显示 Prism 检测到问题的位置。点击标记查看详细信息，然后使用内置助手诊断错误。

2. 查看编译日志：编译失败时，PDF 预览窗格会显示编译日志。请重点关注第一条错误信息（例如缺少 \end{document}），因为后续错误通常是连锁反应。将这条消息分享给 Prism，以获得更准确的指导。

3. 撤销最近的更改：如果错误是在最近编辑后出现的，请撤销该更改或暂时将其注释掉，看看是否能成功编译。

4. 缩减为最小示例：如果问题仍然存在，请将文档简化为仅保留必要内容。删除无关部分有助于定位错误来源。

3. 避免问题的最佳实践

1. 保持登录状态：请始终在登录状态下工作，以确保您的更改会被保存，并可在不同会话中访问。

2. 使用受支持的宏包：Prism 支持许多常用的 LaTeX 宏包。少见、过时或无人维护的宏包可能导致意外的编译错误。

3. 渐进式编辑：进行小幅更改并频繁编译。这样更容易识别是哪次编辑引入了错误，并快速恢复。

将 LaTeX 项目迁移到 Prism

本指南说明如何将现有的 LaTeX 项目——无论来自 Overleaf 还是您的本地计算机——迁移到 prism。导入项目可将所有内容集中在一处，让您无需手动重建文件即可继续工作。

从 Overleaf 导入项目

要将项目从 Overleaf 移动到 prism，请先从 Overleaf 下载项目文件，然后将其上传到 prism。

下载单个项目

1. 打开您的 Overleaf 项目仪表板。

2. 找到您想要转移的项目。

3. 点击与项目名称同一行中的下载图标。

4. Overleaf 会将整个项目作为 .zip 文件 下载到您的计算机。

下载多个项目

1. 打开您的 Overleaf 项目列表。

2. 使用每行开头的复选框选择项目。

   

3. 若要全选，请点击列表中的第一个复选框。

4. 选中后，点击项目列表右上角的下载图标。

   

所选项目将以 .zip 文件 的形式下载。

将项目导入 Prism

Prism 可通过三种方式导入项目：上传文件夹、上传 .zip 压缩包，或在 All Projects 视图中将文件拖放进去。


从 Import 菜单导入项目：

1. 打开 Prism 并前往 Import。

2. 点击 Import 旁边的箭头以选择导入类型。

选择以下其中一种：

1. 打开 prism 并导航到 Import 选项。

2. 点击Import 旁边的箭头以选择导入类型。

3. 选择以下其中一种：

导入 .zip 文件：从您的电脑中选择已下载的项目压缩包。Prism 会自动解压并加载该项目。

导入文件夹：从您的电脑中选择项目文件夹。Prism 会导入您的 .tex 文件、参考文献文件、图片以及其他项目资源。

通过拖放导入：在 All Projects 视图中，将项目文件夹或 .zip 文件拖放到 Prism 中。Prism 会自动创建一个新项目并为您导入这些文件。

上传完成后，Prism 会打开完整项目，您即可开始编辑和编译。

其他常见问题

账户、安全和账单

问：在哪里可以找到你们的隐私政策？
答：你可以在这里查看 Prism 隐私政策。

问：你们会用我的数据进行训练吗？
答：用户可以完全控制其数据是否用于帮助改进我们的模型，并符合我们的隐私政策。

问：你们是否使用“零数据保留”（ZDR）？会进行哪些日志记录/保留？
答：Prism 目前不使用“零数据保留”（ZDR）API 选项，并会在请求后将日志保留一段时间，以改进产品。


问：你们是否提供一种不存储文本或不进行人工审阅的隐私模式，和/或仅限欧盟的数据驻留？
答：这些是用户提出的功能需求；它们已列入路线图/待办事项，但目前还没有承诺的时间表。

共享与协作

问：为什么我不能分享“任何人都可编辑”的链接？（下拉菜单里只有“任何人都可查看”。）
答：这是当前的预期设计。尚不支持基于链接的“任何人都可编辑”共享；编辑者必须作为协作者添加（并拥有 Prism 账户）。

问：协作者收不到邀请邮件——他们如何访问项目？
答：请让他们检查垃圾邮件文件夹，并使用被邀请的电子邮件地址登录；首次登录后，共享项目应会显示出来。

项目导入与导出

问：我的 ZIP 上传/导入卡在“正在导入您的项目”上了。我该怎么办？
答：请重试上传。如果重试后仍然卡住，请将 ZIP 文件分享给支持团队，以便调试导入流程。

问：如何将我的项目导出/下载为 ZIP？
答：点击项目名称，然后选择 Export 下载项目的压缩副本。在能够导出之前，后端连接可能需要几秒钟才能建立。

可靠性、中断和连接问题

问：刷新后我的项目消失了。它们丢失了吗？
答：请再刷新一次并重新检查项目列表，您的数据应该会重新出现。

问：刷新页面后我的项目消失了。它们丢失了吗？
答：在某个提供商发生故障期间，可能会出现这种情况。请再试一次；您的项目应该会重新出现。如果没有，支持团队可以帮助恢复。

问：网站似乎离线了 / 应用提示无法连接到后端。我该怎么办？
答：请重试/重新加载。如果问题仍然存在，请将您看到的详细情况（以及项目链接，如果可以）发送给支持团队，以便调查。

数据完整性、恢复、备份和版本历史

问：我的文档卡住了，随后内容消失，评论锚点也移动了。我能恢复吗？
答：请先下载一个 .zip 备份。Prism 还包含版本历史，这可能让您恢复到较早的版本。评论锚点位置不一定总能恢复，且评论目前不会导出到备份中。如果格式发生变化，请尝试使用 代码格式化工具进行修复。

问：我重新打开一个项目后，文件/内容回退了或消失了——这是怎么回事？
答：之前有一段时间，项目保存依赖于一个外部提供商，而该提供商在使用量激增时无法跟上。后来保存已迁移到内部系统，以减少连接错误并防止再次发生，同时也增加了额外的保护措施。

问：评论位置可以恢复吗？项目备份中包含评论吗？
答：事后可能无法恢复评论位置。现在已有定期备份（例如大约每 10 分钟一次）用于未来事件中的恢复，但评论目前不会导出到 ZIP 备份中。

集成

Zotero

问：为什么我无法将 Zotero 群组库导入 Prism？
答：Zotero 群组库尚不受支持；个人库可以使用，但群组库目前不受支持。

问：我的 Zotero 集成卡住了（例如，在更改账户或 API 密钥后）。该如何修复？
答：支持团队需要你的 Zotero 数字 ID（不是用户名），以便将该集成与先前/匿名用户解除关联，之后你可以将其重新关联到你的账户。操作示例：https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

问：我可以通过 Git（GitHub/GitLab）克隆 Prism 项目，或让它与我所在机构的 Git 平台保持同步吗？
答：Git 集成尚未推出，但这是一个高优先级的后续开发项目。

LaTeX 构建与故障排查

问：如何强制执行一次干净的重新构建（清除 Aux/toc/bbl 产物）？
答：重新加载页面。刷新页面会强制执行一次全新的干净构建。

问：图形/图片在 Prism 中无法加载，但相同的 LaTeX 在其他地方可以正常工作。
答：请使用相对于执行导入的 .tex 文件的路径。如果 .tex 文件位于子文件夹中，而图片位于项目根目录，请在路径前加上 ../。

问：编译非常慢或始终无法完成。我该如何找出原因？
答：请逐步注释掉各个部分（然后再注释这些部分中的更小部分），直到编译成功，再缩小范围找到导致问题的确切行。同时也请查看日志中的警告和错误，并从第一条开始看。

问：我在生成的 .bbl 中看到“Underfull/Overfull \hbox”警告。这是编译错误吗？
答：不是，这些是排版警告，不是致命的编译错误。如果 PDF 输出看起来可以接受，通常可以忽略该警告。

问：在 Beamer 中，为什么 lstlisting/listings 环境在 frame 内会报错（例如“Extra }, or forgotten \endgroup”）？
答：在使用 listing 环境时，将 Beamer frame 标记为 [fragile]；这通常可以解决这些错误。

问：我的 \cite 引用显示为“[?]”，即使我的 .bib 文件存在且文献命令也已写好。有什么可行的配置？
一种已被证明有效的变通方法是，确保从主文档中正确包含了参考文献；对于 BibTeX 风格的工作流，请加入 \bibliographystyle{plain} 和 \bibliography{refs}（其中 refs.bib 是您的文件）。

产品界面和功能请求

问：Prism 提供浅色模式吗？
答：提供。Prism 支持三种外观设置：System、Light 和 Dark。您可以选择最适合自己的主题。