Book Processor Skill
功能概览
本技能自动化处理 EPUB 电子书，将书籍转化为结构化内容与实用工具。
核心输出文件
| 文件 | 说明 |
|---|
| INLINECODE0 | 从 EPUB 提取的封面图片 |
| INLINECODE1 |
全书纯文本（若 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 文件时自动触发。
工作流程
- 1. 接收 EPUB：从用户消息中提取 EPUB 文件
- 创建书籍文件夹：在
~/workspace/books/ 下创建以书名命名的文件夹 - 保存文件：将 EPUB 放入对应文件夹
- 读取配置：如果文件夹中存在
process_config.json，则使用它；否则使用默认配置 - 执行处理：运行
scripts/process_book.sh <book_folder>（相对于技能目录） - 返回结果：向用户报告生成的文件列表和简要概览
配置选项
在书籍文件夹中创建
process_config.json 来控制生成的资产：
CODEBLOCK0
说明：
- -
true 表示生成对应文件 - INLINECODE17 或省略表示跳过
- 默认配置：仅生成
cover.jpeg、full_text.txt、summary.txt、framework_article.txt 四个必需文件
安装与依赖
必需工具
| 工具 | 用途 | 安装命令 |
|---|
| INLINECODE22 | JSON 配置解析 | INLINECODE23 |
| INLINECODE24 |
文本提取 |
sudo apt-get install -y python3 |
|
unzip | EPUB 解压 |
sudo apt-get install -y unzip |
验证安装
jq --version
python3 --version
unzip -v
使用方法
方式 1：自动触发（推荐）
直接将 EPUB 文件发送给福德，技能会自动处理。
方式 2：手动执行
# 处理指定书籍文件夹
/home/haifeng/workspace/scripts/process_book.sh /home/haifeng/workspace/books/《书名》
目录结构示例
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
└── 人本教练/
└── ...
注意事项
- 1. EPUB 文件命名：建议使用简化的文件名（如
《书名》.epub），避免特殊字符 - 图片为主的书：如果 EPUB 内容主要为图片，
full_text.txt 可能非常少，需要手动补充 summary.txt 和 INLINECODE31 - 重复处理：重新运行脚本时，会覆盖已有文件（除原始 EPUB 外）
- 编码：所有输出文件使用 UTF‑8 编码
故障排查
| 问题 | 原因 | 解决 |
|---|
| INLINECODE32 | 缺少依赖 | INLINECODE33 |
| INLINECODE34 |
缺少解压工具 |
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书籍处理器技能
功能概览
本技能自动化处理EPUB电子书，将书籍转化为结构化内容与实用工具。
核心输出文件
| 文件 | 说明 |
|---|
| cover.jpeg | 从EPUB提取的封面图片 |
| full_text.txt |
全书纯文本（若EPUB以图片为主，该文件内容可能极少） |
| summary.txt | 书籍简要概要（若文字不足需手动补充） |
| framework_article.txt | 将书中核心方法映射为“认知‑对抗‑重塑‑持久”四阶段框架的解读文章 |
| examples.md | 精选案例库（可根据书中实际人物/案例修改） |
| daily
combatchecklist.md | 每日对抗清单模板（适用于需要每日练习的书籍） |
| 5why_sheet.md | 5‑Why根因分析工作表 |
| thinking
modelssummary.md | 思维模型速查卡（通用列表） |
| framework_flow.mmd | Mermaid流程图（可视化四阶段关系） |
| faq.md | 常见问题与答案 |
| process_config.json | 本次处理所使用的配置（若未提供则使用默认值） |
触发条件
当用户发送.epub文件时自动触发。
工作流程
- 1. 接收EPUB：从用户消息中提取EPUB文件
- 创建书籍文件夹：在~/workspace/books/下创建以书名命名的文件夹
- 保存文件：将EPUB放入对应文件夹
- 读取配置：如果文件夹中存在processconfig.json，则使用它；否则使用默认配置
- 执行处理：运行scripts/processbook.sh （相对于技能目录）
- 返回结果：向用户报告生成的文件列表和简要概览
配置选项
在书籍文件夹中创建process_config.json来控制生成的资产：
json
{
generate_examples: true,
generatedailychecklist: false,
generate_5why: false,
generatethinkingmodels: true,
generate_flowchart: true,
generate_faq: true
}
说明：
- - true表示生成对应文件
- false或省略表示跳过
- 默认配置：仅生成cover.jpeg、fulltext.txt、summary.txt、frameworkarticle.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/《书名》
目录结构示例
books/
├── 一生之敌/
│ ├── 一生之敌.epub
│ ├── cover.jpeg
│ ├── full_text.txt
│ ├── summary.txt
│ ├── framework_article.txt
│ ├── examples.md
│ ├── dailycombatchecklist.md
│ ├── 5why_sheet.md
│ ├── thinkingmodelssummary.md
│ ├── framework_flow.mmd
│ ├── faq.md
│ └── process_config.json
└── 人本教练/
└── ...
注意事项
- 1. EPUB文件命名：建议使用简化的文件名（如《书名》.epub），避免特殊字符
- 图片为主的书：如果EPUB内容主要为图片，fulltext.txt可能非常少，需要手动补充summary.txt和frameworkarticle.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
