OpenAI
页面内容为机器翻译。查看英文原文。

Prism 故障排查

了解如何排查 Prism 问题、解决 LaTeX 编译问题、导入项目及获取支持。

更新于：3 days ago

概述

Prism 是一个基于前沿模型构建、支持协作的 AI 原生 LaTeX 工作空间，旨在帮助研究人员更高效地思考、写作和迭代。其内置智能功能既能加快科研进度，也能深化研究。

本指南介绍了常见问题的排查方法，以及获取更多帮助的途径。

访问 Prism

所有拥有 ChatGPT Free、Go、Plus 或 Pro 账号，且现在及过去均未加入过 Business 或 Enterprise 工作空间的用户，都可以通过 prism.openai.com 使用 Prism。我们将在不久后向 Business、Enterprise 和 Edu 用户开放访问权限。

使用 Prism 的内置智能功能

Prism 在编辑器中原生集成了由 OpenAI 前沿模型驱动的助手。它能理解文档上下文，帮助你生成 LaTeX、诊断错误并提供修复建议，全程无需离开编辑器。你可以通过工作空间底部的面板使用它。

  1. 生成 LaTeX 代码片段：让 Prism 创建常用的 LaTeX 元素，例如“创建一个 4×4 表格”或“添加一张带图注的图片”。Prism 会返回可直接使用的 LaTeX 代码，并提供保留和撤销选项，方便你将代码直接插入项目。

  2. 诊断编译问题：如果文档编译失败，请在面板中描述问题（例如“我的文档无法编译”）。Prism 会提问以进一步了解情况，并引导你排查可能的原因，例如缺少命令或存在未解析的引用。

  3. 就地修复错误：错误和警告会以红色或黄色标记显示在编辑器侧边。你可以让 Prism 修复某个具体错误，它会分析相关代码行、解释问题所在，并提出有针对性的修改建议。你可以直接应用建议，再重新编译以确认问题已修复。

  4. 校对：让 Prism 校对某个部分，标出其中的错误或逻辑漏洞，并就如何让表述更清晰提出建议。你可以使用“论文审阅”等技能，获取写作和事实准确性方面的反馈。

  5. 文献检索：为论文添加参考文献，并推荐可能遗漏的相关研究。

诊断编译错误

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

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

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

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

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

避免常见问题

  1. 保持登录：始终在登录状态下工作，确保更改得到保存，并能在之后的会话中继续访问。

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

  3. 逐步编辑：每次只做少量更改，并经常编译。这样更容易确定是哪次编辑引入了错误，并快速恢复。

将 LaTeX 项目迁移到 Prism

本指南介绍如何将 Overleaf 或本地电脑上已有的 LaTeX 项目迁移到 Prism。导入项目后，所有内容都能集中管理，你可以继续开展工作，无需手动重新创建文件。

从 Overleaf 导入项目

要将项目从 Overleaf 迁移到 Prism，请先从 Overleaf 下载项目文件，再上传到 Prism。

下载单个项目

  1. 打开你的 Overleaf 项目控制面板。

  2. 找到要迁移的项目。

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

  4. Overleaf 会将整个项目以 .zip 文件的形式下载到你的电脑上。

Prism Actions column with the download icon hovered and the tooltip Download .zip file

下载多个项目

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

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

Overleaf project list with multiple projects selected using checkboxes

  1. 要选择所有项目，请点击列表中的第一个复选框。

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

Prism file list with the Download action hovered and its tooltip visible

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

将项目导入 Prism

Prism import menu open with options to import a .zip file or folder

Prism 支持三种项目导入方式：上传文件夹、上传 .zip 压缩包，或将文件拖放到所有项目视图中。


通过“导入”菜单导入项目：

  1. 打开 Prism，找到导入。

  2. 点击导入旁的箭头，选择导入类型。

选择以下选项之一：

  1. 打开 Prism，找到导入选项。

  2. 点击“导入”旁的箭头，选择导入类型。

  3. 选择以下选项之一：

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


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


通过拖放导入：在所有项目视图中，将项目文件夹或 .zip 文件拖放到 Prism 中。Prism 会自动为你创建新项目并导入文件。

上传完成后，Prism 会打开完整项目，你就可以开始编辑和编译了。

常见问题

账号、安全和账单

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

问：你们会使用我的数据进行训练吗？ 答：按照我们的隐私政策，用户可以完全自主决定是否允许我们使用其数据来改进模型。

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


问：你们是否提供不存储文本、也不进行人工审核的隐私模式，和/或仅限欧盟的数据驻留选项？ 答：这些功能已有用户提出需求，并已列入路线图或待开发列表，但目前尚未承诺具体时间表。

共享与协作

问：为什么我无法共享“任何人都可编辑”的链接？（下拉菜单中只有“任何人都可查看”。） 答：这是目前的设计。暂不支持通过链接让“任何人都可编辑”；必须将编辑者添加为协作者，而且对方需拥有 Prism 帐户。


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

项目导入与导出

问：上传或导入 ZIP 时一直停留在“正在导入您的项目”。该怎么办？答：请重新上传。如果重试后仍然卡住，请将 ZIP 文件提供给支持团队，以便调试导入流程。


问：如何将项目导出或下载为 ZIP？答：点击项目名称，然后选择“导出”，即可下载项目的压缩副本。导出前可能需要等待几秒钟，以便建立后端连接。

可靠性、服务中断与连接问题

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


问：刷新页面后我的项目消失了。项目丢失了吗？ 答：服务提供商中断时可能会出现这种情况。请重试，您的项目应该会重新出现。如果仍未出现，支持团队可以帮助恢复。


问：网站似乎已离线，或应用提示无法连接后端。该怎么办？ 答：请重试或重新加载。如果问题仍然存在，请将您看到的具体情况告知支持团队，并尽可能提供项目链接，以便调查。

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

问：我的文档卡住后，内容消失了，评论锚点也发生了移动。可以恢复吗？ 答：请先下载一份 .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 中，为什么 frame 内的 lstlisting/listings 环境会报错（例如“Extra }, or forgotten \endgroup”）？ 答：使用代码列表环境时，请将 Beamer 的 frame 标记为 [fragile]；这通常能解决此类错误。


问：我的 .bib 文件确实存在，也已添加参考文献命令，但 \cite 引用仍显示为“[?]”。怎样配置才能正常显示？ 一种经验证有效的解决方法是确保在主文档中正确引入参考文献；对于使用 BibTeX 的工作流程，请添加 \bibliographystyle{plain} 和 \bibliography{refs}（其中 refs.bib 是你的文件）。

产品界面和功能需求

问：Prism 是否提供浅色模式？答：是的。Prism 支持三种外观设置：跟随系统、浅色和深色。你可以选择最适合自己的主题。

这篇文章对你有帮助吗？