文档中心

快速上手 SciPen Studio,掌握所有功能

快速入门

三步开始您的 LaTeX 写作之旅

1

安装 SciPen Studio

从官网下载适合您操作系统的安装包,双击安装即可。

# Windows
下载 .exe 安装包并运行
# macOS
下载 .dmg 文件并拖动到 Applications
# Linux
chmod +x SciPen-Studio.AppImage && ./SciPen-Studio.AppImage
2

创建或打开项目

启动 SciPen Studio,选择创建新项目或打开现有的 LaTeX 项目文件夹。

  • 支持本地项目文件夹
  • 支持 Overleaf 项目同步
  • 自动识别主文件(main.tex)
3

开始写作

使用智能编辑器开始写作,享受 AI 辅助和实时预览功能。

💡 智能补全
输入 \\ 触发命令补全
🤖 AI 助手
Ctrl+K 唤起 AI 对话

使用指南

深入了解 SciPen Studio 的各项功能

📝

智能编辑器

  • Monaco Editor - VS Code 同款编辑器
  • TexLab LSP - 2000+ 命令智能补全
  • 双层补全系统 - LSP + AI Ghost Text
  • 实时语法诊断与错误提示
  • 公式预览 (KaTeX 渲染)
  • 跳转到定义、查找引用
🤖

AI 辅助写作

  • 智能润色 - 学术化改写、降重、精简
  • 公式生成 - 自然语言转 LaTeX
  • AI 审稿 - 模拟 Reviewer #2
  • 文档对话 - 基于知识库的智能问答
  • 流式输出 - 实时显示生成内容
  • 多模型支持 - OpenAI/Claude/DeepSeek
📚

多模态知识库

  • 多格式支持 - PDF/Word/图片/音频
  • 混合检索 - 向量相似度 + BM25
  • 查询重写与结果重排序
  • 引用感知 - 自动标注文献来源
  • 图片 OCR - VLM 视觉理解
  • 音频转写 - Whisper API
⚙️

编译与预览

  • 多引擎支持 - Tectonic/XeLaTeX/LuaLaTeX
  • Overleaf 协作 - 双向同步
  • SyncTeX 双向跳转 - 源码↔PDF
  • 实时 PDF 预览 (PDF.js)
  • 错误诊断与定位
  • 编译日志详细输出
🔧

配置与设置

  • LLM 模型配置 - 多提供商支持
  • 嵌入模型配置 - 向量生成
  • VLM 配置 - 图片理解
  • Whisper 配置 - 语音转录
  • 快捷键自定义
  • 主题与 UI 设置
🚀

CLI 工具集

  • scipen-pdf2tex - PDF 转 LaTeX
  • scipen-paper2beamer - 论文转演示
  • scipen-reviewer - AI 论文审稿
  • 批量处理支持
  • 自定义 Agent 工作流
  • 共享配置文件

常见问题

快速找到您需要的答案

💡 如何配置 AI 模型?

在设置中选择"LLM 配置"标签页,配置您的 API 密钥和模型选择:

  • OpenAI - 支持 GPT-4、GPT-3.5 等模型
  • Anthropic - 支持 Claude 3.5 Sonnet 等
  • DeepSeek - 国内高性价比选择
  • Ollama - 本地运行开源模型

🔧 编译失败怎么办?

检查编译日志中的错误信息,常见问题及解决方案:

  • 缺少宏包 - 使用 Tectonic 引擎自动下载
  • 语法错误 - 查看诊断面板的错误提示
  • 编码问题 - 确保文件使用 UTF-8 编码
  • 中文支持 - 使用 XeLaTeX 或添加 ctex 宏包

☁️ 如何同步 Overleaf 项目?

在编译器设置中启用 Overleaf 集成,输入项目 ID 和访问令牌即可实现双向同步。支持实时文件同步和远程编译功能。

📁 知识库支持哪些文件格式?

支持多种文档格式的智能处理和检索:

  • 文档类 - PDF、Word (.docx)、Markdown、纯文本
  • 图片类 - PNG、JPG、JPEG,支持 OCR 和 VLM 视觉理解
  • 音频类 - MP3、WAV、M4A,通过 Whisper API 自动转写
  • 检索技术 - 混合检索(向量相似度 + BM25)+ 查询重写 + 结果重排序
  • 引用感知 - 自动标注文献来源,支持引用追溯

🔒 数据安全吗?

SciPen Studio 采用本地优先的安全架构:

  • 本地存储 - 所有文档、项目文件、知识库数据完全存储在本地
  • API 调用 - AI 功能仅在需要时调用外部 API,只发送必要的上下文片段
  • 无数据留存 - API 提供商不会存储您的数据(遵循各提供商隐私政策)
  • 本地模型支持 - 可使用 Ollama 运行本地开源模型,完全离线工作
  • 开源透明 - MIT 协议开源,代码完全可审计

API 文档

为开发者提供的扩展接口

📦 CLI 工具集

SciPen Studio 提供强大的命令行工具,支持批量处理和自动化工作流。

🔄 scipen-pdf2tex - PDF 转 LaTeX

将 PDF 文档转换为可编辑的 LaTeX 源码,支持公式识别和表格提取。

# 基本用法
$ scipen-pdf2tex input.pdf output.tex
# 指定页面范围
$ scipen-pdf2tex paper.pdf result.tex --pages 1-5
# 批量转换
$ scipen-pdf2tex *.pdf --output-dir ./latex_files

📊 scipen-paper2beamer - 论文转演示

自动将学术论文转换为 Beamer 演示文稿,智能提取关键内容。

# 从 PDF 生成演示
$ scipen-paper2beamer paper.pdf slides.tex
# 从 LaTeX 源码生成
$ scipen-paper2beamer paper.tex slides.tex --theme metropolis
# 自定义幻灯片数量
$ scipen-paper2beamer paper.pdf slides.tex --max-slides 20

🔍 scipen-reviewer - AI 论文审稿

模拟 Reviewer #2 进行严格审稿,提供详细的改进建议和评分。

# 审稿论文并生成报告
$ scipen-reviewer paper.tex --output review.md
# 指定审稿严格程度
$ scipen-reviewer paper.pdf --strictness high --output report.md
# 使用特定领域模板
$ scipen-reviewer paper.tex --domain "computer science" --format json

🔌 插件开发

SciPen Studio 支持通过插件扩展功能。插件可以访问编辑器 API、文件系统、AI 服务等核心功能。

// 插件基本结构
export default {
name: 'my-plugin',
version: '1.0.0',
activate(context) {
// 注册命令
context.registerCommand('myCommand', handler);
// 访问编辑器 API
context.editor.onDidChangeContent(callback);
}
}

插件可以扩展编辑器功能、添加自定义 AI Agent、集成外部工具等。详细文档请参考 GitHub 仓库。