maple-pwn/paperlab

Overleaf-style paper revision workbench powered by a DeepSeek Harness plugin (dsh-plugin)

Bundle 已验证 MIT Roff v0.1.0
Bundle 已验证

已收录

3

Docs

Bundle 已验证

版本v0.1.0
语言Roff
许可证MIT
在 GitHub 查看

预览

第 1 个预览,共 2 个:maple-pwn/paperlab
第 2 个预览,共 2 个:maple-pwn/paperlab

功能介绍

Overleaf 式 LaTeX 论文工作台:在渲染后的 PDF 上选中任意文字批注,由 dsh agent 改写源文件、编译验证并提交 git 修订。

适合

  • 希望针对渲染 PDF 中选中文字添加批注并修订 LaTeX 论文的研究人员。
  • 需要 Agent 修改源文件后执行编译检查并记录 Git 历史的团队。
  • 需要整合源码编辑、PDF 审阅、差异、回滚和导出的 Overleaf 式工作台用户。

不适合

  • 非 LaTeX 文档,或不会生成渲染 PDF 的工作流。
  • 只需要轻量文本编辑、不需要项目管理、编译或 Git 历史的用户。
  • 缺少 Node.js 20+、pnpm 10+、Python 3.11+、Git 或 DeepSeek Harness 必需组件的环境。

README

PaperLab logo

PaperLab

Overleaf 式论文迭代修改工作台,AI 引擎是 DeepSeek Harness 插件。

English · 快速开始 · 架构 · 贡献指南

license npm dsh-plugin stars

在浏览器里编辑 LaTeX、看真实排版的 PDF、选中任意文字写批注;点一下按钮,DeepSeek Harness 的 agent 就会按批注逐条改写论文、验证编译、提交 git——所有修改都有 diff、可回滚、可导出。

PaperLab 界面截图

✨ 功能

🖥 界面 📄 批注 🤖 AI 修订
Overleaf 式三栏布局,面板可拖动 在 PDF 上选中任意文字写意见 基于 dsh agent:读批注 → 唯一匹配编辑 → 编译检查 → git 提交
源码编辑即自动保存、自动编译 黄色高亮精确落位(页面坐标) 宽屏轨迹直播思考过程 / 工具调用 / 输出,带计时与 LIVE 状态
真实 PDF 渲染(公式图表排版一致) 「定位」红窗展示修改前原文 工作台内切换模型 / 思考强度 / 编排模式
📜 版本管理 📦 工程能力
每个项目即 git 仓库,AI 修订自动 checkpoint 一键导出:源文件(含批注)/ PDF / git 历史
历史浏览、任意 diff、一键 revert 回滚 自动识别 XeLaTeX / 尊重 latexmkrc,多编译引擎降级链

🔄 工作流

PaperLab 工作流

🏗 架构

PaperLab 的 AI 执行引擎完全运行在 DeepSeek Harness 里,工作台从不直接调用模型 API:

部分 技术 职责
web/ React + Vite + PDF.js 三栏界面、PDF 选中批注、轨迹大视图、历史/导出
server/ FastAPI 项目管理、LaTeX 编译、批注与 git 版本管理、静态托管
plugin/ DeepSeek Harness bundle(TypeScript) 论文修改工具 + HTTP 触发端点 + 模型/预设设置代理
浏览器 ⇄ FastAPI ──(127.0.0.1:3923)──▶ dsh-paperlab 插件 ──▶ dsh agent loop
                                                    │
                                    dsh LLM 适配器(凭据/路由/思考强度)

详见 docs/architecture.md。

🚀 快速开始

前置:Node.js ≥ 20、pnpm ≥ 10、Python ≥ 3.11、git、DeepSeek Harness(dsh)。LaTeX 可选。

git clone https://github.com/maple-pwn/paperlab.git
cd paperlab
./start.sh                # 或 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。

📦 安装插件

仓库根即符合官方规范的 dsh bundle(dsh.bundle + cordis.patch.yml + 预构建 lib/):

dsh plugin --profile paperlab add dsh-paperlab                     # npm
dsh plugin --profile paperlab add github:maple-pwn/paperlab        # GitHub
dsh plugin --profile paperlab add .                                # 本地开发

⚠️ 安装插件等于运行第三方代码:请先阅读源码,并在不保存密钥的环境中试用。

🧪 测试

make test
# server: pytest · web: tsc + vite build · plugin: tsc + tsup + 工具单测

📄 许可证

MIT © 2026 PaperLab contributors

🔗 社区

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:maple-pwn/paperlab。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。