dsh-bookweave
DeepSeek Harness 的 EPUB 阅读器插件：书架、摘录、包含所有提及书名的书目，以及带有来源链接卡片的 AI 章节指南。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:adrianwang99/dsh-bookweave#5c2d0dbcabb139a806fdec836dd3384fb7b22f23Bookweave 以 dsh-bookweave 发布，当前版本为 0.10.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Read EPUBs inside DSH, discover every book they cite, and let an AI guide you through the chapters.
English | 中文
BookWeave is a DeepSeek Harness (DSH) Web client plugin. It turns the sidebar into an EPUB reading workspace: a shelf, a distraction-free reader, excerpts, a network of every book mentioned in the text, and an AI-assisted book guide that summarises a chapter and turns its claims and evidence into clickable cards backed by the original paragraphs.
Everything is local-first: EPUBs, excerpts, reading progress and AI results live in your browser's IndexedDB. The only network call is the optional "Analyze chapter" request to your configured model provider.
| Shelf | Import .epub by click or drag & drop; 2:3 portrait covers extracted from the EPUB; book title, author and reading percentage only. |
| Reader | Serif prose, adjustable font size, collapsible TOC, chapter navigation, remembered progress. No fixed header — the reading area and the right rail both start at the top of the window. |
| Book list | Extracts every book the current book mentions: 《》 titles, English “quoted title” cues and a curated lexicon, with noise filters (self-references, TOC, chapter headings, periodicals). Each entry links back to the paragraph where it appears. |
| Excerpts | Select text → red underline + excerpt card with an optional note; click an excerpt to jump back to the exact paragraph. |
| Book guide | A right-rail tab, left of Excerpts: it opens on the chapter you are currently reading and follows TOC / prev-next / locate jumps. Chapter picker, AI-generated chapter summary, and cards ordered by where they appear in the text. Claims render as an argument chain: the conclusion at the top, an up-arrow labelled “because”, then the reasons/examples/data beneath, each tagged with its relation. Every node shows an “original” excerpt and highlights/flashes the source paragraph on hover/click. |
| AI analysis | One explicit button per chapter. Fiction → plot summary in the book's own voice + plot beats; nonfiction → claims + evidence. Input is compressed to ≤6–8k characters, output ≤700 tokens, lowest reasoning effort, cached per book/chapter, never re-billed unless you press “Analyze again”. |
| Book search | From a book-list entry, open an in-plugin browser panel pre-filled with a configurable search URL (default: Open Library). Edit the template under Book list → Search source; use {query} for the title, and any search provider works. |
| Export | Export the whole book list as Markdown. |
| i18n | Chinese and English UI. |
Requirements — a DeepSeek Harness build with the Web UI. The AI half additionally needs the Host llm service (any provider that DSH can already call); without it, reading, excerpts, book lists and the heuristic guide still work.
dsh plugin add github:adrianwang99/dsh-bookweave
dsh plugin add dsh-bookweave
git clone https://github.com/adrianwang99/dsh-bookweave.git
cd dsh-bookweave
dsh plugin add .
Or, if you manage the profile manually, symlink the checkout into the profile and add a link: dependency:
ln -s "$(pwd)" ~/.dsh/profiles/desktop/node_modules/dsh-bookweave
# then add "dsh-bookweave": "link:<absolute path>" to the profile package.json
Restart DSH (⌘Q on macOS) after installing or updating the Host half (index.js); client-only changes are picked up by a page refresh.
The package declares the standard manifest:
{
"dsh": {
"bundle": { "patch": "./cordis.patch.yml" },
"client": { "platform": "web", "immediately": true }
}
}
POST /api/dsh-bookweave/analyze to its own DSH host, which forwards the prompt to your configured model provider.DSH_BOOKWEAVE_MODEL=provider/model before launching DSH to pin a cheaper model for analysis.IndexedDB database dsh-bookweave (version 3): books, index, excerpts, insights.
Deleting a book removes its text, book list, excerpts and AI results. Nothing leaves the machine except the opt-in model request.
git clone https://github.com/adrianwang99/dsh-bookweave.git
cd dsh-bookweave
npm test # core + archive + structure + host suites (Node only, no dependencies)
npm run check # syntax check the client and host halves
The suites run in plain Node (≥20) without a browser, React or npm dependencies. They load client/client.js through the same window.__ModuleLoader__ seam the DSH Web client uses, and exercise the plugin.core exports plus a fake host-side LLM for the AI route. See test/README.md.
Optional real-book smoke tests are skipped unless you point at your own EPUBs:
BOOKWEAVE_SMOKE_ZH=/path/to/zh.epub BOOKWEAVE_SMOKE_EN=/path/to/en.epub npm test
.
├── client/client.js # everything UI + core (EPUB parsing, extraction, guide, AI client)
├── index.js # Host half: /api/dsh-bookweave/analyze (LLM call, prompt, normalisation)
├── cordis.patch.yml # bundle patch: registers the plugin row
├── locale/{zh,en}.json # plugin metadata strings
├── icon.svg # sidebar icon
├── plugin.json # marketplace metadata (deepseek.stream upload)
├── test/ # node-only suites + synthetic EPUB fixtures
├── docs/PUBLISHING.md # npm / awesome-dsh-plugin / WhaleHub / deepseek.stream guide
└── marketplace/ # ready-to-submit community marketplace entries
MIT © 2025 adrianwang99