📚 個人閱讀助理 (Reading Assistant)#

管理 epub 電子書圖書館，分章節產生摘要，追蹤閱讀進度，提供閱讀建議。

---

系統架構#

資料存放#

本 Skill 使用兩層儲存：

1. 本地檔案系統（主要）

• 書庫根目錄： ~/.openclaw/workspace/reading-library/
• 每本書一個子資料夾，內含 manifest.json + chapters/ 目錄
• 閱讀進度檔： ~/.openclaw/workspace/reading-library/progress.json

2. Notion（可選，用於雲端同步）

• 如果使用者有連接 Notion，可同步書籍資訊與摘要到 Notion 資料庫
• 未連接 Notion 時所有功能仍正常運作

進度追蹤檔 (progress.json) 格式#

json

{
  "books": {
    "<book_id>": {
      "title": "書名",
      "author": "作者",
      "total_chapters": 40,
      "current_chapter": 12,
      "status": "reading",
      "last_read_date": "2026-03-23",
      "added_date": "2026-03-20",
      "rating": null,
      "summaries": {
        "0": { "date": "2026-03-20", "summary": "..." },
        "1": { "date": "2026-03-21", "summary": "..." }
      }
    }
  }
}

---

功能模組#

模組 1：匯入書籍 (Import Book)#

觸發：使用者提供 epub 檔案路徑或說「匯入」「import」

步驟：

1. 確認 epub 檔案路徑存在

2. 安裝必要 Python 套件（如尚未安裝）： bash

   pip3 install ebooklib beautifulsoup4 lxml
   
   

3. 執行處理腳本： bash

   python3 ~/.openclaw/workspace/skills/reading-assistant/scripts/process_epub.py \
     "<epub檔案路徑>" \
     "~/.openclaw/workspace/reading-library/<book_id>"
   
   

   腳本會自動產生 manifest.json 和 chapters/ch_000.txt ~ ch_NNN.txt

4. 讀取 manifest.json，將書籍資訊寫入 progress.json

5. 回報匯入結果

回報格式：

text

✅ 匯入成功！

📕 書名：世界盡頭與冷酷仙境
👤 作者：村上春樹
📄 共 40 章（約 180,000 字）
⏱️ 預估總閱讀時間：6 小時
📊 狀態：未開始

輸入 /reading-assistant 或說「我的書單」查看圖書館。

模組 2：閱讀清單 (Reading List)#

觸發：「書單」「閱讀清單」「我有哪些書」「reading list」

步驟：

1. 讀取 ~/.openclaw/workspace/reading-library/progress.json
2. 列出所有書籍的進度

回報格式：

text

📚 你的閱讀圖書館

| # | 書名 | 作者 | 進度 | 狀態 |
|---|------|------|------|------|
| 1 | 世界盡頭與冷酷仙境 | 村上春樹 | 12/40 (30%) | 📖 閱讀中 |
| 2 | 挪威的森林 | 村上春樹 | 0/16 | 📋 未開始 |
| 3 | 人間失格 | 太宰治 | 4/4 (100%) | ✅ 已完成 |

💡 建議：你上次讀「世界盡頭與冷酷仙境」到第 12 章，要繼續嗎？

模組 3：閱讀章節摘要 (Chapter Summary)#

觸發：「讀第 N 章」「摘要」「下一章」「繼續」「summary」

步驟：

1. 確定目標書籍和章節序號

   • 「下一章」或「繼續」→ 從 progress.json 找到 current_chapter + 1
   • 「讀第 5 章」→ 指定章節
   • 若只有一本在讀中的書，自動選擇；否則詢問

2. 讀取對應的章節文字檔： bash

   cat ~/.openclaw/workspace/reading-library/<book_id>/chapters/ch_<NNN>.txt
   
   

3. 將章節文字交給 LLM（即你自己），以下方結構產生摘要：

摘要結構（嚴格遵循）：

text

📖 《書名》— 第 N 章：章節標題

【章節摘要】
150-250 字概述本章主要內容和情節發展。

【關鍵人物】
• 角色名 — 本章中的行為與變化

【金句節錄】
1. 「原文句子」
2. 「原文句子」
（挑選 2-3 句值得記住的段落）

【延伸思考】
提出 1-2 個值得反思的問題。

【與前章連結】
簡述本章與前面章節的關聯。

1. 更新 progress.json：

   • current_chapter = 本次閱讀的章節序號
   • last_read_date = 今天日期
   • status = "reading"（如果讀完最後一章則改為 "completed"）
   • 將摘要存入 summaries 物件

2. 回報進度： text

   📊 進度更新：13/40 章 (32.5%) | ⏱️ 本章約 8 分鐘
   💾 摘要已儲存
   
   

模組 4：進度查詢 (Progress Check)#

觸發：「讀到哪」「進度」「上次讀到」「progress」

步驟：

1. 讀取 progress.json
2. 找出 status = "reading" 的書籍
3. 顯示最近閱讀紀錄

模組 5：定時推送（搭配 Cron）#

本 Skill 可搭配 OpenClaw 的 cron job 實現每日自動閱讀提醒。

在 ~/.openclaw/cron/jobs.json 中加入：

json

{
  "reading-reminder": {
    "schedule": "0 8 * * *",
    "prompt": "查看我的閱讀進度，如果有正在讀的書，幫我摘要下一章。"
  }
}

這會在每天早上 8 點自動觸發，讀取下一章並推送摘要到你的通訊平台（WhatsApp / Telegram / LINE 等）。

---

Notion 同步（可選）#

如果使用者要求將資料同步到 Notion，建立以下資料庫：

閱讀圖書館#

sql

CREATE TABLE (
  "書名" TITLE,
  "作者" RICH_TEXT,
  "語言" SELECT('中文':blue, '英文':green, '日文':red),
  "總章數" NUMBER,
  "目前章節" NUMBER,
  "閱讀狀態" SELECT('📋 未開始':gray, '📖 閱讀中':blue, '✅ 已完成':green),
  "Book ID" RICH_TEXT,
  "加入日期" DATE
)

每次更新 progress.json 時，同步更新 Notion 記錄。

---

注意事項#

• 章節辨識：腳本以 epub 內的 HTML document 為單位切分，不一定完全對應原書章節。匯入後可查看 manifest.json 手動調整標題
• DRM 限制：受 DRM 保護的 epub 無法解析，需先移除 DRM
• 長章節：超過 100,000 字的章節，摘要時會截取前 50,000 字處理
• 版權：本工具用於個人閱讀管理，使用者應確保擁有合法取得的電子書

---

Version: 1.0.0

Last Updated: 2026-03-23