目前狀態
書籍數
載入中…
標註總數
載入中…
最後推送時間
載入中…
資料來源
Worker KV（本機直推）
不即時查詢 Notion，無 rate limit 風險
系統架構
📖
Kobo 電子書
SQLite 書摘資料庫
→
🐍
kobo_to_notion.py
一鍵：上傳＋分類＋推送
→
◻️
Notion v2
歸檔備份（可手動瀏覽）
→
⚡
Worker /admin/snapshot
直接寫入 KV，不查 Notion
→
🌐
Cloudflare Pages
此網站
Notion 的即時查詢容易碰到 API rate limit 與多資料來源（multi-data-source）權限問題，
所以網站顯示的資料改由
kobo_to_notion.py 直接從 Kobo 本機資料庫建立完整快照，
推送到 Worker 儲存；Notion 只作為可手動瀏覽/編輯的歸檔備份，不參與網站的即時讀取路徑。
操作步驟
1
連接 Kobo 至電腦
用 USB 線連接 Kobo，確認裝置已掛載為磁碟。
2
執行一鍵同步
在 Terminal 執行以下指令，會依序完成：上傳新標註到 Notion（歸檔）→ AI 自動分類新書 → 建立完整快照 → 推送到 Worker，網站立即更新：
cd /Users/willians/Downloads/Kobo2Notion python3 kobo_to_notion.py
腳本會自動跳過已上傳的書摘；即使沒有新標註，也會重新推送快照確保網站數字正確。
3
確認書庫更新
重新整理書籍索引頁，或點頁面右上角「重新整理」，確認新書或新書摘已出現。
系統資訊
Worker API
kobo-api.william-6c4.workers.dev
正常運行中
快取策略
KV 永久儲存，推送式更新
執行 kobo_to_notion.py 即會更新
腳本位置
~/Downloads/Kobo2Notion/
kobo_to_notion.py
Worker 位置
~/Downloads/Kobo_Viewer/worker/
src/index.js
備援指令 手動 · 較慢
以下指令會即時查詢 Notion 重建資料，僅在懷疑 KV 資料有誤、需要繞過本機 Kobo 資料時使用。
即時從 Notion 重建書籍列表
curl -X POST https://kobo-api.william-6c4.workers.dev/sync/books \ -H "Authorization: Bearer <ADMIN_TOKEN>"
即時從 Notion 重建單本書摘
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