maple-pwn/paperlab

PaperLab

An Overleaf-style paper revision workbench, powered by a DeepSeek Harness plugin.

中文 · Quick Start · Architecture · Contributing

Edit LaTeX and see the real rendered PDF in one place. Select any text to annotate, then let a DeepSeek Harness agent revise the paper annotation by annotation — with compile verification, git commits, diffs, rollback, and export.

✨ Features

🖥 UI	📄 Annotation	🤖 AI revision
Overleaf-style three panes, draggable	Select any text in the PDF to comment	dsh agent: read annotations → uniquely-matched edits → compile check → git commit
Source edits auto-save and auto-compile	Yellow highlights pinned by page coordinates	Wide-screen trace streams reasoning / tool calls / output with timer and LIVE badge
True PDF rendering (formulas, figures, layout)	"Locate" shows the pre-revision text in a red popup	Switch model / reasoning effort / agent preset in the workbench

📜 Versioning	📦 Engineering
Every project is a git repo with AI checkpoints	One-click export: sources (+ annotations) / PDF / git history
History browser, arbitrary diffs, one-click revert	Auto XeLaTeX detection, respects latexmkrc, multi-engine fallback chain

🔄 Workflow

🏗 Architecture

The AI engine runs entirely inside DeepSeek Harness; the workbench never calls model APIs directly.

Part	Stack	Responsibility
web/	React + Vite + PDF.js	three-pane UI, PDF text selection, trace view, history/export
server/	FastAPI	project management, LaTeX compile, annotations, git history, static hosting
plugin/	DeepSeek Harness bundle (TypeScript)	paper-revision tools + HTTP trigger + model/preset settings proxy

See docs/architecture.md.

🚀 Quick Start

Prerequisites: Node.js ≥ 20, pnpm ≥ 10, Python ≥ 3.11, git, DeepSeek Harness (dsh). LaTeX is optional.

git clone https://github.com/maple-pwn/paperlab.git
cd paperlab
./start.sh                # or make start

Open http://127.0.0.1:8210.

🔑 Credentials belong to dsh: configure them on the Models page of the dsh Web UI (http://127.0.0.1:3080). PaperLab never touches your API keys.

📦 Installing the plugin

The repository root is an official-format dsh bundle (dsh.bundle + cordis.patch.yml + prebuilt lib/):

dsh plugin --profile paperlab add dsh-paperlab                     # npm
dsh plugin --profile paperlab add github:maple-pwn/paperlab        # GitHub
dsh plugin --profile paperlab add .                                # local development

⚠️ Installing a plugin runs third-party code with your permissions. Review the source and try it without your credentials first.

🧪 Tests

make test

📄 License

MIT © 2026 PaperLab contributors

🔗 Community

• Join the DeepSeek Harness plugin ecosystem (topic: dsh-plugin)
• Issues & ideas: GitHub Issues