dsh-reading-companion：本地 TXT 書架 + 不劇透的 AI 陪讀

前言¶

DeepSeek Harness (DSH) 的插件化架構允許用戶針對特定場景擴展功能。針對長文本閱讀場景，尤其是小說閱讀，本地化與隱私保護是核心需求。現有方案多依賴雲端書源或通用聊天，容易導致劇透或數據外泄。dsh-reading-companion 插件旨在解決這兩個問題：提供本地 TXT 書架，並通過三層結構化機制保證 AI 陪讀時不劇透。

是什麼¶

這是一個本地閱讀器與 AI 陪讀工具，由開發者 xling001 維護，採用 MIT 許可證。

定位：給小說讀者的本地閱讀器 + 不劇透的 AI 陪讀。
數據：原書、筆記、AI 理解全部存儲在本地磁盤，無賬號、無雲、無書源。
核心邏輯：它記住的是這本書的上下文與進度，而非單次對話的片段。

核心功能¶

插件提供了從導入、閱讀到筆記導出的全流程工具。

本地 TXT 書架：支持自動探測編碼、自動切章（無標題時降級爲固定塊），在右側欄管理書籍與分類。
不劇透的 AI 陪讀：
- 三層防劇透：
  - 提示詞守則：常駐約束。
  - 路徑閘 (spoilerGate)：硬性拒絕讀取未讀章節的原文工具調用。
  - 聯網閘 (webGate)：啓發式攔截，但無法完全防禦刻意查詢。
- 進度感知：AI 只讀取你當前讀到的章節及之前的記憶。
- 記憶結構化：背景認識（background.md）分區記錄文本類型、人物狀態、世界觀等，只增不減。
結構化筆記系統：
- 流程：摘抄（原文） → 我的感想 → tag（零模型調用建議） → AI 回應。
- 格式：結構化 Markdown。
- 安全策略：只追加，絕不覆蓋已有筆記；導出時帶有  標記，拒絕寫入無標記文件。
交互與導出：
- 滾動閱讀：按進度條滾動閱讀。
- 即時交互：選中正文直接彈出「記筆記」，支持跳回原文。
- 導出：一鍵導出背景與全部筆記到 Obsidian 等筆記庫。

安裝與啓用¶

插件依賴 DSH 客戶端提供的側邊欄接口，無需額外插件前置。

前置要求：
* DSH >= 0.1.5-rc.2
* Node >= 22.19

安裝步驟：
在終端執行以下命令安裝插件：

# DSH Desktop
dsh plugin --profile desktop add "github:xling001/dsh-reading-companion"

# DSH Web
dsh plugin --profile web add "github:xling001/dsh-reading-companion"

安裝完成後，必須重啓 DSH Desktop 才能加載新插件。重啓後，在右側欄「+」中選擇「本地書架」即可進入插件界面。

典型用法¶

導入書籍：將 TXT 文件放入 $DSH_HOME/dsh-reading-companion/inbox/ 目錄，點擊面板上的「掃描導入目錄」。
閱讀與記筆記：在正文中選中一段文字，點擊浮動條中的「記筆記」。在筆記頁填寫「我的感想」並選擇建議的 tag，點擊「寫入筆記」。
AI 陪讀：點擊「發到會話去聊」，將這段文字連同你的想法發送給 AI，它將基於當前進度進行回應。
導出筆記：在「設置」頁點擊「導出背景與全部筆記」，生成的 Markdown 文件將追加到指定的筆記庫目錄中。

注意事項¶

重啓必讀：插件註冊過程依賴啓動時讀取配置，刷新頁面無法生效，必須重啓應用。
安全與隱私：插件使用「路徑閘」而非「文件閘」來防止劇透。在 Windows 環境下，8.3 短名與硬鏈接可能繞過路徑限制，指向同一文件，需注意安全邊界。
版本依賴：確保 DSH 版本不低於 0.1.5-rc.2，否則無法識別側邊欄接口。

結語¶

dsh-reading-companion 通過本地存儲、結構化記憶與嚴格的權限控制，爲長文本閱讀提供了一個隱私可控、劇透可控的工作流。對於需要深度閱讀並整理筆記的用戶，它提供了從閱讀到落地的直接路徑。

目錄頁：https://www.skillhub.cn/plugins/xling001/dsh-reading-companion
源碼：https://github.com/xling001/dsh-reading-companion