Overleaf 技能

通过 olcli 命令行工具管理 Overleaf LaTeX 项目。

安装

# Homebrew（推荐）
brew tap aloth/tap && brew install olcli

# npm
npm install -g @aloth/olcli

身份验证

从 Overleaf 获取您的会话 Cookie：

1. 登录 overleaf.com
2. 打开开发者工具（F12）→ Application（应用程序）→ Cookies（Cookie）
3. 复制 overleaf_session2 的值

olcli auth --cookie "YOUR_SESSION_COOKIE"

使用以下命令验证身份验证是否成功：

olcli whoami

排查身份验证问题：

olcli check

清除已保存的凭据：

olcli logout

常用工作流

将项目拉取至本地进行编辑

olcli pull "My Paper"
cd My_Paper/

编辑并同步更改

# 在本地编辑文件后
olcli push              # 仅上传更改
olcli sync              # 双向同步（先拉取再上传）

编译并下载 PDF

olcli pdf                      # 编译并下载 PDF
olcli pdf -o paper.pdf         # 自定义输出文件名
olcli compile                  # 仅触发编译（不下载）

下载 .bbl 文件以用于 arXiv 投稿

olcli output bbl               # 下载编译生成的 .bbl 文件
olcli output bbl -o main.bbl   # 自定义输出文件名
olcli output --list            # 列出所有可用的编译输出类型

上传图表或资源文件

olcli upload figure1.png "My Paper"          # 上传至项目根目录
olcli upload diagram.pdf                       # 自动根据 .olcli.json 检测所属项目

下载指定文件

olcli download main.tex "My Paper"           # 下载单个文件
olcli zip "My Paper"                          # 将整个项目打包为 zip 下载

arXiv 投稿工作流

准备 arXiv 投稿的完整流程：

# 1. 拉取您的项目
olcli pull "Research Paper"
cd Research_Paper

# 2. 执行编译，确保所有内容可正常构建
olcli compile

# 3. 下载 .bbl 文件（arXiv 要求提交 .bbl，而非 .bib）
olcli output bbl -o main.bbl

# 4. 下载其他所需输出文件（如需要）
olcli output aux -o main.aux    # 如需辅助文件

# 5. 打包用于投稿
zip arxiv.zip *.tex main.bbl figures/*.pdf

# 6. 本地验证该压缩包是否可成功编译（可选）
# 然后将 arxiv.zip 上传至 arxiv.org

命令参考

提示

• 自动识别项目：在已同步的目录中（含 .olcli.json）执行命令，可省略 [project] 参数
• 模拟运行：使用 olcli push --dry-run 预览上传前的变更内容
• 强制覆盖：使用 olcli pull --force 强制覆盖本地修改
• 项目 ID：可使用项目 ID 替代项目名称（URL 中的 24 位十六进制字符串）
• 调试身份验证：运行 olcli check 查看凭据加载来源