Plugin directory / Developer / dsh-book-reader
dsh-book-reader
Verified · install-tested on dsh davidwellscn-maker
What it does
A plugin in the Developer category for DeepSeek Harness.
Works — verified, early-stage project
A plugin in the Developer category for DeepSeek Harness. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
📚 dsh-book-reader
DSH（DeepSeek Harness）读书工作台插件——第一期 MVP。
✨ 功能
- 📚 读书 tab：better-sidebar 侧边栏新增「+」→「📚 读书」，内嵌 PDF 阅读器
- PDF 阅读：react-pdf-viewer 渲染（翻页 / 缩放 / 页码显示），打开任意
.pdf也会走本阅读器 - 💛 高亮标注：选中文字 → 浮动按钮「💛 高亮」→ 可选批注 → 保存；点高亮删除
- 📤 发到对话：选中文字 →「📤 发到对话」→ 自动追加进输入框（带路径 + PDF 页码引用）
- 💾 持久化：标注存到书目录
.book-reader/annotations.json，重启不丢 - 🔍 自检：tab 顶部状态条实时显示插件加载 / 路由连通状态
🛠️ 技术栈
| 组件 | 说明 |
|---|---|
@react-pdf-viewer/core + highlight + page-navigation + zoom |
开源 PDF 渲染/高亮（Apache-2.0） |
dsh-better-sidebar |
侧边栏服务（registerTab / registerFileViewer） |
| Host 路由 | /reader/api（标注读写）、/reader/worker（pdf.js worker） |
🏗️ 开发
pnpm install # 装依赖（用 workspace 内 store/cache）
pnpm build # 产出 lib/（host + client + worker）
pnpm typecheck # TS 类型检查
📦 安装到 DSH
# ① GitHub 仓库安装
dsh plugin --profile desktop add github:davidwellscn-maker/dsh-book-reader
# ② npm 安装（发布后）
dsh plugin --profile desktop add dsh-book-reader@latest
# ③ 本地打包安装
pnpm pack && dsh plugin --profile desktop add dsh-book-reader-*.tgz
装完完全重启 DSH Desktop（⌘Q 退出再打开）——Host 端新路由需要重启加载。
📦 换机迁移与分发指引见 docs/换机迁移与分发指南.md
🗂️ 数据位置
- 标注：
<书目录>/.book-reader/annotations.json - 默认书籍：
/Users/mac/Desktop/DSP/学习/AI-Agents-in-Depth-zh-CN.pdf
📌 路线图
- 第一期：PDF 阅读 + 高亮 + 发对话 + 持久化（2026-08-18 应用内验证通过）
- 第二期：书本相关对话自动笔记总结（session/event + ctx.llm）
- 第三期：阅读进度（章节勾选 / 进度条 / 复习清单）
📄 License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-book-reader for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:davidwellscn-maker/dsh-book-readerHeadless (CLI) profile:
dsh plugin --profile headless add github:davidwellscn-maker/dsh-book-readerTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-book-reader/)<a href="https://dshbase.com/plugins/dsh-book-reader/"><img src="https://dshbase.com/badges/dsh-book-reader.svg" alt="dshbase install-tested"></a>