dsh-novel
キュレーションリスト掲載メンテナンス: 活発xrn1997/dsh-novel
DeepSeek Harnessに小説閲覧機能を埋め込み、作業中の眠気対策に使えるプラグインです。
$ dsh plugin add dsh-novel5
スター
1
フォーク
TypeScript
言語
Apache-2.0
ライセンス
2026-09-14
作成日
2026-11-20
最終プッシュ
README
dsh-novel
在 DeepSeek Harness(DSH)里读网络小说。 导入 legado 书源,聚合搜索或按分类逛书城,把书加入书架,连续滚动阅读,也能让它念给你听。它还有本地 TXT / EPUB、中英界面和六个 dshnovel_ AI 助手工具——找书、读章、管源都可以在对话里完成。

书城:左边选源、展开它自己声明的分类,右边是该类的书单——顺序都听源的,不跨源合并(书源与书目均为示意数据)。
目录
功能
左侧栏「小说」是一个全局面板,三个并列 tab:书架 / 书城 / 书源管理。界面、探针与 AI 工具共用同一条链路。
书源:导入、去重、体检

书源管理:待办置顶坏源 / 未验证源,过滤、启停、AI 搜索标记、试跑和批量操作都在这一页(书源名称、地址与数量已脱敏)。
拖入 / 多选 / 粘贴 legado 书源 JSON,导入在后台跑,按地址自动去重。新源先标「未验证」,「待办」把坏源和未验证源置顶,一键验证或批量重验;平时可过滤、启停、标记 AI 搜索源、试跑、录入 cookie 或执行 loginUrl 脚本。
找书:聚合搜索 + 按源逛书城
书架顶部一次搜索所有源:结果边搜边出、可停止,按(书名,作者)归并,相关结果优先,失败源逐家点名。书城则按每个源自己声明的分类浏览,点书可读、加架,或去其他源找同名书。
书架与阅读:连续滚动,进度自动保存
书架按最近阅读排序,可按在读 / 未读 / 本地筛选,每本书标来源,支持批量删除。阅读器连续滚动、自动预取下一章,字号 / 行距 / 栏宽 / 纸张色可调,支持范围导出 TXT。

书架:按最近阅读排序,顶部可在读 / 未读 / 本地筛选,末位是本地书导入入口(书名与进度为示意数据)。

阅读器:连续滚动、自动预取与顶部工具栏;顶条「听书」可直接开始朗读(示例正文)。
听书:从阅读位置起播,跨界面续听
阅读器顶条点「听书」即从此刻看到的那一段起播;正文里选中一段可「从本段听」,设置面板里也能直接选起播章。阅读器内的听书条负责上一段 / 下一段、播放暂停、章内段滑杆、语速与定时;设置面板换引擎、音色、音量与起播章。正在念的段在正文里换字色、段首点一枚小三角;听书推进时正文跟着走(当前段离开可视区才滚),读者自己滚动或点目录 / 内链后跟随让位,按条上的「定位到正在念的段」重新接上。

阅读器听书:条上是上一段 / 暂停 / 下一段、章内段滑杆、语速与定时;正在念的段换字色并在段首点一枚小三角(示例正文)。
离开阅读器后,浮在屏幕上的听书胶囊继续带着这本书:点开是能读整段的边栏,可暂停、跳段、拖章内进度、调语速与定时,或回阅读器;胶囊可拖到任意位置、靠近边缘松手自动贴边,展开后宽高可调,位置与尺寸留在本机。

书架听书:卡片显示共用的消费进度,「正在听」标播放层此刻在放的那一本;浮窗边栏可暂停、跳段、拖章内进度、调语速与定时或回阅读器(示意数据)。
听书与阅读共用一条进度:听到哪,书架与下次开书就恢复到哪;书架卡片只显示这一条进度,正在播放的那一本标「正在听」。音色、语速与音量按书记住。
引擎源分四类:内置朗读开箱即用、只合成中文、没有音色可选;浏览器本地语音用设备系统语音直接出声,不走网络合成;订阅引擎导入 legado HttpTTS 订阅(粘贴 JSON 或从 URL 拉取),导入回执按条点名坏条,坏条只剪自己;dsh-xiaomi-tts 只在宿主装有该插件且已配好供应商时列出(该插件是独立的第三方插件,装法见 npm)——装了但没配好时引擎管理里留一行灰显,写明未就绪与原因码,不会让你选到一个每段都失败的口子上。语速与音色按引擎能力分工:能应用服务端语速的源由引擎自己念,念不到的那一截由播放端补,滑杆上写的就是你实际听到的速度;跳段、停止与关页都会让在途合成停下,不再为没人听的内容继续合成。订阅与登录态只留本机:tts-engines.json 存订阅,登录态只写不读、导出不带;订阅自带的 header 原样保留——若把密钥写进 header,导出的 JSON 里就有那把密钥。
本地书、AI 与界面
TXT / EPUB 直接进书架,有损导入会留下可回看的「导入说明」(格式与边界见 本地书格式)。六个 dshnovel_ 工具覆盖搜索、读章、目录、书架、书源管理和导入(详见 AI 助手工具);界面中英双语,运行参数在插件页改完即生效。
安装
插件装进哪个 profile,就在那个 profile 里生效——本插件不绑定宿主的发行形态,只认 DSH 的插件生态。
本插件声明 engines.node >= 24(事实源住 package.json;从源码装时构建链同样要求该版本)。
dsh plugin --profile <profile> add @xrn1997/dsh-novel
重启宿主后,左侧栏出现「小说」全局面板入口(图标行;点击即在中央面板打开书架 / 书城 / 书源管理 tab)。侧栏入口需要宿主提供 slots / layout 的界面 bundle;不带它的 profile 只挂 Node 半与 AI 工具,界面上不会多出入口。
三种装法:
- npm 安装(推荐):使用预构建产物,秒装、无需构建授权。
- GitHub Release 装(不碰 npm registry,也不需要构建工具链):发版工作流在
V*tag 上产出预构建 tarball。装最新 Release:dsh plugin --profile <profile> add https://github.com/xrn1997/dsh-novel/releases/latest/download/dsh-novel.tgz钉版本就换成https://github.com/xrn1997/dsh-novel/releases/download/V<版本>/xrn1997-dsh-novel-<版本>.tgz;tarball 自带lib/,装的是预构建产物,宿主能否挂载仍由兼容闸与真机验证决定。Releases 页还没有对应版本时,用 npm 或源码装。 - 从源码装:本包没有
prepare,从远端源码直装(github:/git:形态)不会自动构建,装出来缺lib/会被宿主拒绝挂载——Release 资产是另一条路,不改变这条。要先从 GitHub 或 GitCode 克隆仓库并pnpm install && pnpm build,再用dsh plugin --profile <profile> add link:<克隆目录>挂载。
卸载:
dsh plugin --profile <profile> remove @xrn1997/dsh-novel
宿主兼容声明分两层:安装许可由 package.json 的 peerDependencies 决定——宿主 dsh plugin add 会拿运行中的宿主版本逐个比对插件的 @deepseek-ai/dsh* peer 区间,不满足即 installation rejected。实测记录写在 dsh.compatibility.dshReleases,只列真跑过的宿主版本:DSH 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.5、0.2.2-rc.1、0.2.2-rc.3、0.2.2-rc.5(这一行是给人看的记录,文档门会核对它与 package.json 一致;安装许可与实测名单两层的关系见 ADR-0020)。宿主发版与 peer 区间的维护流程、发布冷却闸见 docs/development.md。
首次使用
- 导入书源:「小说」→「书源管理」tab → 选择
.json文件(可多选,选中即开始导入)或粘贴 legado 书源 JSON。导入是服务端后台任务,关页面不打断;同址自动去重(已有可用源则跳过,坏源 / 未验证源被新条替换)。 - 批量验证:导入不逐条探针(新源状态为「未验证」)——顶部待办收件箱把坏源 / 未验证置顶成任务卡,「一键验证」「批量重验」即点即跑;任意集合(过滤 + 编辑态勾选 +「验证所选」)同样可发起,后台并发 5 路限流。
- 选择 AI 搜索源:AI 工具不会自动搜全部启用源——在书源管理的「AI」列逐源标记,或在编辑态勾选后点「加入 AI 搜索」;状态下拉选「AI 搜索源」可复核这批源。新导入与升级前的存量源默认不参与 AI 搜索(重导入保留已标记),界面搜索不受影响、仍按启停走。
- 找书读:「书架」tab 顶部搜书名 / 作者 → 点封面进阅读器。不在书架上的书离开时会先问是否加入,加入后进度自动记住。想按分类逛就走「书城」tab:先在左栏点一个源,再点它自己声明的那几类。手上已有文件就走书架末位的导入本地书籍(TXT / EPUB)。
- 让 AI 助手干活:对话里直接说「帮我找一本《XX》读第三章」「看看 XX 书源为什么坏了」。
AI 助手工具
おもしろ系 の他のプラグイン
dsh-pet
by pc2005-cloud
DSH Web デスクトップペット:51 透明 webm アニメ、画面漫游、クリック/ドラッグ。プロンプト+AI 動画で自作も可
dsh-tavern
by flizzywine
SillyTavern 風文字ゲーム Agent。候補生成、角色卡編集、剧本モード
dsh-dafeiyu
by qcytsn
DeepSeek Harness 向け Windows 常時最前面の BigFish デスクトップコンパニオン。リアルな Agent ステータス表示
dsh-meme
by yyh-001
チャットミームスタンプ:QQ/WeChat 風ピッカー、自動学習、カスタムパック
