前言¶
用 DeepSeek Harness 改 LaTeX 论文时，常见做法是本地开一份副本，或在浏览器里切到 Overleaf 再回来对话。两边项目容易脱节：网页上协作者的改动进不了工作区，Agent 改的文件也要自己上传。维护者 chenqaq123 的客户端插件 dsh-overleaf-workshop 把 Overleaf 项目接进 Harness：三栏界面里同时有目录、编辑器和 Agent 对话，并与 Overleaf 做实时双向同步。下面介绍它做什么、怎么装、怎么用。
这是什么¶
dsh-overleaf-workshop 是 DeepSeek Harness 的 客户端 插件（分类：客户端），在 Harness 内直接打开 Overleaf 项目，本地编辑与 Agent 修改可推送到 Overleaf，网页端协作改动也会拉回本地。仓库：chenqaq123/dsh-overleaf-workshop；社区目录页：skillhub.cn 条目。许可证为 MIT；README 说明本项目未使用 Overleaf Workshop（AGPL-3.0）的代码，相关协议实现基于独立研究。
核心功能¶
依据仓库 README，当前能力包括：
- 实时双向同步：本地与 Agent 的变更自动推到 Overleaf；网页端修改同步回本地。支持新建、重命名、移动、删除文件；并发编辑时支持三方合并。
- 三栏编辑界面：目录树、文件编辑器、Agent 对话并排。内置 CodeMirror，支持 LaTeX 高亮、搜索、自动保存与快捷键。
- 在线编译与 PDF 预览：在 Overleaf 服务器上编译当前打开的
.tex，output.pdf可在内置预览中查看。 - 项目与会话管理：侧边栏显示 Overleaf 项目及同步状态，支持快速编译、新建会话、切换历史会话、结束同步。
- 按需同步：可随时断开实时连接并保留本地文件；重新进入项目可恢复同步。连接不可用时支持手动拉取与推送。
安装与启用¶
推荐通过 GitHub 安装（命令来自 README）：
dsh plugin --profile desktop add github:chenqaq123/dsh-overleaf-workshop
macOS 桌面版若找不到 dsh，可用应用内 CLI：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add github:chenqaq123/dsh-overleaf-workshop
安装完成后重启 Harness，在「插件 → 已安装」中管理。package.json 标明运行环境为 Node.js >= 20，支持 darwin 与 linux。
登录与典型用法¶
先做 Overleaf 登录，再选项目进入工作区：
- 在浏览器中登录 Overleaf。
- 按
F12打开开发者工具，在 Network 中任选一条请求，复制请求头里的Cookie值。 - 打开 Harness 侧边栏 Overleaf → 管理，粘贴 Cookie，点击「验证并登录」。
- 选择项目，进入本地三栏工作区。
Cookie 仅保存在本机 ~/.dsh/overleaf/secrets.json。
进入项目后可直接编辑文件，也可让 Agent 完成任务（README 以「例如」引出，未给出固定示例命令，按你的论文任务自然描述即可）。
适用场景与注意¶
适合需要在 Harness 里一边改 LaTeX、一边和 Agent 协作，又希望与 Overleaf 网页端保持同一项目状态的开发者。DeepSeek Harness 生态是「一切皆插件」；skillhub.cn 上的社区目录与 DeepSeek / 幻方无官方从属关系，安装前请自行查看源码与 MIT 许可证。插件以当前 dsh 进程权限运行，Cookie 写入本机 secrets 文件，请勿在不可信环境粘贴会话凭证。
结尾¶
dsh-overleaf-workshop 把 Overleaf 的三栏工作区与实时同步放进 Harness，减少本地副本与网页项目不一致的问题。详情见 GitHub 仓库 与 插件目录页。
