dsh-book2skill DSH 插件

dsh-book2skill DSH 插件的仓库 README 摘录

以下文字摘自 dsh-book2skill DSH 插件的上游仓库 omdsh-dev/dsh-book2skill 的 README，版权归原作者，仅作引用。

书籍转技能（Book → Skill）：DSH 插件包，把一个 5 阶段长任务工作流带进 DeepSeek Harness—— **获取书籍 → 解析分章 → 深度阅读 → 生成 SKILL.md → 安装**，中途有 **3 个人类门控**。 确定性步骤（EPUB 解析 / PDF 提取 / OCR / 安装复制）是宿主工具；理解与生成（浅读建地图、 设计方向问题、深读核心章、撰写 SKILL.md 与自检）由 agent 执行；浏览器面板负责 5 阶段时间线 展示与门控审批。任务状态存宿主存储域，**跨会话、跨重启可恢复，可随时取消**。 ## 架构 | 平面 | 内容 | |------|------| | 宿主（`src/index.ts`） | `book2skill` 存储域（jobs 表）、`/book2skill` HTTP 面板路由、10 个 `book2skill_*` 工具 | | 浏览器（`src/client/`） | `conversation.view` 时间线面板（React），纯 fetch 轮询宿主路由 | | 脚本（`scripts/`） | `parse_epub.py`（修复版：标题行不再丢失、>5000 字章节按 `##` 拆分）、`pdf_parse.py`（PyPDF2 探测/分块） | ## 5 阶段 + 3 门控 1. **获取书籍**：本地路径（目录选择器，browse 能力）/ z-lib 搜索下载（复用 book-downloader 的 cookies，无硬编码密钥） 2. **解析分章**：EPUB → 按章 md + toc.md（<200 字合并、>5000 字拆分）；PDF → PyPDF2 先探测（<5000 有效字或乱码判扫描型）→ 扫描型走 OCR，面板显示逐页进度（37/420）与「排队中」 3. **深度阅读【门控1】**：agent 浅读建地图 → 发布 ≤3 个选择题（选项带书中章节背景）→ 用户在面板作答 → agent 深读 3-5 个核心章 4. **生成 SKILL.md【门控2】**：可编辑预览 + 知识地图 + 3 项自检清单（SOP 可溯源 / 索引准确 / 触发词宽窄，不通过标红，可一键让 agent 修）→ [重新生成] / [通过并继续] 5. **安装【门控3】**：目标多选（~/.claude/skills、~/.codex/skills、~/kk_skill/skills 同步仓库）→ 确认后 agent 调 `book2skill_install` → 完成卡（触发示例 chips + 复制即试） ## OCR 解耦（三级探测，无硬依赖） 本插件**不 inject** `paddleOcr`（缺失服务会永远挂起本行）。运行时按级探测：

阅读完整 README仓库许可: BSD-3-Clause

dsh-book2skill DSH 插件常见问题