（1841期）Overleaf – CLI 云端 LaTeX 协作管理器

CLI 云端 LaTeX 协作管理器 通过浏览器 Cookie 认证，CLI 管理 Overleaf 项目，支持 LaTeX 文件读写、同步与协作邀请处理 使用说明 核心用法 pyoverleaf 是一款基于浏览器 Cookie 认证的命令行工具，允许用户直接在终端与 Overleaf 云端 LaTeX 项目交互。其工作流程分为三步：用户在 Chrome/Firefox 登录 Overleaf → 首次运行时授权钥匙串访问 → 通过 CLI 或 Python API 执行文件操作。主要功能包括： 项目浏览：pyoverleaf ls 列出所有可访问项目 文件读写：read/write 直接操作 .tex 文件，download-project 批量打包下载 目录管理：mkdir/rm 维护项目结构 邀请处理：Python API 可程序化接受项目协作邀请，无需手动点击邮件链接 私有化部署：通过 PYOVERLEAF_HOST 环境变量支持自托管 Overleaf 实例 显著优点 无缝集成本地工作流：直接将本地编辑的 LaTeX 文件推送至云端，保留 Overleaf 的版本历史，便于追溯和回滚 免密码认证：复用浏览器登录状态，无需配置 API token 或管理额外凭证 程序化协作：自动处理项目邀请，适合团队批量管理多个协作项目 代码可审计：v0.1.7 版本经安全审计，代码库精简透明，用户可自行审查 潜在局限与风险 平台依赖：仅支持 Chrome/Firefox 的 Cookie 存储，Safari 或 headless 环境需额外配置 钥匙串权限争议：macOS 需授予"始终允许"钥匙串访问，涉及浏览器 Cookie 的敏感读取权限 CLI 写入稳定性：write 命令存在 WebSocket 重定向 bug，生产环境建议使用 Python API 直接覆盖 权限边界模糊：工具获得的是用户完整的浏览器 Cookie 上下文，理论上可访问同浏览器会话中的其他服务 版本锁定风险：审计仅覆盖 v0.1.7，后续版本需用户自行验证 适合人群 学术研究者：需要在本地 IDE 与 Overleaf 间频繁同步 LaTeX 手稿 技术文档团队：管理多个协作项目，批量处理成员邀请 DevOps 工程师：将 Overleaf 集成至 CI/CD 流程，自动化文档构建与发布 常规风险 | 风险类型 | 说明 | 缓释措施 ||---------|------|---------|| 凭证泄露 | Cookie 被盗用可导致 Overleaf 账户完全失控 | 仅在受信任设备使用，避免共享浏览器配置文件 || 数据丢失 | write 直接覆盖云端文件，无本地确认环节 | 优先使用 API 上传以保留历史版本，操作前执行 download-project 备份 || 供应链攻击 | pipx 安装的包可能被篡改 | 校验 GitHub 源码哈希，审计后锁定版本 || 隐私泄露 | 钥匙串访问可能暴露其他站点 Cookie | 使用专用浏览器配置文件隔离 Overleaf 会话 | 原始说明 Access Overleaf projects via CLI. Use for reading/writing LaTeX files, syncing local .tex files to Overleaf, downloading projects, managing Overleaf project...