1. 为什么要在 Cursor 里连 Overleaf如果你平时写论文、课程报告或者技术文档Overleaf 的网页编辑器确实省心不用配 TeX Live编译环境现成合作者点开链接就能改。但网页端写长文档有个绕不开的痛点——补全弱、跳转慢、多文件重构费劲尤其是\cite{}、\ref{}这种交叉引用网页端基本靠人肉记忆。Cursor 恰好补上这块。它本质是 VS Code 的深度定制版LaTeX Workshop 那套编译、预览、跳转能力它都有再加上 AI 补全和对话写.tex的体验会顺很多。问题在于怎么让本地 Cursor 和 Overleaf 网页端接上Overleaf Workshop 这个插件就是干这个的它通过 Overleaf 的会话凭证把网页端的项目同步到本地你在 Cursor 里改完保存网页端也能看到编译结果。这篇聚焦一个具体卡点overleaf_session2这个 Cookie 怎么拿、怎么填、怎么验证连接成功。顺带把 TaoToken 的统一 Key/API 通道接进来让 Cursor 里的 AI 能力也能用同一套凭证走通。适合已经会用 Overleaf、想在本地提效的 LaTeX 写作者。先说清楚overleaf_session2等同于你的登录态泄露出去别人就能操作你的项目。下面所有操作都在你自己的机器和浏览器里完成别把这段字符串贴到公开群聊或截图里。2. 前置准备Overleaf Workshop 与 TaoToken 通道2.1 装好 Overleaf Workshop 插件打开 Cursor进扩展面板CtrlShiftX搜Overleaf Workshop。这个插件的作用是读取你配置的 Overleaf 会话信息把远程项目拉到本地工作区并在保存时推回网页端。装完后你会看到插件设置里有几个关键字段overleaf_session2或叫 Cookie、project_id、以及可选的服务器地址。默认走https://www.overleaf.com如果你用的是自建实例再改。2.2 为什么还要接 TaoTokenCursor 自带的 AI 能力在写 LaTeX 时很有用让它帮你补一段algorithm2e环境、解释一个编译报错、或者把中文草稿转成规范的\section结构。但如果你同时用多个模型、多个工具Key 管理会很乱。TaoToken 提供统一 Key 和 API 通道把模型调用收敛到一个入口。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你可以在 Cursor 的模型配置里把 base URL 指向它用同一个 Key 调不同模型省得每个工具单独配一遍。这一步不是必须的但如果你打算长期在 Cursor 里写 LaTeX 并频繁用 AI统一通道会省事很多。下面会给可复制的配置骨架。3. 可复制配置settings.json 骨架与 Cookie 获取3.1 最快拿到 overleaf_session2 的方法网上很多教程让你去 Network 面板搜/project但 Overleaf 现在页面动态加载请求列表里全是.pdf、.js翻半天找不到主请求。更稳的路径是直接看浏览器存储打开浏览器登录 Overleaf进入任意一个项目页面。按F12打开开发者工具切到Application应用面板——如果标签栏太窄看不到点展开。左侧找到Storage→Cookies→https://www.overleaf.com。右侧列表里找Name为overleaf_session2的那一行双击Value复制。它通常以s%3A开头后面是一长串随机字符。同时把project_id也记下来看你项目页 URLoverleaf.com/project/后面那串就是比如64axxxx...。注意overleaf_session2会过期。如果你在浏览器里点了 Log Out或者 Cookie 自然到期Cursor 这边就会同步失败。重新按上面步骤取一次即可不用重装插件。3.2 settings.json 骨架Cursor 的用户设置文件在~/.cursor/下Windows 在%APPDATA%\Cursor\User\。你可以直接编辑settings.json把 Overleaf Workshop 和模型通道一起配好。下面是一个可复制的骨架字段名以你装的插件版本为准核心是这几项{ overleaf-workshop.cookie: s%3A你的overleaf_session2值, overleaf-workshop.projectId: 你的project_id, overleaf-workshop.serverUrl: https://www.overleaf.com, overleaf-workshop.autoSync: true, cursor.ai.baseUrl: https://taotoken.net/api, cursor.ai.apiKey: 你的TaoToken统一Key }几个点说明一下。cookie字段直接填刚才复制的整串包括s%3A前缀不要手动解码。autoSync打开后本地保存会自动推送到网页端但首次连接建议先关掉手动验证一次同步方向对不对避免本地空文件覆盖远程内容。cursor.ai.baseUrl和apiKey是给 Cursor 内 AI 用的指向 TaoToken 的 API 端点。Key 在控制台生成地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 具体路径在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。提示如果你不想把 Key 明文写在 settings.json 里可以用环境变量Cursor 支持在配置里引用${env:TAOTOKEN_KEY}这种写法。团队协作时尤其注意别把带 Key 的配置文件提交到 Git。4. 验证连接从拉取项目到编译成功4.1 拉取远程项目配置保存后重启 Cursor。打开命令面板CtrlShiftP输入Overleaf Workshop: Download Project选择你配好的项目。插件会用overleaf_session2去请求 Overleaf把项目文件拉到本地工作区。如果成功你会在文件树里看到.tex、.bib、图片等文件。这时候先别急着改打开主.tex文件确认内容完整——有时候网络抖动会导致部分文件没拉全重新执行一次下载即可。4.2 本地编译验证LaTeX Workshop 插件负责编译。确认你本地装了 TeX Live 或 MiKTeX然后在 Cursor 里打开.tex文件按CtrlAltB触发编译。看输出面板有没有报错正常的话会生成 PDF右侧预览窗口能直接看。这一步的意义是确认本地工具链没问题。如果本地编译都过不了同步到网页端也会失败先解决本地环境。4.3 同步回网页端本地改一处内容比如在\section里加一句话保存。如果autoSync开着插件会推送到 Overleaf。回到浏览器刷新项目页看改动是否出现。反过来在网页端改一处本地执行Overleaf Workshop: Sync Project看本地是否更新。双向都通了说明overleaf_session2有效、project_id正确、同步方向没搞反。4.4 用 TaoToken 通道验证 AI 调用在 Cursor 里打开 AI 对话问一个 LaTeX 相关问题比如帮我把这段伪代码转成 algorithm2e 环境。如果配置正确请求会走 TaoToken 的 API 端点返回结果。你也可以在模型对话页面直接测试通道是否通 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果 AI 没响应先检查baseUrl有没有写错、Key 有没有过期。TaoToken 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例对照排查。5. 本篇常见错排查5.1 同步失败提示未授权最常见的原因是overleaf_session2过期。去浏览器重新取一次替换 settings.json 里的值重启 Cursor。注意复制时别漏字符整串包括s%3A都要。另一个可能是project_id填错。回项目页 URL 核对一遍别把用户名或其他路径段当成 ID。5.2 本地文件被清空或覆盖这通常是首次连接时autoSync开着本地空工作区把远程覆盖了。Overleaf 有历史版本去网页端History里恢复。预防办法首次连接先关autoSync手动下载确认文件完整后再开。5.3 编译报错但网页端正常本地 TeX 环境和 Overleaf 的不完全一致。Overleaf 用的是 TeX Live 特定版本加一堆宏包你本地可能缺包。看报错信息缺哪个.sty用tlmgr install补上。如果宏包版本冲突考虑用latexmk配合项目里的.latexmkrc统一编译流程。5.4 AI 请求超时或 401先确认baseUrl是https://taotoken.net/api别多加斜杠或路径。401 一般是 Key 无效去控制台重新生成。超时可能是网络问题换个时间段试。如果长期编码或跑 Agent 任务可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合高频调用场景。5.5 Cookie 里有特殊字符导致 JSON 解析失败overleaf_session2的值里可能有%、:等字符直接塞进 JSON 字符串一般没问题但如果你的编辑器自动转义了就会出错。确保值是原样字符串不要手动 URL 解码。如果实在拿不准用环境变量传避开 JSON 转义问题。6. 把这条链路用顺整套流程跑通后你的工作流会变成在 Cursor 里写 LaTeX本地编译即时看效果AI 帮你补环境、查报错、转格式保存后自动同步到 Overleaf合作者或导师在网页端直接看最新版。overleaf_session2是这条链路的钥匙过期了就重取不复杂。如果你还想在本地跑更重的编码任务比如批量处理参考文献、自动生成图表代码可以了解下 Coding Plan 的额度方案 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有需要可以对照配置。最后提醒一句overleaf_session2别外传settings.json 别提交到公开仓库。把这两件事守住剩下的就是安心写论文了。 【工具记录】Cursor + Overleaf：用 overleaf_session2 打通本地编辑与网页端远程连接
1. 为什么要在 Cursor 里连 Overleaf如果你平时写论文、课程报告或者技术文档Overleaf 的网页编辑器确实省心不用配 TeX Live编译环境现成合作者点开链接就能改。但网页端写长文档有个绕不开的痛点——补全弱、跳转慢、多文件重构费劲尤其是\cite{}、\ref{}这种交叉引用网页端基本靠人肉记忆。Cursor 恰好补上这块。它本质是 VS Code 的深度定制版LaTeX Workshop 那套编译、预览、跳转能力它都有再加上 AI 补全和对话写.tex的体验会顺很多。问题在于怎么让本地 Cursor 和 Overleaf 网页端接上Overleaf Workshop 这个插件就是干这个的它通过 Overleaf 的会话凭证把网页端的项目同步到本地你在 Cursor 里改完保存网页端也能看到编译结果。这篇聚焦一个具体卡点overleaf_session2这个 Cookie 怎么拿、怎么填、怎么验证连接成功。顺带把 TaoToken 的统一 Key/API 通道接进来让 Cursor 里的 AI 能力也能用同一套凭证走通。适合已经会用 Overleaf、想在本地提效的 LaTeX 写作者。先说清楚overleaf_session2等同于你的登录态泄露出去别人就能操作你的项目。下面所有操作都在你自己的机器和浏览器里完成别把这段字符串贴到公开群聊或截图里。2. 前置准备Overleaf Workshop 与 TaoToken 通道2.1 装好 Overleaf Workshop 插件打开 Cursor进扩展面板CtrlShiftX搜Overleaf Workshop。这个插件的作用是读取你配置的 Overleaf 会话信息把远程项目拉到本地工作区并在保存时推回网页端。装完后你会看到插件设置里有几个关键字段overleaf_session2或叫 Cookie、project_id、以及可选的服务器地址。默认走https://www.overleaf.com如果你用的是自建实例再改。2.2 为什么还要接 TaoTokenCursor 自带的 AI 能力在写 LaTeX 时很有用让它帮你补一段algorithm2e环境、解释一个编译报错、或者把中文草稿转成规范的\section结构。但如果你同时用多个模型、多个工具Key 管理会很乱。TaoToken 提供统一 Key 和 API 通道把模型调用收敛到一个入口。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你可以在 Cursor 的模型配置里把 base URL 指向它用同一个 Key 调不同模型省得每个工具单独配一遍。这一步不是必须的但如果你打算长期在 Cursor 里写 LaTeX 并频繁用 AI统一通道会省事很多。下面会给可复制的配置骨架。3. 可复制配置settings.json 骨架与 Cookie 获取3.1 最快拿到 overleaf_session2 的方法网上很多教程让你去 Network 面板搜/project但 Overleaf 现在页面动态加载请求列表里全是.pdf、.js翻半天找不到主请求。更稳的路径是直接看浏览器存储打开浏览器登录 Overleaf进入任意一个项目页面。按F12打开开发者工具切到Application应用面板——如果标签栏太窄看不到点展开。左侧找到Storage→Cookies→https://www.overleaf.com。右侧列表里找Name为overleaf_session2的那一行双击Value复制。它通常以s%3A开头后面是一长串随机字符。同时把project_id也记下来看你项目页 URLoverleaf.com/project/后面那串就是比如64axxxx...。注意overleaf_session2会过期。如果你在浏览器里点了 Log Out或者 Cookie 自然到期Cursor 这边就会同步失败。重新按上面步骤取一次即可不用重装插件。3.2 settings.json 骨架Cursor 的用户设置文件在~/.cursor/下Windows 在%APPDATA%\Cursor\User\。你可以直接编辑settings.json把 Overleaf Workshop 和模型通道一起配好。下面是一个可复制的骨架字段名以你装的插件版本为准核心是这几项{ overleaf-workshop.cookie: s%3A你的overleaf_session2值, overleaf-workshop.projectId: 你的project_id, overleaf-workshop.serverUrl: https://www.overleaf.com, overleaf-workshop.autoSync: true, cursor.ai.baseUrl: https://taotoken.net/api, cursor.ai.apiKey: 你的TaoToken统一Key }几个点说明一下。cookie字段直接填刚才复制的整串包括s%3A前缀不要手动解码。autoSync打开后本地保存会自动推送到网页端但首次连接建议先关掉手动验证一次同步方向对不对避免本地空文件覆盖远程内容。cursor.ai.baseUrl和apiKey是给 Cursor 内 AI 用的指向 TaoToken 的 API 端点。Key 在控制台生成地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 具体路径在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。提示如果你不想把 Key 明文写在 settings.json 里可以用环境变量Cursor 支持在配置里引用${env:TAOTOKEN_KEY}这种写法。团队协作时尤其注意别把带 Key 的配置文件提交到 Git。4. 验证连接从拉取项目到编译成功4.1 拉取远程项目配置保存后重启 Cursor。打开命令面板CtrlShiftP输入Overleaf Workshop: Download Project选择你配好的项目。插件会用overleaf_session2去请求 Overleaf把项目文件拉到本地工作区。如果成功你会在文件树里看到.tex、.bib、图片等文件。这时候先别急着改打开主.tex文件确认内容完整——有时候网络抖动会导致部分文件没拉全重新执行一次下载即可。4.2 本地编译验证LaTeX Workshop 插件负责编译。确认你本地装了 TeX Live 或 MiKTeX然后在 Cursor 里打开.tex文件按CtrlAltB触发编译。看输出面板有没有报错正常的话会生成 PDF右侧预览窗口能直接看。这一步的意义是确认本地工具链没问题。如果本地编译都过不了同步到网页端也会失败先解决本地环境。4.3 同步回网页端本地改一处内容比如在\section里加一句话保存。如果autoSync开着插件会推送到 Overleaf。回到浏览器刷新项目页看改动是否出现。反过来在网页端改一处本地执行Overleaf Workshop: Sync Project看本地是否更新。双向都通了说明overleaf_session2有效、project_id正确、同步方向没搞反。4.4 用 TaoToken 通道验证 AI 调用在 Cursor 里打开 AI 对话问一个 LaTeX 相关问题比如帮我把这段伪代码转成 algorithm2e 环境。如果配置正确请求会走 TaoToken 的 API 端点返回结果。你也可以在模型对话页面直接测试通道是否通 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果 AI 没响应先检查baseUrl有没有写错、Key 有没有过期。TaoToken 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例对照排查。5. 本篇常见错排查5.1 同步失败提示未授权最常见的原因是overleaf_session2过期。去浏览器重新取一次替换 settings.json 里的值重启 Cursor。注意复制时别漏字符整串包括s%3A都要。另一个可能是project_id填错。回项目页 URL 核对一遍别把用户名或其他路径段当成 ID。5.2 本地文件被清空或覆盖这通常是首次连接时autoSync开着本地空工作区把远程覆盖了。Overleaf 有历史版本去网页端History里恢复。预防办法首次连接先关autoSync手动下载确认文件完整后再开。5.3 编译报错但网页端正常本地 TeX 环境和 Overleaf 的不完全一致。Overleaf 用的是 TeX Live 特定版本加一堆宏包你本地可能缺包。看报错信息缺哪个.sty用tlmgr install补上。如果宏包版本冲突考虑用latexmk配合项目里的.latexmkrc统一编译流程。5.4 AI 请求超时或 401先确认baseUrl是https://taotoken.net/api别多加斜杠或路径。401 一般是 Key 无效去控制台重新生成。超时可能是网络问题换个时间段试。如果长期编码或跑 Agent 任务可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合高频调用场景。5.5 Cookie 里有特殊字符导致 JSON 解析失败overleaf_session2的值里可能有%、:等字符直接塞进 JSON 字符串一般没问题但如果你的编辑器自动转义了就会出错。确保值是原样字符串不要手动 URL 解码。如果实在拿不准用环境变量传避开 JSON 转义问题。6. 把这条链路用顺整套流程跑通后你的工作流会变成在 Cursor 里写 LaTeX本地编译即时看效果AI 帮你补环境、查报错、转格式保存后自动同步到 Overleaf合作者或导师在网页端直接看最新版。overleaf_session2是这条链路的钥匙过期了就重取不复杂。如果你还想在本地跑更重的编码任务比如批量处理参考文献、自动生成图表代码可以了解下 Coding Plan 的额度方案 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有需要可以对照配置。最后提醒一句overleaf_session2别外传settings.json 别提交到公开仓库。把这两件事守住剩下的就是安心写论文了。