
xiehuan123/dsh-deepread
dsh-deepread
Evidence-first reading for AI agents — turn articles, books and PDFs into traceable claims, evidence, source locations and knowledge maps.
Install
npx @deepseek-ai/dsh plugin --profile web add dsh-deepreadRestart `dsh web` after install. Bundle APIs can change during the developer preview.
README badge
[](https://dshhub.dev/plugins/dsh-deepread)Paste this into your README. The star count updates with every catalog sync.
From the README
Excerpt from xiehuan123/dsh-deepread, cleaned of badges and images.
📖 DeepRead — Make AI reading traceable
Website · Real outputs · English · 中文
Turn articles, books, PDFs, and document sets into claims you can trace back to evidence and source locations.
DeepRead is available in two compatible forms:
- Portable Agent Skill for Codex, Claude Code, and other Agent Skills-compatible tools. Zero runtime dependencies; the agent follows the evidence-first reading workflow with its own file and web tools.
- Host plugin package for DeepSeek Harness Web/headless and dsh-TUI, with a
deepreadtool, PDF extraction, optional persistence/jobs/Web route, batch comparison, cost preview, and HTML/XMind-compatible export. Its browser client is an optional Web-only entry.
Why it is different
| A typical summary | DeepRead |
|---|---|
| Compresses the topic | Extracts complete claims and the reasoning behind them |
| Blends source facts with model inference | Labels author intent, source facts, reasoned inference, and unverified content |
| Makes conclusions hard to check | Pairs important claims with evidence and page/paragraph locations |
| Stops at an answer | Adds knowledge maps, conflicts, limitations, and active-recall questions |
If the source does not support a claim, DeepRead says “source does not provide evidence” instead of filling the gap.
<br> <sub>The real DeepSeek Harness Web reading panel. The portable Agent Skill uses the same evidence-first workflow without this runtime UI.</sub>Quick start
Portable Agent Skill
npx skills@latest add xiehuan123/dsh-deepread
Then ask your agent:
Deep-read docs/architecture.pdf in knowledge-map mode.
For every important claim, show the supporting evidence and source location.
Full DeepSeek Harness plugin
dsh plugin --profile web add dsh-deepread
If pnpm reports ERR_PNPM_ADDING_TO_ROOT, retry with the profile workspace made explicit:
dsh plugin --profile web add -w dsh-deepread
Restart dsh web, then use the 📖 reading panel or call the deepread tool in chat.
See real outputs
These are complete reports generated from public articles, not hand-written mockups:
| Report | What DeepRead made visible |
|---|---|
deep · Claude Code token optimization | Reconstructed the engineering chain from visibility to input, output, and retrieval-path compression; separated recommendations from project-authored benchmarks. |
map · Marketing-claim fact check | Found that the article's “90%”, “¥1.28M salary”, and “¥2,000/day” claims had no source, sample, or baseline; marked each one unverified. |
deep · vivo Tauri architecture | Connected architecture choices to reported size/performance evidence while preserving the article's untested assumptions and deployment limits. |
Browse all reproducible examples →
Features
…


