Skip to content
dsh marketplace

dsh-client-ui-scan2ebook

Verified

dsh-client-ui-scan2ebook · v0.2.1 · MIT · Web UI

DeepSeek Harness right-sidebar workflow for scan2ebook conversion, progress, cost estimation, and reader lifecycle management.

Install

dsh plugin add dsh-client-ui-scan2ebook

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Creators

Readme

Scan2Ebook for DeepSeek Harness

在 DeepSeek Harness 中使用 Scan2Ebook 的图形界面插件。它把 PDF 选择、页码范围、API Key、转换进度、费用估算和网页阅读器放在 DSH 原生右侧栏的一个 tab 中（不依赖任何第三方侧栏插件）。

推荐：让 AI 帮你安装

把本页面链接发给一个能够操作本机终端的 AI，让它完成安装。可以直接使用下面这段请求：

请帮我安装 Scan2Ebook 的 DSH 插件。

请先检查环境，缺少软件或需要修改系统时先征求我的确认。使用 pipx 从
https://github.com/Goatherd0626/scan2ebook 安装 scan2ebook 转换器，然后为 DSH desktop profile
安装 dsh-client-ui-scan2ebook。最后用 scan2ebook --help 验证安装，并告诉我如何重启 DSH。

不要向我索要或保存 DeepSeek API Key，不要创建 .env，不要运行真实转换或调用付费 API，也不要修改已有的 Scan2Ebook Reader 书库数据。

使用前需要准备

  • macOS；
  • DeepSeek Harness Desktop 0.2.0-rc.2 或更高版本（官方右栏 API 随该版本发布）；
  • Node.js 20.19 或更高版本；
  • 已安装的 scan2ebook Python 转换器；
  • 你自己的 DeepSeek API Key。

安装转换器的推荐方式：

brew install pipx
pipx ensurepath
pipx install git+https://github.com/Goatherd0626/scan2ebook.git

安装插件

Scan2Ebook 直接使用 DSH Desktop 自带的右侧栏（@deepseek-ai/dsh-client-ui-sidebar-right），不需要 dsh-better-sidebar 之类的第三方侧栏插件。要求 DSH Desktop 0.2.0-rc.2 或更高：

dsh plugin --profile desktop add "dsh-client-ui-scan2ebook@^0.2.0"

如果 npm 上还没有 0.2.0（旧版基于 dsh-better-sidebar，只适用于 DSH 0.1.x），可以直接从仓库安装开发版：

git clone https://github.com/Goatherd0626/scan2ebook.git
dsh plugin --profile desktop add "file:$PWD/scan2ebook/dsh-plugin/dsh-client-ui-scan2ebook"

安装完成后完全退出并重启 DSH。Scan2Ebook 插件会自动安装 scan2ebook-reader，不需要单独安装网页阅读器。

如果还希望 DSH 在识别到扫描书转换请求时主动打开面板，可以另外安装仓库中的 Scan2Ebook Skill。手动使用右栏面板不要求安装 Skill。

使用方法

  1. 打开 DSH 右侧栏（会话窗口右上角的右栏按钮），在引导页或添加菜单里选择 Scan2Ebook。
  2. 点击“选择 PDF”。
  3. 输入要转换的起始页和结束页；两端页码都会包含在内。
  4. 选择多模态模型。
  5. 输入你自己的 API Key。
  6. 查看预计费用，点击“开始转换”。
  7. 通过进度条查看转换状态。
  8. 转换完成后，在同一个面板中启动网页阅读器。

转换结果会保存在所选 PDF 的同级文件夹中。

API Key

API Key 只在当前右栏面板中临时使用：

  • 不会读取 DSH 当前使用的 Provider Key；
  • 不会写入 .env；
  • 不会写入钥匙串或浏览器存储；
  • 不会写入日志；
  • 关闭右栏面板或 DSH 后会自动清除。

网页阅读器

在右栏面板的“网页阅读器”区域可以：

  • 启动阅读器；
  • 双击修改端口；
  • 在系统默认浏览器的新页面中打开阅读器；
  • 终止由插件启动的阅读器。

不同端口默认访问同一个书库。

找不到转换器

先在终端确认：

scan2ebook --help

如果命令不存在，请运行：

pipx ensurepath

然后重新打开终端和 DSH。

看不到 Scan2Ebook 入口

重新执行安装命令：

dsh plugin --profile desktop add "dsh-client-ui-scan2ebook@^0.2.0"

然后完全退出并重新启动 DSH。入口在右侧栏：打开右栏后，在引导页（添加菜单）里选择 Scan2Ebook；插件不会在左侧栏新增按钮。

项目主页：github.com/Goatherd0626/scan2ebook

合法使用

  • 请确认你要转换的 PDF 是自有、已购买、公有领域或已获授权的材料；
  • 转换会把选定页面的图像与文字发送给你配置的多模态模型服务，请确认材料允许上传到第三方服务；
  • 插件不上传、不收集、不保存你的 PDF 或转换产物；API Key 只在该面板内存中保留。

License

MIT