什么是Overleaf
Overleaf Skill 是一个专为 LaTeX 开发者设计的命令行工具，旨在通过 `olcli` 命令行接口实现对 Overleaf 在线协作平台的深度集成管理。它允许用户在不依赖浏览器界面的情况下，高效地同步、编译和管理 Overleaf 上的 LaTeX 项目。该工具特别适合需要频繁在本地与云端之间切换工作的研究人员和学术作者，尤其是那些习惯使用终端进行开发流程的用户。借助 Overleaf Skill，用户可以在本地编辑器中编写和修改文档，然后通过简单的命令将更改推送回 Overleaf，实现无缝的跨平台协作。此外，它还支持一键编译并下载 PDF 输出，极大简化了论文撰写与提交过程中的技术操作。 该工具的核心优势在于其对 Overleaf 平台功能的完整覆盖，包括项目的拉取（pull）、推送（push）、双向同步（sync）以及编译后文件的下载。特别值得一提的是，对于 arXiv 等学术投稿平台，许多期刊要求提交编译后的 `.bbl` 文件而非原始 `.bib` 文件，而 Overleaf Skill 提供了直接下载 `.bbl` 的功能，避免了手动从日志中提取的繁琐步骤。同时，用户还可以上传图片或辅助文件，或将整个项目打包为 ZIP 格式用于归档或提交。所有操作均可通过命令行完成，配合脚本自动化，可显著提升科研写作的工作效率。 Overleaf Skill 的安装方式灵活，既可通过 Homebrew 一键安装（推荐），也支持 npm 全局安装。认证过程仅需获取登录 Overleaf 后的会话 Cookie，即可安全授权访问个人账户下的项目。一旦配置完成，用户便可在任何包含 `.olcli.json` 的项目目录中省略项目名称参数，享受更流畅的操作体验。无论是日常编辑、批量处理多个项目，还是准备 arXiv 投稿材料，Overleaf Skill 都提供了一套轻量但强大的命令行解决方案，让 LaTeX 写作回归到开发者熟悉的终端环境。
核心功能特点
- 支持通过命令行拉取、推送和双向同步 Overleaf 上的 LaTeX 项目
- 一键编译并下载生成的 PDF 文件，无需打开浏览器
- 可直接下载 arXiv 投稿所需的 .bbl 等编译输出文件
- 支持上传本地图片或 PDF 资源到指定 Overleaf 项目
- 提供项目列表查看、信息查询及 ZIP 打包下载功能
- 兼容 Homebrew 和 npm 安装，支持本地目录自动识别项目
适用场景
Overleaf Skill 最典型的应用场景是学术研究者的论文撰写与投稿流程。许多学者习惯在本地使用 Vim、VS Code 或 TeXstudio 等编辑器编写复杂的 LaTeX 文档，同时希望利用 Overleaf 的实时协作和云编译能力。通过 Overleaf Skill，他们可以将项目从 Overleaf 拉取到本地进行精细调整，修改完成后只需运行 `olcli push` 即可将变更同步回云端，实现“本地编辑+云端预览”的高效工作流。这种模式尤其适合需要反复迭代、多人协作的大型论文项目。 另一个高频使用场景是为 arXiv 或其他预印本平台准备投稿包。arXiv 明确要求提交已编译的 `.bbl` 文件（参考文献条目），但 Overleaf 默认不提供此文件下载链接。借助 `olcli output bbl` 命令，用户可在本地编译后直接获取该文件，再结合其他必要文件（如 `.tex`、图表）打包成 ZIP 提交，整个过程完全自动化，避免了手动查找和整理文件的麻烦。对于定期发表论文的研究团队而言，这能大幅缩短投稿准备时间。 此外，Overleaf Skill 也适用于教学场景。教师可以指导学生使用命令行工具管理课程作业中的 LaTeX 报告，培养其 DevOps 式的文档管理能力；或者用于自动化 CI/CD 流程，例如在 GitHub Actions 中触发 Overleaf 项目编译并生成 PDF 输出，实现文档的版本控制与持续交付。由于其轻量级设计和清晰的命令结构，它也适合集成到个人知识管理系统中，作为统一工具链的一部分。