前言¶
在 DeepSeek Harness（dsh）里做论文修订，常见的问题是：PDF 批注、LaTeX 源码编辑、编译结果和 git 历史分散在不同步骤里。PaperLab（maple-pwn/paperlab）把这些步骤放在同一个工作台里：在渲染后的 PDF 上选中文字写批注，再由 dsh agent 按批注修改源码、检查编译并提交 git。PaperLab 的 AI 执行引擎完全运行在 DeepSeek Harness 里，工作台从不直接调用模型 API。
这是什么¶
PaperLab 是一个 Overleaf 式论文迭代修改工作台，AI 引擎是 DeepSeek Harness 插件。仓库由 maple-pwn 维护，许可证为 MIT © 2026 PaperLab contributors。
它解决的问题很具体：让“读批注、改论文、看真实 PDF、回滚版本”在同一个流程中完成，同时把模型执行、工具调用和版本管理交给 dsh 的 agent 流程。
核心功能¶
界面与批注¶
- Overleaf 式三栏布局，面板可拖动。
- 在 PDF 上选中任意文字写意见。
- 黄色高亮精确落位，基于页面坐标。
- 真实 PDF 渲染，公式图表排版一致。
- 源码编辑即自动保存、自动编译。
AI 修订¶
AI 修订基于 dsh agent，流程是：
读批注 → 唯一匹配编辑 → 编译检查 → git 提交
工作台提供宽屏轨迹，直播思考过程、工具调用和输出，并带计时与 LIVE 状态。也可以在工作台内切换模型、思考强度和编排模式。
版本管理与工程能力¶
- 每个项目即 git 仓库，AI 修订自动 checkpoint。
- 支持历史浏览、任意 diff、一键 revert 回滚。
- 一键导出：源文件（含批注）/ PDF / git 历史。
- 自动识别 XeLaTeX，尊重
latexmkrc，并提供多编译引擎降级链。
安装与启用¶
先确认前置环境：
Node.js ≥ 20
pnpm ≥ 10
Python ≥ 3.11
git
DeepSeek Harness（dsh）
LaTeX 可选
将插件安装到 paperlab profile：
dsh plugin --profile paperlab add github:maple-pwn/paperlab
仓库根即符合官方规范的 dsh bundle，包含：
dsh.bundle
cordis.patch.yml
lib/
注意：安装插件等于运行第三方代码。请先阅读源码，并在不保存密钥的环境中试用。
典型用法¶
先做克隆和进入仓库：
git clone https://github.com/maple-pwn/paperlab.git
cd paperlab
再启动工作台。可运行启动脚本：
./start.sh
也可以运行 Make 目标：
make start
start.sh 自动完成：装依赖 → 构建 → 安装插件到 dsh profile → 启动 dsh → 启动工作台。
启动后打开浏览器工作台：
http://127.0.0.1:8210
模型凭据属于 dsh。在 dsh Web UI 的「模型」页配置即可：
http://127.0.0.1:3080
PaperLab 不接触任何 API key。
如果需要验证构建或测试，可运行：
make test
适用场景与注意¶
PaperLab 适合这类场景：
- 需要在浏览器中迭代 LaTeX 论文。
- 希望在真实 PDF 上做批注，而不是只改源码。
- 希望 AI 修改有编译检查、git 提交和可回滚记录。
- 希望模型凭据和模型调用都留在
dsh侧。
使用注意：
- PaperLab 的 AI 执行引擎完全运行在 DeepSeek Harness 里，工作台从不直接调用模型 API。
- 插件运行时会处于当前
dsh进程的权限上下文中；安装前应检查源码、许可证和运行环境。 - 模型凭据配置在
dsh的「模型」页，不要将密钥放入 PaperLab 项目。 LaTeX是可选前置；实际编译能力仍依赖本地环境。
相关资源¶
GitHub 仓库：
https://github.com/maple-pwn/paperlab
