dsh-book2skill：DeepSeek Harness 的书籍转技能 DSH plugin

dsh-book2skill 是 DeepSeek Harness（DSH）的书籍转技能插件（DSH plugin），由 omdsh-dev 维护，采用 BSD-3-Clause 许可，最近更新于 2026-08。它解决的是「把一本书变成可复用的 SKILL.md」这一长任务：从获取书籍、解析分章、深度阅读到生成技能文件并安装，全程 5 个阶段，中间设置 3 个人类门控，确保每一步都可控、可追溯。核心能力包括：确定性步骤（EPUB 解析、PDF 提取、OCR、安装复制）由宿主工具完成，理解与生成（建知识地图、设计问题、深读核心章、撰写 SKILL.md 与自检）交给 agent 执行，浏览器面板提供 5 阶段时间线展示与门控审批。任务状态存于宿主存储域，跨会话、跨重启可恢复，也可随时取消。

dsh-book2skill 这个 DSH plugin 的 5 阶段工作流和 3 个人类门控是怎样的？

工作流分为 5 个阶段：获取书籍（支持本地路径选择或 z-lib 搜索下载，复用 book-downloader 的 cookies，无硬编码密钥）；解析分章（EPUB 按章转 md，<200 字合并、>5000 字拆分；PDF 先用 PyPDF2 探测，扫描型走 OCR，面板显示逐页进度）；深度阅读（门控1：agent 浅读建地图，发布 ≤3 个选择题，用户作答后深读 3-5 个核心章）；生成 SKILL.md（门控2：可编辑预览 + 知识地图 + 3 项自检清单，不通过标红，可一键让 agent 修）；安装（门控3：目标多选，如 /.claude/skills、/.codex/skills 等，确认后调用 book2skill_install，完成卡带触发示例 chips）。

dsh-book2skill 的 OCR 三级探测机制如何解耦硬依赖？

插件不 inject paddleOcr，而是按级探测：先查 ctx.get('paddleOcr') 宿主服务（dsh-paddle-ocr 发布时自动生效）；再试 /paddle-ocr loopback RPC（任务通道 task/start → status 轮询 → commit，逐页进度透传）；最后 HTTP 直调 stub（BOOK2SKILL_OCR_ENDPOINT，缺省 http://127.0.0.1:8011/api/pdf/ocr）。全部不可用时明确报错，并给出 agent 兜底路径：用 paddle_ocr_layout 工具解析 → book2skill_import_ocr 导入。

dsh-book2skill 提供哪些宿主工具和兼容性要求？

宿主工具共 10 个，包括 book2skill_start、book2skill_parse、book2skill_get_job、book2skill_stage_note（summary·knowledge-map·deep-read·draft·questions·selfcheck）、book2skill_read_chapter、book2skill_zlib_search、book2skill_download、book2skill_import_ocr、book2skill_install、book2skill_cancel。兼容 DSH >=0.1.0-rc.3 <0.2.0（使用 rc.3 的 ctx.shell 能力契约），Node.js ^22.19.0 || >=24.0.0，Profile Bundle 自动应用 cordis.patch.yml。

dsh-book2skill 怎么安装？

安装命令如下（需先确保 DSH 环境满足版本要求）：

dsh plugin --profile web add github:omdsh-dev/dsh-book2skill

安装后重启 dsh web（宿主行需要进程重启），浏览器刷新后对话区出现「书籍转技能」标签。注意不要手工把 book2skill 行写进 profile，插件包已声明 Profile Bundle，手工追加会形成重复 loader entry。

dsh-book2skill 的安全与可溯源设计有哪些红线？

插件不硬编码任何密钥：z-lib 登录态读 ~/.claude/skills/book-downloader/auth/zlib-cookies.json，OCR token 由 dsh-paddle-ocr 的凭据保险箱管理。生成内容可溯源：SOP 步骤必须来自 references 章节（自检1 强制回读校验），references 索引与触发词均有自检项。

查看更多 DSH 插件，访问 dsh-plugin.org