From nothing to a read paper

Five steps, about ten minutes on DSH Desktop.

  1. Install DeepSeek Harness

    Either works; pick one. DSH Desktop bundles its own runtime and needs no Node — the right start for most people:

    Download for macOS (Apple silicon) Download for Windows

    The command line (dsh web, used in a browser) needs Node 22.19 or newer, installed globally:

    npm install -g @deepseek-ai/dsh

    New to dsh entirely? Skim the official quickstart and set up a model first.

  2. Install the research plugin market

    Install this one first; everything else installs from inside it, without going back to a terminal.

    Desktop: Plugins in the sidebar → Add plugin at the top right, enter dsh-research, press Install, restart when asked.

    Command line:

    dsh plugin --profile web add dsh-research

    On the command line, if you already know what you want, take the whole workbench in one paste instead:

    dsh plugin --profile web add dsh-research dsh-ai4scholar
  3. Add the literature tools and a key

    Open Plugins → Installed → dsh-research: that is the research plugin catalog (older dsh: Settings → Research plugins). Install dsh-ai4scholar, then press Restart dsh in the panel. On the command line, run dsh web first and do this in the browser page it opens.

    When it comes back, open Plugins → Installed → dsh-ai4scholar (or Settings → AI4Scholar), paste a key from ai4scholar.net and save. It tests the key on the spot and shows your credits; no restart.

    The key goes into the dsh credential store — never into the conversation, never to the model. arXiv, bioRxiv and DOI full text need no key, so you can skip this and come back.

  4. Your first search

    Ask in plain language. The guidance forbids answering from memory, so the agent searches before it asserts.

    “Find the strongest evidence from the last three years on your topic, sorted by citations, and tell me what each one concludes.”

    The answer ends with the credits this turn spent and what is left. The free sources — arXiv, bioRxiv, DOI full text — are not billed.

  5. Read it in full, then cite it

    Pick one and have it read the full text — the PDF body, not the abstract. Full text comes back in slices, so it reads what the question needs instead of dumping the whole PDF into context.

    “Read the methods of 10.1038/s41586-021-03819-2 — how are the controls designed?”

    When you are writing, paste your own paragraph and ask for citations: auto_cite marks where each claim needs one and returns a checkable reference list (billed, 20–90 s).

What else it does

Citation graph

Walk references and citations in both directions, then pull recommendations of nearby work, until the thread of a topic is in hand.

Auto-cite

Paste a paragraph you wrote: it marks each claim that needs a citation and returns a checkable reference list.

Scientific figures

Generate, restyle, compose and critique figures, SVG included — mechanism and pipeline diagrams without opening a drawing app.

Authors & recommendations

Trace an author’s publication line, or start from one paper you like and ask for similar work.

Common questions

The install printed peer dependency warnings — is that broken?

No. Those @deepseek-ai/* packages resolve at runtime to the global dsh install rather than into the profile. The official plugin market prints the same warnings.

It failed to start with EADDRINUSE

Another dsh is still running — often one whose terminal window was closed, leaving the process adopted by the system. Find it with lsof -nP -iTCP:3080 -sTCP:LISTEN and kill it.

Does the --profile web command work for DSH Desktop?

Not as written: web is the command-line profile, and Desktop runs its own, so a plugin installed into web from a terminal is invisible to it. On Desktop use Plugins → Add plugin with the package name; once dsh-research is in, install the rest from its catalog, which always targets the profile that is running.

I installed a plugin and nothing changed

The profile is read at boot, so a newly installed plugin needs a restart. Refreshing the page is not enough.

How are credits counted?

Semantic Scholar, PubMed and Google Scholar searches, auto-cite and figures are billed per call, and every answer ends with what it spent and what is left. arXiv, bioRxiv/medRxiv and DOI full-text extraction are free.

Can I install just one of the packages?

Yes, the two are independent. dsh-ai4scholar is search on its own, and dsh-research is the market panel itself.