ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OpenResearch接入Overleaf全解:浏览器Cookie导入与实时同步

OpenResearch接入Overleaf全解:浏览器Cookie导入与实时同步 OpenResearch接入Overleaf全解浏览器Cookie导入与实时同步【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearchOpenResearch 把编码 Agent 变成研究 Agent它的 Overleaf 接入功能可以让 Agent 写的 LaTeX 论文与你的 Overleaf 项目双向同步浏览器 Cookie 导入一次Overleaf 里协作者的每一次击键都能在本地工作区秒级落地本地的每次保存也会原路推回。这篇指南带你走完「Git Token → 链接项目 → Cookie 导入 → 实时同步」的完整流程并讲清冲突处理与常见问题。️ 先看懂OpenResearch 的 3 条 Overleaf 同步通道OpenResearch 为 Overleaf 准备了两条「同步」加一条「兜底」通道理解它们的分工是后续配置的基础通道凭据实时性携带内容Git 同步Overleaf Git 认证 Token按需推送/拉取论文全部文件.tex、.bib、图片等实时编辑器通道浏览器 Session Cookie击键级1 秒仅文本文档.tex/.bib/.cls/.sty/.bst上传兜底无需额外凭据一次性以全新项目形式上传论文副本三条通道的分工在源码中写得很清楚Git 桥接负责真正的推送实时通道走 Overleaf 编辑器自己的 socket.io 协议上传页则服务所有账号包括没有付费 Git 集成的用户实现见 src/local/overleaf.rs 与 src/local/overleaf_live.rs。 第一步保存 Overleaf Git 认证 TokenGit 同步是每篇已链接论文的底座所有账号都能配置但Git 集成本身是 Overleaf 付费计划的功能。在 Overleaf 的「账户设置 → Git」中生成一个 Git 认证 Token在 OpenResearch 的设置页Overleaf 一栏或论文标签页的同步面板中粘贴 Token点击Save tokenToken 只保存在本机配置中不会上传到任何第三方。面板文案会明确提示Create one in Overleaf under Account Settings — Git integration comes with a paid Overleaf plan见 ui/src/components/OverleafPanel.tsx。没有付费计划没关系面板里的Upload a copy as a new project链接可以把整篇论文含图表以 base64 内联方式 POST 到 Overleaf自动创建新项目任何账号可用。 第二步把论文链接到 Overleaf 项目Overleaf 的 Git 桥接不能替你创建项目所以流程是先在 Overleaf 里打开或新建目标项目把地址栏 URL 复制下来粘贴到 OpenResearch 的同步面板点击Link and sync。粘贴内容很宽容——浏览器地址栏 URL、git clone 地址、甚至裸项目 ID 都能被正确解析解析逻辑见 src/local/overleaf.rs。链接成功后首次同步会自动执行智能收集论文文件从主.tex出发顺着\includegraphics、\input、\bibliography等引用递归收集被注释掉的引用不会误发越界路径会被拒收collect 函数双向对齐只改了本地的文件推上去只改了 Overleaf 的文件拉下来两边都改过的文件绝不自动裁决主文档提醒若 Overleaf 项目里还有别的根级.tex会持续提示你去 Overleaf 把正确的那个设为主文档。 第三步从浏览器导入 Session Cookie关键一步想让同步从按次拉取升级为随人打字实时跟随还需要 Overleaf 编辑器的 Session Cookieoverleaf_session2。Cookie 是 HttpOnly 的页面 JS 拿不到所以 OpenResearch 直接从本机浏览器的 Cookie 存储里读——这就是浏览器 Cookie 导入支持Chrome、Edge、Brave、Arc、Vivaldi、Chromium、Firefox自动遍历各浏览器各配置文件优先选未过期的overleaf_session2Cookie 名清单见 src/local/browser_cookies.rs对 Chromium 系浏览器Cookie 值用 Keychain 里的密钥解密首次导入时系统会弹一次钥匙串授权提示点允许即可导入仅支持 macOS其他系统可用Paste it instead手动粘贴在已登录 Overleaf 的浏览器中打开开发者工具找到overleaf_session2Cookie 复制其值SessionForm 组件Cookie 与 Git Token 一样只保存在本机并绑定到对应主机跨主机的请求拿不到它。⚡ 实时同步是如何工作的Cookie 保存后一旦某次 Git 同步让两端达成一致实时通道自动打开状态灯变绿提示Edits are live on Overleaf下行OpenResearch 以你浏览器会话的身份连上 Overleaf 的 socket.io 通道协作者的每次插入/删除以操作变换OT增量流过来零点几秒内写进本地工作区编辑器标签页自动刷新除非你正在编辑该文件——此时它会标记磁盘已更新由你确认而不是悄悄覆盖草稿上行本地保存的.tex/.bib等文本文件被 diff 成同一个 OT 操作发回去Overleaf 侧即时可见图片不走实时通道图表等二进制文件仍由较慢的 Git 同步搬运——实时通道在线时每 5 分钟跑一次离线时每 30 秒轮询一次远端 HEAD 有变化才克隆对比useOverleafSync.ts断线自愈心跳丢失自动重连、限流自动退避 15 秒、Cookie 失效则停止重试并提示你换一个新的。这套协议跟随 Overleaf 开源实现的real-time服务与 sharejs 文本类型实现细节在 src/local/overleaf_live.rs。⚠️ 冲突与常见问题速查现象原因与处理面板列出某个文件changed here and on Overleaf双向都改了同一文件。两份副本都原样保留点Keep this copy或Use Overleafs二选一裁决只在下一轮同步生效按钮提示Save this file to sync it编辑器里还有未保存的修改先保存再同步Git 同步报 403 / premium账号没有付费 Git 集成——改用上传为新项目兜底或升级 Overleaf 计划实时通道refused as unauthorizedCookie 过期你在浏览器里重新登录了。点Import from browser重新导入即可推送失败但本地文件没变这是特性推送没被 Overleaf 接受前绝不先改本地文件避免半同步状态Overleaf 里删了某文件删除不反向传播——本地文件保留并给出提示需要你手动删stage 阶段说明同步结果面板会用人话汇报Pulled xxx; pushed yyy失败原因401 Token 失效 / 404 项目不存在 / 403 无 Git 权限也会被翻译成对应建议分类逻辑见 src/local/overleaf.rs。 相关源码与文档索引模块路径Git 桥接同步收集/推送/冲突裁决src/local/overleaf.rs实时编辑器通道socket.io OTsrc/local/overleaf_live.rs浏览器 Cookie 导入macOSsrc/local/browser_cookies.rs前端同步状态与轮询策略ui/src/useOverleafSync.ts同步面板 UIToken/URL/Cookie 表单ui/src/components/OverleafPanel.tsx设置页 Overleaf 配置区ui/src/components/SettingsPage.tsx需要从零开始执行git clone https://gitcode.com/GitHub_Trending/op/OpenResearch获取仓库后按 README.md 安装 orx CLI即可在你自己的研究项目上体验Agent 写论文、Overleaf 看排版的双向实时工作流。【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表