paper-review

A paper-review panel for the DeepSeek Harness: upload a PDF paper and read it as structured, selectable text beside the conversation, with figures and display equations rendered visually.

Features

• PDF → structured text (runs on the Harness host, via poppler):
  • two-column layout reconstruction (gutter detection + full-width line reassembly)
  • headings (size + all-caps normalization) and run-in heading splitting
  • tables (geometric column detection, wrapped-cell continuation)
  • sub/superscripts, dot-leader table of contents
  • scanned-PDF fallback to page images
• Figures and display equations rendered as images (pdftoppm crops + pdfimages raster extraction), with equation text kept as hidden spans so it stays searchable.
• Right-side reader panel: real third column when space allows (the harness details column), auto sidebar-collapse to make room, floating fallback for narrow windows, slim tab when collapsed.
• Ask dialog: select text → a small dialog appears → type a question ("explain this", "how does this relate to…") → the question plus the selection, its surrounding context, and the abstract are sent to the model.
• Projects: Create project materializes the paper (paper.pdf, paper.md, paper.html, figures, README with title/abstract) into a Paper workspace, opens a session there, and asks the agent to load the paper — each project keeps its own paper, so multiple papers coexist.

Requirements

• DeepSeek Harness (dsh) installed.
• poppler CLI tools on PATH: pdftotext, pdftoppm, pdfimages.
  • macOS: brew install poppler
  • Debian/Ubuntu: sudo apt-get install poppler-utils

Install

From npm (recommended)

dsh plugin --profile readPaper add @deepseek-ai/dsh-web-app paper-review
# then start the harness:
dsh --profile readPaper

dsh plugin installs the packages, then reconciles — packages that declare join the profile's layer stack automatically.