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

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

Learn how to troubleshoot Prism, resolve LaTeX compilation issues, import projects, and get support.

更新于：9 hours ago

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，并提供“保留”和“撤消”选项，方便您将其直接插入项目。

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

  3. 直接在编辑器中修复错误：错误和警告会以红色或黄色标记显示在编辑器页边。您可以让 Prism 修复特定错误；它会分析相关代码行、解释问题所在，并提出针对性的编辑建议。您可以直接应用建议并重新编译，以确认问题是否已修复。

  4. 校对：让 Prism 校对某个章节，指出错误或逻辑漏洞，并就如何提高该章节的清晰度提出建议。您可以利用“论文审阅”等技能，获取编辑和事实核查方面的反馈。

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

2. 诊断编译错误

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

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

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

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

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

3. 避免问题的最佳实践

  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. 点击导入旁边的 V 形箭头，选择导入类型。

选择以下选项之一：

  1. 打开 Prism，然后前往导入选项。

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

  3. 选择以下选项之一：

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


导入文件夹：从计算机中选择项目文件夹。Prism 会导入您的 .tex 文件、参考文献文件、图像及其他项目资源。


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

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

其他常见问题

帐户、安全与计费

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

问：你们会使用我的数据训练模型吗？ 答：根据我们的隐私政策，用户可以完全控制是否允许使用自己的数据来帮助改进我们的模型。


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


问：你们是否提供不存储文本、也不进行人工审查的隐私模式，以及仅限欧盟的数据驻留？ 答：这些是用户提出的功能需求，已列入产品路线图或待办事项，但目前尚无确定的时间表。

共享与协作

问：为什么我无法共享“任何人都可编辑”的链接？（下拉菜单中只有“任何人都可查看”。） 答：这是目前的设计。暂不支持通过链接让“任何人都可编辑”；必须将编辑者添加为协作者，而且对方需拥有 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 中，为什么 lstlisting/listings 环境位于 frame 内时会报错（例如“Extra }, or forgotten \endgroup”）？ 答：使用 listing 环境时，请将 Beamer frame 标记为 [fragile]；这样通常可以解决这些错误。


问：尽管 .bib 文件存在且已添加参考文献命令，我的 \cite 引用仍显示为“[?]”。哪种配置可正常使用？ 一种行之有效的解决方法是确保主文档正确包含参考文献；对于 BibTeX 风格的工作流，请添加 \bibliographystyle{plain} 和 \bibliography{refs}（其中 refs.bib 是您的文件）。

产品界面与功能请求

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

这篇文章对你有帮助吗？