← 返回列表
⚠ 装前注意
dsh-reader · DSH Web GUI 在线小说阅读器
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/1 · 已提供中文文档
dsh Web GUI 的浏览器内小说阅读器：在线书源搜索、以聊天式视图逐章阅读，以及整本书 TXT 下载。
综合分
29.4
GitHub 分
29.4
用户评分
—
★ Stars
2
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add Wodexinhaoleng-Kasssa/dsh-reader未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · browser
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 24 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/21（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@Wodexinhaoleng-Kasssa/dsh-reader（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 19:19:29
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-reader · DSH Web GUI 在线小说阅读器
侧边栏「阅读器」入口：在线书源搜索 / 章节抓取 / 整本下载到本地（TXT），
阅读界面伪装成聊天对话框——小说章节以一条条对话消息呈现，输入框支持
指令（下一章 / 目录 / 下载 / 设置字号…）。
功能
- 在线书源：内置 41 个书源（合并自 binbyu/Reader 的 bs.json
与 v2.0.0.4 发布包 .bs_bak.json），支持 HTML XPath 与 JSON 路径两种规则、
UTF-8/GBK 编码识别、章节/内容分页、广告文本过滤。
实测可用（2026-08）：必去小说（1008 章，正文干净）、玄幻阁（1002 章）、狗狗书籍（1005 章）、
阅读库 / 笔趣阁yingsx / 蚂蚁文学 / 零零小说 / 唐三中文 / 晋江文学城 等。
- 搜索：输入书名 → 多书源并发搜索 → 结果以可点击的消息卡片展示。
- 阅读：点书即读，章节正文作为「对话消息」呈现；下一章 / 上一章 / 第N章 / 目录。
- 书架：IndexedDB 保存书籍与章节缓存，离线可读；进度自动记忆。
- 下载：整本抓取拼接为 TXT（UTF-8 BOM），保存到本地（默认 ~/Downloads/dsh-reader），带进度消息。
- 书源管理：规则在 lib/bsdata.js 中增删；参考原版 doc/bs.md 配置说明。
本地验证（开发者）
书源可用性测试（会实际请求各书源，需联网）
node scripts/test-sources.mjs 雪中悍刀行
可用源的章节+正文链路测试
node scripts/test-chapters.mjs 雪中悍刀行
集成测试：临时 http server 挂 /api/dsh-reader 全链路
node test-integration.mjs 雪中悍刀行
书源合并脚本：node scripts/merge-bsdata.mjs（读取 v2.0.0.4 的 .bs_bak.json + GitHub bs.json 重新生成 lib/bsdata.js）。
🚀 安装
前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。
支持的 DSH 版本：0.1.0-rc.8 及以上（RC 系列；已在 rc.8 环境实测通过）。
方式一：插件市场一键安装（推荐） 🎉
已收录于 awesome-dsh-plugin（usage 分类）：
- 在 DSH 的 dsh-market 插件市场搜索 dsh-reader 即可一键安装；
- 或直接访问收录条目：https://github.com/awesome-dsh-plugin/awesome-dsh-plugin
方式二：命令行安装
dsh plugin --profile web add github:Wodexinhaoleng-Kasssa/dsh-reader
- 首次安装若被 pnpm 11 拦截构建脚本（依赖写入成功但提示 build 未放行），执行：
cd ~/.dsh/profiles/web && pnpm approve-builds --all
然后重跑一次上面的 add 命令即可。
- 装完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到左侧边栏的「阅读器」入口（DSH 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。
本插件暂未发布 npm；发布后可直接 dsh plugin --profile web add @Wodexinhaoleng-Kasssa/dsh-reader。
方式二：让 DSH 自己装
把下面这段提示词发给任意一个 DSH 会话：
帮我安装 dsh-reader 插件（DSH Web GUI 在线小说阅读器），步骤：
1. 执行 dsh plugin --profile web add github:Wodexinhaoleng-Kasssa/dsh-reader
2. 若被 pnpm 拦截构建脚本，在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all 并重跑 add
3. 完成后提醒我硬刷新浏览器（Cmd/Ctrl+Shift+R）
开发/源码方式
dsh plugin --profile web add link:
注意：本插件已内置"双重启用自防御"（即使被同时加入 bundles 与插槽，也不会因重复路由导致 dsh web 崩溃），但正常安装仍应只保留一个启用入口。
架构
- lib/index.js — host 半身：注册 /api/dsh-reader 路由（loopback-only）。
- lib/engine.js — 书源引擎：node fetch 抓取（规避浏览器 CORS）、编码识别、XPath/JSON 提取。
- lib/xpath.js — XPath 子集（//、[@attr='v']、[position()>1]、/@href、| 联合）+ JSON 路径。
- lib/bsdata.js — 内置书源数据（原版 bs.json 移植）。
- lib/downloads.js — 整本下载任务（进度/取消/写盘）。
- lib/client.js — 浏览器半身：侧边栏入口 + 聊天伪装阅读 UI + IndexedDB 书架。
API
| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /api/dsh-reader/sources | 书源列表 |
| POST | /api/dsh-reader/search | {keyword} → 多源搜索结果 |
| POST | /api/dsh-reader/chapters | {source,url} → 章节列表 |
| POST | /api/dsh-reader/content | {source,url} → 单章正文 |
| POST | /api/dsh-reader/download | 创建整本下载任务 → {taskId} |
| GET | /api/dsh-reader/download?id= | 任务进度/结果 |
| POST | /api/dsh-reader/download/cancel | 取消任务 |
致谢与版权
本项目功能思路参考 binbyu/Reader（win32 小说阅读器，
MIT 协议之外的作者自有版权声明：分享/推广需注明出处、严禁非法与商业用途）。
本插件未复制其任何 C++ 源码，全部代码为 TypeScript/JavaScript 独立重写；
内置书源规则数据（xpath 配置）来自其公开的 bs.json / .bs_bak.json，仅作学习参考。
本插件为免费开源的非商业用途软件，遵守原作者“注明出处、禁止商业用途”的要求；
若原作者对书源数据的使用有异议，请联系移除。
免责声明
书源网站随时可能失效/改版（原版 README 同样警告）；内置书源仅为功能演示，
请尊重各网站版权，下载内容仅限个人学习使用。