📚 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