SciPen Studio 使用指南

从安装到第一份 PDF

三步开始本地写作。需要配置 AI、Zotero 或 Overleaf 时,再按下面的指南逐项开启。

快速开始

  1. 安装 Studio 从官方 Releases下载对应平台的安装包。
  2. 打开项目目录 选择包含 .tex、.typ 或 .md 文件的本地目录。
  3. 编译并预览 打开 LaTeX 或 Typst 文件,点击编译或按 Ctrl + Enter(macOS 为 Cmd + Enter);PDF 会显示在右侧。

注编辑、编译和预览不要求先配置 AI 模型或连接 Overleaf。

从模板新建项目对话框:学术论文、IEEE 会议论文、学位论文、演示幻灯片四个模板,每个都标注可离线编译
也可以从模板新建项目。四个模板都标注了“可离线编译”。

编辑与编译

Monaco 编辑器为 LaTeX、Typst 与 Markdown 提供语法高亮与跳转;LaTeX 与 Typst 另有补全与诊断,Markdown 支持引用补全与实时预览。

LaTeX 源码与 PDF 双向定位

通过 SyncTeX 双向定位:Ctrl+点击源码跳到 PDF 对应位置,单击 PDF 跳回源码。Typst 暂不支持。

编译引擎

LaTeX 默认优先使用本机的 XeLaTeX、LuaLaTeX 或 Tectonic,没有时使用内置 BusyTeX;Typst 默认使用内置 Tinymist。可在 设置 → 编译 中切换。

注内置 LaTeX 引擎只预置了常用宏包。首次用到 ctex、xeCJK 或部分期刊文档类时,会联网下载所需文件并缓存在本机;需要完全离线编译时,请安装本机 TeX 发行版。

AI 助手与改写

Agent 可以读取项目内容、修改文件,并调用写作、审稿和调研 Skills。默认先展示修改建议,由你审阅后接受或拒绝;新文件也需要确认。

配置模型

在 设置 → AI 中填写服务地址、模型名称和自己的 API 密钥。支持 OpenAI 与 Anthropic 兼容接口;对话和补全共用服务与密钥,可以分别选择模型。

SciPen Studio 的 AI 设置页,展示模型服务、地址、模型名称与密钥配置项
在 AI 设置中连接你选择的模型服务;截图未填写个人密钥。

注文档在本地编辑;AI 请求会发送到你配置的模型服务。是否保存或使用请求数据,取决于该服务的政策和你的设置。

在编辑器里提出修改

  • 选中文字,按 Ctrl + K 输入要求;Tab 接受建议,Esc 取消。
  • Ctrl + L 打开选区操作,可用于翻译、解释和参考文献处理。
  • 在设置中启用后,可使用 Alt + D 从其他应用调用助手。
  • Agent 的 Diff Review 按整份提议接受或拒绝;开启自动批准后,部分确认步骤会被跳过。

已知问题0.5.1 的 Diff Review 新增区域仍显示原文;接受后写入的是 Agent 提出的新内容。演示录屏保留了这一版本行为。

联网搜索需要配置 Tavily API 密钥;抓取已知网页的 WebFetch 不需要 Tavily。模型生成的论述与引用仍需你核对。

文献、协作与历史

Zotero 文献引用

完整的桌面文献能力需要 Zotero 7 与 Better BibTeX。LaTeX 中输入 \cite{ 补全引用,悬停查看文献信息,按住 Ctrl 单击打开本地论文 PDF;Typst 与 Markdown 也可使用文献引用。

Zotero Web API 支持个人文献库以及 Typst、Markdown 引用。论文 PDF 由本地客户端提供。首次导出文献索引后,可能需要重新打开项目。

Overleaf 项目同步

登录后下载项目到本地,在 Studio 中编辑并本机编译。保存文件后推送修改;遇到冲突时,选择保留本地或线上版本。

注意重新下载项目会覆盖本地副本。请先保存或备份需要保留的修改。Studio 当前使用本机编译。

本地历史

编译、较大的 AI 修改、定时和手动操作可以创建历史快照。快照覆盖当前打开的文件,可用于查看和恢复先前内容。

常见问题

需要联网或配置 AI 密钥才能写论文吗?

本地编辑、编译和 PDF 预览都不需要提前配置 AI 密钥或连接 Overleaf。若 LaTeX 文档用到了内置引擎未预置的宏包,首次编译会联网下载并缓存到本机;安装本机 TeX 发行版后可完全离线编译。

可以使用自己的模型吗?本地文档会被上传吗?

可以在 设置 → AI 中填写自己的 API 密钥、模型名称和服务地址,兼容 OpenAI 与 Anthropic 接口。文档保留在本地硬盘编辑;只有主动触发 AI 功能时,请求会发送至你配置的服务。

哪些格式支持 SyncTeX 和 Zotero 引用补全?

LaTeX 支持 SyncTeX 源码与 PDF 双向定位,Typst 暂不支持。LaTeX 输入 \cite{ 补全文献需搭配桌面 Zotero 7 与 Better BibTeX;Typst 与 Markdown 的文献引用也可使用 Zotero Web API。

Overleaf 冲突与未签名安装包提示如何处理?

Overleaf 同步遇到冲突时,Studio 会提示你选择保留本地或线上版本;重新下载会覆盖本地副本,操作前需先备份。当前安装包尚未代码签名,macOS 可右键选择“打开”或清除 quarantine 属性,Windows 可在 SmartScreen 选择“更多信息 → 仍要运行”。

手册与反馈