overleaf

Overleaf CLI 技能让研究人员、学生与学术工作者能直接从终端管理 LaTeX 项目。通过与 Overleaf 后端整合，它消除了为编译文档、上传图片或准备 arXiv 提交等常规任务手动操作网页界面的需求。此工具专为重视版本控制、本地开发环境整合与高效论文管理的工作流程所设计，是本地文件编辑与 Overleaf 云端生态系统之间的桥梁。

• 项目管理：通过 session cookie 安全验证，列出所有项目，并使用 olcli 工具获取项目元数据。

• 无缝同步：执行拉取、推送与完整双向同步操作，确保您的本地工作区与云端保持一致。

• 高级编译：触发 LaTeX 文件的远程编译，并下载产出的 PDF 或特定的构建产物，如 .bbl、.aux 与 .log 文件。

• 提交支持：通过程序化生成并下载 arXiv 提交平台所需的特定参考文献 (.bbl) 与辅助文件，简化提交流程。

• 资产处理：快速将图片、图表与其他资源上传至项目根目录或自动检测的目录。

• 项目自动化：支持通过 .olcli.json 文件进行项目自动检测，方便在不重复输入项目 ID 的情况下管理多篇论文。

• 前置需求：需要有效的 Overleaf 账号，并通过 Homebrew 或 npm 安装 olcli CLI 工具。

• 验证说明：使用标准 session cookie 安全管理凭证。用户应确保验证 Token 的机密性。

• 使用限制：此技能专用于 LaTeX 文档开发与管理；它不取代用于本地编译的完整 LaTeX 发行版（如 TeX Live），而是管理远程编译周期。

• 优化建议：用户可利用 --dry-run 标志进行预览，或使用 --force 进行强制覆盖，以防止同步操作期间发生意外的数据丢失。