用途:通过 olcli 命令行工具在本地管理 Overleaf 上的 LaTeX 项目,实现项目同步、编译与产物下载,适合需要本地编辑、版本操作或准备 arXiv 投稿的用户。
安装方式:Homebrew 推荐 brew tap aloth/tap && brew install olcli;或使用 npm install -g @aloth/olcli。
认证:登录 overleaf.com 后,在开发者工具的应用 Cookie 中复制 overleaf_session2 的值,执行 olcli auth --cookie "YOUR_SESSION_COOKIE"。可用 olcli whoami 验证,olcli check 排查认证问题,olcli logout 清除凭据。
主要能力:olcli list 列出项目,olcli info 查看项目详情;olcli pull 拉取到本地,olcli push 仅上传改动,olcli sync 双向同步;olcli compile 触发编译,olcli pdf 编译并下载 PDF(-o 可自定义文件名);olcli output bbl、olcli output aux 下载编译产物,olcli output --list 列出可用输出;olcli upload 上传单个文件,olcli download 下载单个文件,olcli zip 下载整个项目 zip。
常用流程:olcli pull "My Paper" 后进入目录编辑;编辑完成用 olcli push 或 olcli sync 同步;olcli pdf 获取 PDF;arXiv 投稿可执行 olcli output bbl -o main.bbl 后打包 .tex、.bbl 与图片。
使用限制与提示:需先完成会话 Cookie 认证;在含 .olcli.json 的同步目录中可自动识别项目,否则需指定项目名或项目 ID(URL 中 24 位十六进制)。olcli push --dry-run 可预览改动,olcli pull --force 可覆盖本地改动。其余未在资料中说明的功能、收费与平台情况暂未提供。