Book Processor

自动化处理 EPUB 电子书，提取全文、封面、概要和框架解读，支持案例库、每日清单、5-Why 分析、思维模型速查卡、流程图和 FAQ 等多种资产生成。

Install

openclaw skills install @ntsnail/book-processor

Book Processor Skill

功能概览

本技能自动化处理 EPUB 电子书，将书籍转化为结构化内容与实用工具。

核心输出文件

文件	说明
`cover.jpeg`	从 EPUB 提取的封面图片
`full_text.txt`	全书纯文本（若 EPUB 以图片为主，该文件内容可能极少）
`summary.txt`	书籍简要概要（若文字不足需手动补充）
`framework_article.txt`	将书中核心方法映射为“认知‑对抗‑重塑‑持久”四阶段框架的解读文章
`examples.md`	精选案例库（可根据书中实际人物/案例修改）
`daily_combat_checklist.md`	每日对抗清单模板（适用于需要每日练习的书籍）
`5why_sheet.md`	5‑Why 根因分析工作表
`thinking_models_summary.md`	思维模型速查卡（通用列表）
`framework_flow.mmd`	Mermaid 流程图（可视化四阶段关系）
`faq.md`	常见问题与答案
`process_config.json`	本次处理所使用的配置（若未提供则使用默认值）

触发条件

当用户发送 .epub 文件时自动触发。

工作流程

接收 EPUB：从用户消息中提取 EPUB 文件
创建书籍文件夹：在 ~/workspace/books/ 下创建以书名命名的文件夹
保存文件：将 EPUB 放入对应文件夹
读取配置：如果文件夹中存在 process_config.json，则使用它；否则使用默认配置
执行处理：运行 scripts/process_book.sh <book_folder>（相对于技能目录）
返回结果：向用户报告生成的文件列表和简要概览

配置选项

在书籍文件夹中创建 process_config.json 来控制生成的资产：

json

{
  "generate_examples": true,
  "generate_daily_checklist": false,
  "generate_5why": false,
  "generate_thinking_models": true,
  "generate_flowchart": true,
  "generate_faq": true
}

说明：

true 表示生成对应文件
false 或省略表示跳过
默认配置：仅生成 cover.jpeg、full_text.txt、summary.txt、framework_article.txt 四个必需文件

安装与依赖

必需工具

工具	用途	安装命令
`jq`	JSON 配置解析	`sudo apt-get install -y jq`
`python3`	文本提取	`sudo apt-get install -y python3`
`unzip`	EPUB 解压	`sudo apt-get install -y unzip`

验证安装

bash

jq --version
python3 --version
unzip -v

使用方法

方式 1：自动触发（推荐）

直接将 EPUB 文件发送给福德，技能会自动处理。

方式 2：手动执行

bash

# 处理指定书籍文件夹
/home/haifeng/workspace/scripts/process_book.sh /home/haifeng/workspace/books/《书名》

目录结构示例

text

books/
├── 一生之敌/
│   ├── 一生之敌.epub
│   ├── cover.jpeg
│   ├── full_text.txt
│   ├── summary.txt
│   ├── framework_article.txt
│   ├── examples.md
│   ├── daily_combat_checklist.md
│   ├── 5why_sheet.md
│   ├── thinking_models_summary.md
│   ├── framework_flow.mmd
│   ├── faq.md
│   └── process_config.json
└── 人本教练/
    └── ...

注意事项

EPUB 文件命名：建议使用简化的文件名（如 《书名》.epub），避免特殊字符
图片为主的书：如果 EPUB 内容主要为图片，full_text.txt 可能非常少，需要手动补充 summary.txt 和 framework_article.txt
重复处理：重新运行脚本时，会覆盖已有文件（除原始 EPUB 外）
编码：所有输出文件使用 UTF‑8 编码

故障排查

问题	原因	解决
`jq 未安装`	缺少依赖	`sudo apt-get install -y jq`
`unzip: command not found`	缺少解压工具	`sudo apt-get install -y unzip`
`未找到 epub 文件`	文件夹内无 `.epub` 文件	确保 EPUB 文件已放入书籍文件夹
生成文件为空	EPUB 为图片格式	手动补充 `summary.txt` 和 `framework_article.txt`

扩展开发

如需自定义生成内容，可以修改 .skills/book-processor/scripts/process_book.sh 脚本。

自动化集成：
该技能已被集成到 OpenClaw 的自动化流程中，当检测到 .epub 文件时会自动触发。

最后更新：2026‑03‑14