前言¶
在 DeepSeek Harness (DSH) 的开发环境中，切换到外部阅读器阅读本地书籍会打断工作流。本插件在 DSH 界面右下角提供一个悬浮球，用于管理本地书单，并支持将阅读器窗口自动归位到预设位置，减少界面切换的干扰。
插件介绍¶
unsiscon/dsh-novel-launcher 是一个运行在 DSH 客户端环境的插件。它解决了在智能体开发间隙进行阅读的场景需求，支持本地书库扫描和多方式搜索，不涉及网络小说抓取，数据完全本地化。
核心功能¶
- 右下角悬浮球：常驻界面右下角，不占布局，点击展开书单。
- 本地书单扫描：扫描指定书库目录，列出支持的电子书格式。
- 三路搜索：支持中文（
魔界）、全拼（mojie）、首字母（mjd）搜索书名。 - 继续读：顶部显示上次阅读进度，点击可快速跳转。
- 窗口归位：使用外部阅读器打开书籍后，窗口自动搬移到预设位置，并收起旧窗口。
- 主题跟随：自动适配 DSH 的明暗主题。
- 自动关闭：支持点击外部区域、按 Esc 键、选书后自动收起书单。
安装与启用¶
使用官方 CLI 安装：
dsh plugin --profile web add github:<you>/dsh-novel-launcher
安装后需重启 dsh web 并刷新浏览器，右下角会出现悬浮球图标。
典型用法¶
- 配置书库：首次点击悬浮球会自动进入设置页，需指定书库目录和阅读器配置（进程名、Bundle ID、.app 路径）。
- 检索书籍：在悬浮球面板中输入书名，支持中文、拼音或首字母搜索。
- 继续阅读：点击顶部“继续读”条目，直接打开上次阅读的书籍。
- 归位窗口：点击书单中的书籍，通过配置的阅读器打开，插件会自动将窗口移动到预设位置。
适用场景与注意事项¶
- 平台差异：悬浮球、搜索和书单功能支持所有平台；窗口归位和拼音搜索仅支持 macOS，需要系统“辅助功能”授权。
- 隐私安全：纯本地运行，不上传任何数据。配置文件位于
$DSH_HOME/novel-launcher/config.json。 - 功能限制：不支持抓取网络小说，需使用本地阅读器。窗口归位功能在 Windows/Linux 平台上会自动隐藏。
架构说明¶
插件采用双半体架构，通过 HTTP 通信：
* Host 半体：负责目录扫描、拼音计算、阅读器数据库探测和窗口助手管理。
* 浏览器半体：负责悬浮球 UI 和书单交互。
短结尾¶
该插件为 DSH 用户提供了低打扰的本地阅读集成方案。更多细节可参考 GitHub 仓库。
