前言¶
在 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 倉庫。
