dsh-ai4scholar

dsh plugin --profile web add dsh-ai4scholar

<p align="center"><a href="https://ai4scholar.net?src=dsh"><img src="https://raw.githubusercontent.com/literaf/dsh-ai4scholar/main/docs/logo.svg" width="120" alt="AI4Scholar"></a></p>

<p align="center"><strong>dsh-ai4scholar</strong></p>

AI4Scholar for DeepSeek Harness

English | [中文](README_CN.md)

   !license

<p align="center"><a href="https://ai4scholar.net?src=dsh"><img src="https://raw.githubusercontent.com/literaf/dsh-ai4scholar/main/docs/ai4scholar-home.jpg" alt="ai4scholar.net" width="100%"></a></p>

Academic literature tools for DeepSeek Harness (dsh), delivered as 38 native agent tools — the same coverage as the AI4Scholar plugins for OpenClaw, Codex, and Hermes. Powered by ai4scholar.net.

Family · Tools · Cost

Paper search · search_papers — Semantic Scholar only by default; select PubMed, arXiv, or Google Scholar via sources as needed. Multiple sources are merged by DOI / arXiv id / PMID / title, with multi-platform hits ranked first · per selected platform

Semantic Scholar (200M+ papers, all fields) · search_semantic, search_semantic_bulk, search_semantic_snippets (full-text excerpts), search_semantic_paper_match (title → paper), get_semantic_paper_detail, get_semantic_paper_batch, get_semantic_citations, get_semantic_references, get_semantic_paper_authors, search_semantic_authors, get_semantic_author_detail, get_semantic_author_batch, get_semantic_author_papers, get_semantic_recommendations, get_semantic_recommendations_for_paper, download_semantic, read_semantic_paper · credits

PubMed (biomedical & life sciences) · search_pubmed, get_pubmed_paper_detail, get_pubmed_paper_batch, get_pubmed_citations, get_pubmed_related · credits

Google Scholar (broadest coverage, cited-by counts) · search_google_scholar · credits

arXiv · search_arxiv, download_arxiv, read_arxiv_paper · free

bioRxiv / medRxiv · search_biorxiv, search_medrxiv, download_biorxiv, download_medrxiv, read_biorxiv_paper, read_medrxiv_paper · free

Any DOI · download_by_doi, read_by_doi (open access anywhere; paywalled publishers on institutional networks) · free

Writing & figures · auto_cite (insert real citations + reference list + BibTeX), sci_draw (generate / edit / style / compose / critique / SVG / vectorize scientific figures) · credits

Account · get_ai4scholar_credits, plus the /ai4scholar slash command · free

Start with one source. Omitting sources (or passing []) queries only Semantic Scholar. For biomedical or clinical topics, select sources: ["pubmed"] as appropriate. Use multiple sources, such as ["semantic-scholar", "pubmed"], when broader coverage is explicitly requested or one source is insufficient. Each billed API request adds to the charge; Google Scholar bills per page, while arXiv is free. If Semantic Scholar is disabled, the default is the first enabled platform in this order: PubMed, arXiv, Google Scholar.

Every paper-list tool returns one normalized record shape — title, authors, year, venue, citation count, DOI/PMID/arXiv ids, URL, open-access PDF, abstract — so the model (and Code Mode programs) can chain calls across platforms without special cases. Results render as citation cards in the dsh Web UI; full-text tools return the PDF text in slices (offset / max_chars) so a 40-page paper never floods the context.

Credits are visible. Every billed tool card in the chat carries the charge in its title (Semantic Scholar: protein folding · 10 credits · 4,990 left), the model-facing result ends with AI4Scholar credits — this call: 10 · this session: 40 · remaining: 4,960 (from the API's X-Credits-* headers) and the model is asked to close a billed turn with a one-line credit note; /ai4scholar renders a balance card (available credits, breakdown, membership, key status, session spend) and get_ai4scholar_credits gives the model the same numbers. Free platforms (arXiv, bioRxiv/medRxiv, DOI) carry no credit line.

Screenshots

API key card (legacy Settings view) · /ai4scholar balance card

!AI4Scholar settings card · !balance card

Install

Quick start (macOS / Linux; Windows PowerShell is the same):

# 0. Prerequisites: Node.js ≥ 22.19 (or ≥ 24) and pnpm (dsh manages plugins with pnpm)
node -v
npm i -g pnpm                     # skip if you already have it

# 1. DeepSeek Harness
npm i -g @deepseek-ai/dsh
dsh --version

# 2. This plugin (into the web profile; use --profile headless for the CLI runner)
dsh plugin --profile web add dsh-ai4scholar

# 3. Start
dsh web                           # prints http://127.0.0.1:3080

Then, once, in the browser:

1. Settings → Models — paste your DeepSeek API key (platform.deepseek.com).

2. Plugins → Installed → dsh-ai4scholar (or Settings → AI4Scholar) — paste your AI4Scholar API key (ai4scholar.net) and press Save. The card stores it in the dsh credentials store ($DSH_HOME/.credentials.yaml, mode 0600, the same place the Models page keeps provider keys), tests it at once (✓ Key works · 89,419 credits available), and it takes effect on the next tool call — no restart. A *

…(truncated)