前言¶
在 DeepSeek Harness（DSH）里查资料、对回复时，正文往往还在外面的 PDF、EPUB 或 Markdown 里。反复切窗口复制，既打断思路，也容易漏掉上下文。若能在客户端右侧栏直接打开常见文档，划词后翻译、解释、总结或发到输入框，阅读与对话可以在同一界面完成。下面介绍的 Side Reader（包名 dsh-side-reader）就是面向这一需求的客户端插件，由维护者 kaiqiangzhao 发布在 SkillHub 目录 与 GitHub。
插件定位¶
Side Reader 是 DSH 的右侧栏阅读插件：在侧边栏上传并打开文件，选中文字后通过工具栏执行翻译、解释、总结、复制，或「发到输入框」。文件解析与批注数据留在浏览器本地，插件说明中明确不写上传文件到服务端。插件类型为 客户端（platform: web，注入右侧栏等 UI）；package.json 要求 DSH 引擎版本 >=0.2.1-rc.5，当前包版本为 1.0.0，主许可证为 MIT。
支持的格式与阅读能力¶
通用¶
- 支持 PDF、EPUB、Markdown、TXT、XLSX、CSV（说明中还提到旧版
.xls能打开，但上传框未列出该类型）。 - 上传过的文件保存在浏览器本地，可从历史列表重新打开。
PDF¶
- 缩放、适应宽度，文字可选。
- 划词后可四色高亮，或通过批注按钮高亮并写笔记；点击高亮可改色、改笔记或删除。
- 工具栏批注列表可跳转到对应位置，并可导出带批注的 PDF（标准 Highlight 批注，其他阅读器可见）。
- 高亮与笔记随本地文件记录存在，删除文件时一并清除。渲染与导出分别依赖包内所列的 PDF.js、pdf-lib 等组件。
EPUB¶
- 保留书籍样式与图片，提供目录与字号调节。
Markdown¶
- 可渲染标题、表格、代码高亮、任务列表、脚注等；眼睛图标可切换为带
#的源码视图。 - 不支持数学公式与 Mermaid 图（README 限制节写明）。
表格类¶
- XLSX、CSV 通过 SheetJS CE 等在本机解析后展示（与 README 功能列表一致）。
划词工具栏与自定义¶
选中文字后弹出工具栏，默认提供：翻译、解释、总结、复制、发到输入框。按钮可新增、删除、更换图标、拖动排序，也可折叠到下拉菜单。具体能力取决于你当前 DSH 对话与模型配置，插件侧负责把选中内容送入对应动作或输入框。
安装与启用¶
推荐在 DSH 桌面版 侧边栏打开 Plugins，在 Add plugin 中输入包名 dsh-side-reader，安装后启用；无需命令行，也不必手动填写 profile。
若使用命令行，--profile 为必填，应填 你自己的 profile 名。桌面应用自带的 dsh 命令才允许使用保留名 desktop：
dsh plugin --profile <你的 profile 名> add dsh-side-reader
也可按 DSH 打包与安装文档 从 GitHub 或 tarball 安装；本插件 不需要构建步骤。
装好后，在右侧栏 Side Reader 入口上传文件即可。Side Reader 不接管 *.pdf 的默认打开方式，只通过自身入口打开文件。
典型用法¶
- 在右侧栏进入 Side Reader，从历史或上传框选择 PDF / EPUB / Markdown 等文件。
- 阅读时按需缩放、调节 EPUB 字号，或在 Markdown 渲染与源码之间切换。
- 划词后点工具栏上的「解释」「总结」或「发到输入框」，把片段送入当前对话流程。
- 读 PDF 需要留痕时，用高亮与批注，必要时从批注列表导出带标注的 PDF。
限制与适用说明¶
README 中列出的限制包括：加密（DRM）EPUB、固定版式 EPUB 未测试；Markdown 不支持公式与 Mermaid；.xls 行为见上文。
适用对象：经常在 DSH 里对照长文档、希望划词即用的开发者或重度用户。
安全与权限：插件以当前 DSH 客户端进程权限在本地 Web 环境中运行；安装前可在 GitHub 查看源码与各第三方组件许可证文件（如 LICENSE.pdfjs.txt 等）。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系，安装包名与版本以仓库与目录页为准。
结语¶
Side Reader 把 PDF、EPUB、Markdown 与表格类文件收进 DSH 右侧栏，并在本地完成阅读与划词操作，减少窗口切换。如需安装说明与问题反馈，可访问 SkillHub 插件页 与 GitHub 仓库。
