前言¶

在 DeepSeek Harness（DSH）里做智能体或长文档相关开发时，经常需要在同一工作环境里翻本地书、对照章节内容。单独开浏览器或另一个阅读应用，窗口切换成本高；把阅读器和当前 DSH 会话绑在一起，又希望 AI 能力走本机已配置的模型，而不是再搭一套线上服务。墨阅 DSH 插件（wisdomzking/moyue-dsh-plugin）把本地电子书阅读器「墨阅」挂进 DSH 左侧栏，并由 Host 侧保活阅读器服务、提供本机 AI 章节导读与书架分类代理。社区目录归类为客户端插件，维护者为 wisdomzking。

下面介绍插件做什么、如何安装启用，以及 AI 与隐私上需要注意的点。

这是什么¶

墨阅 DSH 插件是 DSH 的 bundle + client 组合：客户端半在左侧栏增加「墨阅」入口并在主区域嵌入本地阅读器页面；Host 半负责阅读器进程看门狗，以及监听 127.0.0.1 的 AI 代理。阅读器本体单独开源在 wisdomzking/moyue-reader，支持 EPUB、PDF、MOBI、AZW3、Word、TXT 等格式；本仓库只负责与 DSH 的集成。

核心功能¶

左侧栏与内嵌面板¶

• 左侧栏新增「墨阅」图标（order 20，位于默认面板图标之间）。
• 点击后在主区域打开阅读器面板，内嵌 http://127.0.0.1:7788。
• 面板右上角支持「刷新」和「独立窗口」。

Host 保活¶

DSH 启动或阅读器服务退出时，Host 半会自动拉起阅读器服务，并进行约 15 秒间隔的健康检查。

本机 AI 章节导读与书架分类¶

插件在 http://127.0.0.1:7797 提供 AI 代理（需与阅读器内 web/js/ai-guide.js 的 AI_ENDPOINT 一致）：

• 章节导读：阅读器把当前章节/页面的纯文本（最多约 1.8 万字符）发到本机代理，由插件通过 DSH 默认模型（README 示例为 deepseek-account/deepseek-flash）生成摘要、导读、结构化分析与思考问题。
• 书架分类：阅读器把书名、作者、格式等清单发来，按主题分组；代理仅接受来自 http://127.0.0.1:7788 或 http://localhost:7788 的请求。

生成结果会按「书 + 章节」缓存在阅读器浏览器 localStorage；书架 AI 分类结果由阅读器保存为书架文件夹。每次生成消耗 DSH 模型额度；关闭插件或 DSH 后 AI 不可用，阅读器本体仍可单独使用。

安装与启用¶

官方 README 建议将阅读器与插件放在同一父目录；插件默认从 D:\tools\dsh\ebook-reader 拉起阅读器。在 Linux 等环境可通过环境变量 MOYUE_APP_ROOT 指向实际阅读器目录。

1、在阅读器程序目录安装依赖（示例路径与 README 一致）：

cd /d D:\tools\dsh\ebook-reader && npm install

2、让 DSH 安装本地插件包：

plugin_manager action=install_bundle target=D:\tools\dsh\moyue-dsh-plugin

首次安装若返回 restart-required，需重启 DeepSeek Harness（关闭窗口再打开）后生效。重启后左侧栏出现墨阅图标，点击即可阅读。

自检¶

无需浏览器或完整 DSH 界面时，可在插件目录执行：

node test\selftest.mjs

用于校验客户端槽位注册（sidebar.panellist + main）与 Host 保活逻辑（启停服务）。

配置¶

仓库结构（便于读源码）¶

package.json       dsh.bundle.patch + dsh.client（web / 立即加载 / 依赖注入）
cordis.patch.yml   插入 Host 插件行 moyue-reader
index.js           Host 半：阅读器服务看门狗 + AI 章节导读代理（ctx.llm.stream）
client.js          Client 半：左侧栏图标 + main 面板（iframe）
locale/*.json      插件展示元数据（中文 / English）
icon.svg           插件图标

package.json 中插件名为 @local/moyue-reader，版本 1.0.0；client 侧为 web 平台、immediately: true，并注入 DSH 客户端连接、运行时、设置、槽位与 locale 等模块。

适用场景与注意¶

适合谁：经常在 DSH 里长时间工作或调试、需要本地多格式电子书，并希望章节导读走当前 DSH 已配置模型、且请求限定在本机的用户。

权限与信任：插件以当前 DSH 进程权限运行，会启动本机 Node 服务并调用 ctx.llm.stream。安装前请自行审阅 moyue-dsh-plugin 与 moyue-reader 源码与许可证。

隐私：章节纯文本会经本机代理发送至模型服务商；代理只监听 127.0.0.1，且书架/导读请求来源限制为本地阅读器页面。重复打开同一章且缓存命中时，不会再次请求模型。

生态说明：DSH 社区插件目录（如 SkillHub 上的条目）由社区维护，与 DeepSeek / 幻方无官方从属关系；安装方式以各仓库 README 为准，勿凭插件名臆造 dsh plugin add github:... 一类命令。

结尾¶

墨阅 DSH 插件把本地阅读器纳入 DSH 左侧栏，并用 Host 保活与本机 AI 代理串联章节导读和书架分类，适合「在同一 Harness 环境里看书 + 用已配置模型读章节」的工作流。更多信息见目录页 skillhub.cn/plugins/wisdomzking/moyue-dsh-plugin 与 GitHub wisdomzking/moyue-dsh-plugin。