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