Reference verification for DeepSeek Harness (参考文献真实性检查器): the reference_checker model tool checks a paper's bibliography (.pdf/.bib/.tex/.txt or pasted text) against Crossref, OpenAlex and arXiv, reports found / partial / not_found / error per entry, and emits corrected citations in the input's style (APA, GB/T 7714, IEEE, Vancouver, MLA, Chicago, Harvard, ACS, BibTeX).
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-reference-checker
# from a prebuilt release tarball
dsh plugin --profile web add "https://github.com/Yu-tao-Li/dsh-reference-checker/releases/download/v1.1.0/dsh-reference-checker-1.1.0.tgz"
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Yu-tao-Li/dsh-reference-checker
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
dsh-reference-checker (Reference Verification · 参考文献真实性检查器)
Reference-verification for DeepSeek Harness — one model tool, reference_checker, that takes a paper (.pdf / .bib / .tex / .txt / .md) or a pasted reference list and verifies every entry against Crossref / OpenAlex / arXiv. Each reference gets a verdict (found / partial / not_found / error), the closest real record (title, year, venue, volume, pages, DOI/URL), and a corrected citation in the input's own style (APA, GB/T 7714, IEEE, Vancouver, MLA, Chicago, Harvard, ACS, or BibTeX) — ready to paste back into the paper.
Host-only plugin (no browser UI, no services); the single runtime dependency is pdf-parse (PDF text-layer extraction).
| ① Sample report: mixed-style input, per-entry verdicts + corrected citations (actual output style) |
|---|
![]() |
Features
- Three index sources, queried concurrently — Crossref (bibliographic) + OpenAlex (open scholarly) + arXiv (preprints; queried only for English titles); 4-way concurrency, 15 s timeout per request, one automatic retry on 429/5xx, and per-source status (
ok/error/ candidate count) reported honestly for every reference. - Strict verdicts, honest reporting —
foundrequires strong two-sided title overlap, year within ±1, and a first-author match (when the candidate carries author metadata);partial= a plausible real record exists but details differ (⚠ verify by hand);not_found= no close record in any of the three indexes (≠ fabricated — old journals, internal reports, theses, and many Chinese journals simply aren't indexed there);error= every source failed (with the reason). - 8 citation styles + BibTeX, auto-detected — per-line heuristics: GB/T 7714 via its
[J]/[M]/[D]document-type markers, IEEE via[n]numbering + quoted title, APA viaLast, F. (Year). Title, Harvard via single-quoted titles, Vancouver/ACS via their author-block shapes; the corrected citation is emitted in that entry's detected style (full author list, volume/issue/pages, DOI), numbered to match, drop-in replaceable. - Whole paper files —
.pdfgets its text layer extracted and the References section located automatically (heading scan from the end of the document);.bibparsed by brace depth;.textakes thethebibliographyblock or the.bibfiles named by\bibliography{...}; other text is read as UTF-8 with an automatic GBK fallback for Chinese Windows files. - Bounded — checks the first 50 references by default (hard cap 200); truncation is flagged in the result.
Install
npm package: dsh-reference-checker. Prebuilt packages: GitHub Releases.
# from GitHub (--profile selects the target profile)
dsh plugin --profile web add github:Yu-tao-Li/dsh-reference-checker
Restart dsh web (or the dsh process); reference_checker is then available in every session.
The bundle resolves by package name (
cordis.patch.ymlis a single mount line), so it installs into any profile /$DSH_HOME— no hardcoded paths.
Usage
Just tell the agent "check whether the references in paper.pdf are real" and hand it the file — or paste a reference list. Tool parameters:
| Parameter | Description |
|---|---|
path |
File path: .pdf / .bib / .tex / .txt / .md / other text; relative paths resolve against the session workspace |
references |
Pasted text: one citation per line (any common style), or a full BibTeX document |
maxRefs |
Upper bound (default 50, hard cap 200) |
Verdict legend:
| Status | Meaning |
|---|---|
✅ found |
A real record with a near-identical title exists (±1 year, author matches), with full bibliographic details |
⚠️ partial |
A plausible real record exists but details differ (moderate title overlap) — verify by hand |
❌ not_found |
No close record in any of the three sources — not a fabrication verdict (unindexed publications also miss) |
⛔ error |
All source lookups failed for this entry (with the reason) |
Every found/partial entry carries best (the closest real record: title / year / venue / volume / pages / DOI or URL) and corrected (the normalized citation in the input's style).
How it works
reference_checker (model tool, in the DSH host process)
│
├─ extract .pdf → pdf-parse text layer + References-section location
│ .bib → brace-depth parser .tex → thebibliography / \bibliography
│ text → References/Bibliography section, else line-by-line
│
├─ per reference (concurrency 4):
│ ├─ Crossref bibliographic query
│ ├─ OpenAlex open-scholarly search
│ └─ arXiv preprint API (English titles only)
│
├─ score 0.72 × title-token overlap + 0.18 × year + 0.10 × first author
│ found = total ≥ 0.80 AND title overlap ≥ 0.75
│ AND year gap < 3 AND no definite author mismatch
│
└─ emit verdict + closest real record + corrected citation in the input style
(structured JSON + human-readable report)
Design details (title-guessing heuristics, scoring math, pitfalls) are in docs/dev-notes.md.
Safety & limitations
not_found≠ fabricated — publications not indexed by Crossref/OpenAlex/arXiv (old journals, internal reports, theses, many Chinese journals) are equally unfindable. The report always attaches the closest real record (with DOI/URL); open it and verify before concluding anything.- Scanned PDFs (no extractable text layer) are refused explicitly — provide a text-based PDF or paste the references instead.
- Public-API etiquette — the tool queries three public bibliographic services; 50 references per call by default. Use it in moderation, not in loops.
- Read-only — the plugin only reads the file you hand it; it writes nothing. Network access is limited to the three index APIs.
- Node ≥ 22, cross-platform, no native dependencies.
Development
lib/host.mjs the whole plugin: extraction + verification + styles (single-file ESM)
test-smoke.mjs offline: minimal PDF generation → text extraction → 4 source parses
test-regression.mjs offline: tool schema, Vancouver parsing/titles, mocked lookups
test-e2e.mjs online: 9 mixed-style references against the real APIs + assertions
scripts/make-screenshot.ps1 regenerate the README sample screenshot (Windows PowerShell + GDI+)
docs/dev-notes.md design rationale, scoring math, pitfalls, version history
npm install # fetch pdf-parse
npm test # offline regressions + PDF smoke test
node test-e2e.mjs # online (needs internet access to the three indexes)
CI (.github/workflows/ci.yml) runs offline regressions and PDF smoke tests on Linux / Windows with Node 22 / 24 for every push/PR; the online e2e is local-only (it depends on the public bibliographic APIs).
1.1.1 fixes
- Register tool parameters as an object JSON Schema, fixing model requests rejected with HTTP 400.
- Split pasted Vancouver citations with comma-separated years and volumes, while retaining wrapped author lists.
- Strip Vancouver author blocks before title queries and preserve periods inside abbreviations such as
et al.,e.g.,Jr., andFig..
See issue #1.
License
MIT — see LICENSE. The single runtime dependency pdf-parse (MIT) is documented in THIRD_PARTY.md.
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37587
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37004
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8181
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5867
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2153
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 1490
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.

Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.