🤖

dsh-tool-epub

模型推理更新于 2026.10.02

在终端中运行以下命令：

dsh plugin install yuehancn/dsh-tool-epub

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 终端执行 dsh plugin install yuehancn/dsh-tool-epub 安装本插件（源码：https://github.com/yuehancn/dsh-tool-epub），安装后重启 dsh 即可在 desktop 或 web profile 使用。

插件介绍

EPUB 不是换个后缀的文档，而是带强制骨架的 ZIP：mimetype 必须首位且不压缩，阅读顺序靠 spine，目录靠 nav，两处一旦对不上，书往往还能打开，但章节错位或「看得见翻不到」。更麻烦的是合书与拆书：按标题猜章节边界猜错了常常是静默的，而多数 ZIP 库还会把 mimetype 压掉，严格阅读器会直接拒收。在 Harness 里处理电子书，你需要的往往不是「再包一层管道」，而是先看清结构再动手。

dsh-tool-epub 把「看清楚」和「动手」拆开：epub_inspect 只读不写，不解包就能拿到元数据、按 spine 顺序的章节统计、目录树，以及一份直白的 warnings 清单（压缩的 mimetype、spine 缺文件、目录悬空、孤儿章节、缺少 nav 等）。epub_build 支持显式章节或从整段 HTML 按标题层级自动切分，并返回 splitRule 说明边界怎么来的；epub_split 则按 spine 顺序把书拆回逐章 HTML 或 TXT，并可选生成目录页。长任务前可用 epub_status 确认能力与上限。全程自研 ZIP 读写与 XML 扫描，不依赖 epubjs、jszip，产物路径有 zip-slip 防护，同输入可得到字节一致的书。

适合在桌面或 Web 版 dsh 里做电子书体检、批量拆章、从 HTML 拼合规 EPUB、或排查「书坏了到底是哪一环」的编辑与自动化场景。若你关心 spine 与 nav 是否一致、字数统计是否与生成内容对齐，inspect 与 build/split 的设计就是为此服务的。