omdsh-dev/dsh-book2skill

dsh-book2skill

作者 / 维护者： @Zacklinkk

书籍转技能（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（5000 字拆分）；PDF → PyPDF2 先探测（=0.1.0-rc.3 =24.0.0
- Profile Bundle：package.json#dsh.bundle.patch 自动应用 cordis.patch.yml

构建与安装

1. 用当前 DSH rc.3 npm 运行时链接类型依赖并完整验收
npm ci
DSH_NODE_MODULES_ROOT=/path/to/dsh-rc3/node_modules npm run setup:dsh-workspace
npm run typecheck
npm test
npm run build

2. 打包并通过插件命令安装到目标 profile
npm pack
dsh plugin --profile web add file:/absolute/path/dsh-book2skill-0.1.2.tgz

3. 重启 dsh web（宿主行需要进程重启），浏览器刷新后对话区出现「书籍转技能」标签

不要再把 book2skill 行手工写进 profile：插件包已经声明 Profile Bundle，手工追加会形成重复
loader entry。发布到 npm 时 publishConfig.access 固定为 restricted。

宿主半的代码改动需要重启 dsh web 生效；浏览器半重建 lib/client.js 后，HMR 会自动重载该插件
（页面无需刷新；未开 pnpm run dev:web 时手动 npm run build 即可触发）。

红线自查

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

许可

BSD-3-Clause。面板素材（assets/.svg）由 Codex 生成。