系統架構
📖
Kobo 電子書
SQLite 書摘資料庫
→
🐍
kobo_to_notion.py
本機同步腳本
→
◻️
Notion DB
書籍索引 · 書摘
→
⚡
Cloudflare Worker
kobo-api + KV 快取
→
🌐
Cloudflare Pages
此網站
操作步驟
1
連接 Kobo 至電腦
用 USB 線連接 Kobo，確認裝置已掛載為磁碟。
2
執行 Kobo → Notion 同步
在 Terminal 執行以下指令，將新書摘上傳到 Notion：
cd /Users/willians/Downloads/Kobo2Notion python3 kobo_to_notion.py
腳本會自動跳過已上傳的書摘，只處理新增內容。
3
刷新 Worker 快取
Worker 有 KV 快取（書籍 6 小時 / 書摘 12 小時）。執行 sync 讓網站立即更新，不用等快取過期：
cd /Users/willians/Downloads/Kobo_Viewer ./sync.sh
輸入 ADMIN_TOKEN 後會自動同步書籍列表與所有書摘。
4
確認書庫更新
重新整理書籍索引頁，確認新書或新書摘已出現。
系統資訊
Worker API
kobo-api.william-6c4.workers.dev
正常運行中
快取週期
書籍 6h · 書摘 12h
執行 sync.sh 可立即刷新
腳本位置
~/Downloads/Kobo2Notion/
kobo_to_notion.py
Sync 位置
~/Downloads/Kobo_Viewer/
sync.sh
常用指令
只刷新書籍索引（不刷書摘）
curl -X POST https://kobo-api.william-6c4.workers.dev/sync/books \ -H "Authorization: Bearer <ADMIN_TOKEN>"
刷新單本書摘（指定書籍 ID）
curl -X POST https://kobo-api.william-6c4.workers.dev/sync/highlights/<BOOK_ID> \ -H "Authorization: Bearer <ADMIN_TOKEN>"
重新部署 Worker（程式碼有改動時）
cd /Users/willians/Downloads/Kobo_Viewer/worker npx wrangler deploy