dsh-read

Usage

Settings → 阅读中心 (the reading centre)

Open 设置 at the foot of the sidebar, then pick 阅读中心 — the row whose icon is a book rather than the shell's generic gear. It lives here instead of as a tab beside 对话 / 轨迹, so the conversation header stays down to the two views that belong to a session.

• The directory bar shows the library root the plugin remembers, and it is refilled every time the page opens. Type any absolute path and press 加载 to switch — that directory becomes the primary library root and is remembered from then on.
• Subdirectories are listed first, so you can walk down to where your books live.
• Every book shows its format, size and progress (已读 5.9% · 第 124 / 2083 段, or 未开始).
• 开始阅读 / 继续阅读 runs the same /read command in the session the shell currently has selected, then closes settings so you land on the card, resuming from the saved paragraph.
• 设置进度 opens a slider under the book so you can move its position anywhere — for a book you already read on paper, or one you want to skip around in. The label tracks the exact paragraph and percentage while you drag. A book that was never opened has no paragraph count yet, so the page parses it first and then shows the slider.
• 重置进度 clears one book's position.

The /read command

The reading centre is a convenience over the command — both do exactly the same thing.

/read ~/Books/三体.epub      # an explicit path
/read /Volumes/library/Dune.mobi
/read 三体                   # a keyword, resolved against the library roots

A keyword is matched against file names under the library roots (the 阅读 tab manages the primary one; the rest stay available for search). Defaults are ~/Books, ~/Documents/Books, ~/Downloads and ~/Documents; only directories that exist are used. You can also edit:

// $DSH_HOME/dsh-read/config.json   (usually ~/.dsh/dsh-read/config.json)
{ "libraryRoots": ["/Volumes/books", "~/Calibre Library"] }

Or just ask the agent in natural language — it can call book_search and hand you the path:

帮我找一下《三体》 → book_search({ "query": "三体" }) → /Users/you/Books/三体.epub → then /read /Users/you/Books/三体.epub