Back to directory

dsh-deepread

Curated pickMaintenance: Active

xiehuan123/dsh-deepread

Evidence-first reading for AI agents — turn articles, books and PDFs into traceable claims, evidence, source locations and knowledge maps.

View on GitHubHomepage
$ dsh plugin --profile web add dsh-deepread

58

stars

6

forks

JavaScript

Language

MIT

License

2026-08-15

Created

2026-09-11

Last push

MIT-licensed, evidence-first reading plugin that runs as a native DeepSeek Harness runtime: install with `dsh plugin --profile web add dsh-deepread`, restart `dsh web`, and call the `deepread` tool or open the 📖 reading panel to turn any article / PDF into a verifiable note with provenance and an evidence chain.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-03

License

MIT

01What can it help you accomplish?

  • Deep-read articles, books, PDFs and document sets inside DeepSeek Harness and get claims you can trace back to evidence and source locations.

    Per-mode reading reports (quick / deep / map / feynman / book) with claim–evidence pairing, four confidence levels, knowledge maps, citations, and optional HTML/XMind/Markdown export.

    Developers and researchers running DeepSeek Harness (dsh) or dsh-TUI who need verifiable reading output instead of opaque summaries.

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness Web/headless `0.1.0-rc.7` or dsh-TUI `0.8.1`+ (Community Consensus v0.15) installed.
  • Node.js `^22.19 || >=24` (DeepRead 1.0.0 runtime requirement).
  • pnpm on the machine — `dsh plugin` runs pnpm underneath to install plugins.

Installation steps

  1. 01

    Install the plugin into the web profile: `dsh plugin --profile web add dsh-deepread`.

    $ dsh plugin --profile web add dsh-deepread

  2. 02

    Restart DeepSeek Harness: restart `dsh web`, then use the 📖 reading panel or call the `deepread` tool in chat.

    $ dsh web

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DeepSeek Harness runtime via `dsh plugin` (dsh CLI): installs the `deepread` Host tool plus a Web reading panel for `dsh web` / headless, and a dsh-TUI v0.15 Host manifest; the plugin runs the evidence-first pipeline by calling the model directly.

  • DeepRead tool (native DSH Host tool)

    url / path / text + depth mode→evidence-first reading report with claim–evidence pairing and source locations

  • Five reading modes

    article / book / PDF + depth (`quick` / `deep` / `map` / `feynman` / `book`)→mode-specific report (knowledge map, Feynman 11-step loop, whole-book summary, etc.)

  • PDF extraction

    .pdf files→extracted text via built-in pure-JS extractor

  • Export (md / mm / html / all)

    in-session report→files written to `deepread-output/`

  • Batch compare

    2–10 documents via `batch`→per-document summaries + cross-document conflict/complement/synthesis report

  • Cost preview

    mode selection→token spend / model-call / time estimate without calling the model

  • Full-text cache

    fetched article URLs→cached full text reused across modes

    Fetched article full texts are cached to `$DSH_HOME/storages/` (deepread_url_cache domain) and survive process restarts (default TTL 7 days, cap 200 entries)

04Who is it for? When not to use it?

Good for

  • Developers and researchers running DeepSeek Harness (dsh) or dsh-TUI who need verifiable reading output instead of opaque summaries.

Not for

  • DeepRead 1.0.0 requires Node.js `^22.19 || >=24`; install fails on older runtimes.
  • The `dsh plugin` installer needs pnpm on the machine; without it the plugin will not install.

05Compatibility, maintenance and safety notes

  • DeepRead 1.0.0 requires Node.js `^22.19 || >=24`; install fails on older runtimes.
  • The `dsh plugin` installer needs pnpm on the machine; without it the plugin will not install.
  • Fetching WeChat article URLs needs an HTTP provider; if `web fetch service unavailable` appears after install, mount `@deepseek-ai/dsh-web-fetch-http` with a browser User-Agent.
  • Full functionality needs DeepSeek Harness Web `0.1.0-rc.7` or newer; older dsh hosts degrade (no Web route, no browser UI, no budget HTTP route).
2026-08-152026-08-30v1.0.0

MIT · actively maintained (latest release v1.0.0, 2026-08-20)

06Frequently asked questions

How do I install dsh-deepread into DeepSeek Harness?

Run `dsh plugin --profile web add dsh-deepread`, then restart `dsh web`. A 📖 button appears next to the input; click it to open the reading panel, or just ask the agent to deep-read a link or file.

Does it run as a native DeepSeek Harness runtime or just an Agent Skill?

It is a native DSH Host plugin: `dsh plugin` installs the `deepread` Host tool plus a Web reading panel, and a dsh-TUI v0.15 manifest loads `lib/types/index.js`. A separate portable Agent Skill form (Codex / Claude Code) runs the same methodology with zero runtime dependencies, but the DSH plugin runs the pipeline itself.

What inputs and outputs does the `deepread` tool support?

Inputs are a WeChat article URL, a workspace file (`.txt/.md/.html/.pdf`), or pasted text; depth is `quick`/`deep`/`map`/`feynman`/`book`. Output is an in-session report, optionally exported to `deepread-output/` as `.md`, `.mm` (FreeMind/XMind), `.html`, or `all`.

What are the minimum versions I need?

DeepRead 1.0.0 needs Node.js `^22.19 || >=24` and pnpm on the machine (the `dsh plugin` installer runs pnpm). Full functionality needs DeepSeek Harness Web/headless `0.1.0-rc.7` or dsh-TUI `0.8.1`+.

08Data and sources

  • Author-claimedgithub.com36b89114be84…

    **Host plugin package** for DeepSeek Harness Web/headless and dsh-TUI, with a `deepread` tool

  • Author-claimedgithub.com36b89114be84…

    dsh plugin --profile web add dsh-deepread

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.