dsh-chatpaper

dsh-chatpaper

After DSH's release, I plan to gradually accumulate the tools I use frequently as DSH plugins.

ChatPaper has brought me a lot of convenience — it saves a great deal of time searching for papers and doing research. So, to adapt it into a DSH plugin, I spent some time modifying the code with AI and published it to GitHub, hoping to bring the same convenience to more people.

arXiv paper tools for DeepSeek Harness (DSH), provided as native tools — no Python, no MCP server. Paper text is extracted primarily from arXiv's official HTML rendering (LaTeXML), with ar5iv and PDF fallbacks.

This project is a DSH plugin port referencing ChatPaper: the tool contracts and query logic are kept consistent, but it now runs directly on DeepSeek Harness's native interfaces. See Acknowledgments at the end for the source and citation.

Tools

Background runs (run_in_background: true) register standard DSH jobs: the call returns a job id immediately, and after completion the result (or failure detail) is retrieved with the harness's built-in job_output tool. A single read is capped at 20000 bytes.

search_arxiv needs no API key. The three LLM-backed tools use the harness LLM service (ctx.llm) — the provider, model, credentials, retry policy, and routing configured on the web Models page are all reused directly, with nothing to configure inside the plugin. When provider/model are left empty, they resolve at call time to the deployment's deepseek route and its default model; explicit configuration takes precedence.

Install

From npm (prebuilt, no install-time build authorization needed):

dsh plugin --profile <name> add dsh-chatpaper

From GitHub source (runs a prepare build; pnpm requires an allowBuilds grant in the profile's pnpm-workspace.yaml — the npm route is preferred):

dsh plugin --profile <name> add github:puppet2004/dsh-chatpaper

The bundle registers one chatpaper row; after installation, every session of that profile sees these 4 tools.

Configuration

Add or override the row in your profile's cordis.patch.yml:

- insert:
    - id: chatpaper
      name: dsh-chatpaper
      config:
        provider: ''
        model: ''

How paper text is fetched

1. Official HTML — https://arxiv.org/html/<versioned-id>; structured extraction preserves section headings and math (<math alttext> → LaTeX).
2. ar5iv — https://ar5iv.labs.arxiv.org/html/<id> for older papers without official HTML.
3. PDF fallback — pdfjs-dist text extraction for papers with no HTML at all.

Each tier's output is validated (an empty shell or fewer than 200 extracted characters falls through to the next tier). Extracted text is cached, so repeated calls are instant.

Model Experience

What the model sees

4 native tools with their declared schemas. search_arxiv returns structured paper metadata (id, title, authors, date, categories, pdf URL, abstract) rendered as a numbered list. The LLM tools return structured results whose render shows the summary/translation/survey text; surveys also carry an [n]-indexed reference list.

Token and KV-cache effects

Tool schemas are fixed, so the model-facing definition prefix is stable across requests. Tool results are plain text; no binary or image payloads enter context. Paper bodies are truncated (summaryChars/surveyPaperChars/translateMaxChars) before every LLM call, keeping prompts bounded. Cache hits avoid re-downloading and re-extracting entirely.

Acknowledgments

This project is a port of the open-source ChatPaper project. The search query logic, paper-summarization prompts, and survey workflow follow the original design, re-implemented on DeepSeek Harness native interfaces (ctx.llm, ctx.tools, ctx.jobs). Thanks a lot for ChatPaper's work. If you use this plugin or build on it, please also cite the original project:

@misc{ChatPaper,
  author={Yongle Luo, Rongsheng Wang, Peter Gam, Jiaxi Cui, circlestarzero, Shiwen Ni, Jaseon Quanta, Qingxu Fu, Siyuan Hou},
  title = {ChatPaper: Use LLM to summarize papers.},
  year = {2023},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/kaixindelele/ChatPaper}},
}