核心用法
pyoverleaf 是一款基于浏览器 Cookie 认证的命令行工具，用于与 Overleaf 云 LaTeX 平台交互。主要功能包括：
- 项目浏览：
pyoverleaf ls列出所有项目或项目内文件结构 - 文件读写：
pyoverleaf read获取远程文件内容，pyoverleaf write通过 stdin 上传本地修改 - 批量同步：
pyoverleaf download-project打包下载整个项目，支持本地 diff 比对后再决策合并方向 - 目录管理：
mkdir/rm维护项目结构 - Python API：提供更稳定的文件上传能力，保留 Overleaf 完整版本历史
显著优点
1. 零配置认证：复用浏览器登录态，无需管理 API 密钥或密码
2. 版本历史完整：通过 Python API 直接覆盖文件时，Overleaf 原生历史功能可追溯所有变更
3. 自托管支持：通过环境变量或 flag 可切换至企业私有 Overleaf 实例
4. 审计友好：代码库小巧（v0.1.7 已人工审计），功能边界清晰
潜在局限
- macOS 密钥链依赖：首次运行需用户手动批准"始终允许"访问浏览器 Cookie 存储，Agent 无法自动完成
- WebSocket 稳定性：CLI
write命令存在 301 重定向导致的 WebSocket 故障，生产环境建议改用 Python API - 单向推送受限：根据 Eason 工作流，Agent 禁止自行推送，必须经用户明确逐次授权
- 浏览器锁定：仅支持 Chrome/Firefox，需保持登录态；Cookie 过期需用户重新登录
适合人群
- 学术写作者：需频繁在本地编辑器与 Overleaf 间同步 LaTeX 源文件
- 团队协作：通过版本历史审查 Agent 修改，保留人工决策合并权
- 企业用户：自托管 Overleaf 实例的 DevOps 自动化场景
常规风险
- 凭证泄露：工具需读取浏览器敏感 Cookie，虽经审计但仍属高权限操作
- 误覆盖风险：
write直接覆盖远端文件，Python API 虽保留历史但错误操作仍可造成工作丢失 - 网络中间人：Cookie 传输若被截获可能导致 Overleaf 账户劫持（依赖 HTTPS 与主机安全）
安全建议：严格遵循"拉取→比对→询问→推送"四步流程，禁止自动化批量推送。