PROJECT TOPICS

项目标签

dsh-plugin

PROJECT README

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

📌 路线图

[x] 第一期：PDF 阅读 + 高亮 + 发对话 + 持久化（2026-08-18 应用内验证通过）
[ ] 第二期：书本相关对话自动笔记总结（session/event + ctx.llm）
[ ] 第三期：阅读进度（章节勾选 / 进度条 / 复习清单）

📄 License

MIT

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。