← 返回列表
未验证
面向 DeepSeek HarnessDSH的 Overleaf 集成，构建于
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/9/10 · 已提供中文文档
DSH better-sidebar 的 Overleaf 标签页：直接 CDP 登录、`<workspace>/overleaf/` 下的项目镜像、git/API 同步、侧边栏文件预览
综合分
30.6
GitHub 分
30.6
用户评分
—
★ Stars
2
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add Hoemr/dsh-better-overleaf该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/19（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-credentials@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-tools用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-better-overleaf
面向 DeepSeek Harness（DSH）的 Overleaf 集成，构建于
dsh-better-sidebar 的
工作台之上。一个 Overleaf 项目 ↔ 一个位于
/overleaf// 下的本地 git 镜像，因此侧边栏的资源管理器、编辑器、图片/PDF
预览器、Git 面板以及对话文件引用（@ 提及）都能直接操作
Overleaf 内容。
工作原理
Overleaf 项目 ──┬── git 桥接 (git.overleaf.com/) ← 双向拉取/推送
└── 网站 zip 快照 (cookie 认证) ← 仅拉取的回退方案
│
▼
/overleaf// ← 真实 git 仓库 + .overleaf.json 绑定
│
▼
dsh-better-sidebar 工作台 ← 资源管理器 / 编辑器 / 预览 / Git 面板 / @引用
- host（src/index.ts → lib/index.js）：提供 ctx.overleaf 以及
仅限回环的 /overleaf/* JSON 路由（status / projects / bindings /
login / cookie / bind / unbind / sync）。
- client（src/client/index.ts → lib/client.js）：在挂载了该可选对等依赖时，
向 dsh-better-sidebar 注册
Overleaf 标签页；未挂载时插件保持休眠但无害（可热插拔）。
凭据绝不会进入浏览器 bundle 或路由载荷：host 通过 ctx.credentials 解析
OVERLEAF_COOKIE 和 OVERLEAF_GIT_TOKEN。
兼容性
0.2.2 与 DSH Desktop 2.0.5 / @deepseek-ai/dsh 0.1.2-rc.1 对齐：
- 对等依赖为 @deepseek-ai/cordis ^4.0.2、@deepseek-ai/dsh-credentials、
@deepseek-ai/dsh-host-webserver、@deepseek-ai/dsh-tools，版本为
^0.1.2-rc.1，以及 dsh-better-sidebar >=0.13.1 =0.13.1 <0.19
dsh plugin --profile desktop add dsh-better-overleaf@0.2.2
然后重启应用，以便宿主部分挂载；硬刷新 web 视图
开发流程：
dsh plugin --profile desktop add link:D:/Coding/dsh-better-overleaf
如果 pnpm 报告 node-pty 的构建脚本被忽略，请在配置文件的
pnpm-workspace.yaml 中设置 allowBuilds: { node-pty: true }
（终端功能需要它；其他一切功能没有它也能正常工作）。
配置
yaml
- insert:
- id: overleaf
name: dsh-better-overleaf
config:
transport: auto # auto | git | api
baseUrl: https://www.overleaf.com
gitOrigin: https://git.overleaf.com
browserChannel: auto # auto | default | msedge | chrome
browserPath: '' # 显式可执行文件路径，优先尝试
playwrightHeadless: false
loginTimeoutMs: 600000
只要存储了 OVERLEAF_GIT_TOKEN，transport: auto 就优先使用 git；当只存在
cookie 时，拉取会降级为 API 快照。API 传输方式无法推送（网站端点对内容
是只读的）；推送需要 git 桥接凭据（账户密码，或用于 SSO 账户的
Git 集成令牌）。
同步语义
| 传输方式 | 拉取 | 推送 | 备注 |
|---|---|---|---|
| git | ✅ pull --ff-only | ✅ push HEAD | 完整历史；better-sidebar 的 Git 面板显示真实差异 |
| api | ✅ zip 快照 → 清空并提交 | ❌ | 当镜像存在未提交的更改时拒绝执行 |
绑定会在镜像内写入 .overleaf.json，并通过
.git/info/exclude 将其排除；解绑只移除绑定文件，绝不会动你的文件。
状态 / 路线图
已完成：项目列表/切换、镜像绑定/解绑、git clone/pull/push、API
快照拉取、带自定义浏览器路径的直接 CDP 登录、手动 cookie
回退、仅回环路由、可热插拔的可选对等项。
欢迎提出想法：面向 agent 的拉取/推送工具（让模型能够自行同步）、
通过文件夹/文件上传端点进行 API 推送、PDF 编译预览。扫码进群