目前狀態
書籍數
載入中…
標註總數
載入中…
最後推送時間
載入中…
閱讀狀態
載入中…
—
系統架構
📖
Kobo 電子書
畫線、閱讀進度、目錄
→
⌨️
kobo 指令
讀取＋AI 分類＋AI 重點
→
⚡
Worker KV
/admin/snapshot 快照
→
🌐
Cloudflare Pages
此網站
📝
Markdown 匯出（每次同步）
~/Downloads/Kobo2Notion/wiki_export/ · 給知識庫／LLM wiki 使用
·
◻️
Notion v2（僅 kobo full）
歸檔備份，不參與網站讀取
網站資料全部由本機直接從 Kobo 的
KoboReader.sqlite 建立快照後推送到 Worker，
不即時查詢 Notion，所以沒有 rate limit 問題。平常只要 kobo 就好，Notion 歸檔是選用的。
日常操作
1
用 USB 連接 Kobo
確認 Finder 出現
KOBOeReader 磁碟即可。2
在 Terminal 執行同步
kobo
依序完成：讀取畫線、閱讀進度與章節位置 → 新書 AI 分類 → 有新畫線的書重新生成 AI 重點 → 匯出 Markdown → 推送網站。
看到
✅ 推送完成 即完成。AI 重點只會處理標註數有變動的書，平常幾十秒內跑完。3
打開書庫確認
進入書籍索引頁，剛讀的書會排在最前面（預設「最近活動」排序）。
若還看到舊資料，按
Cmd + Shift + R 強制重新整理；頁首的「快照 vN」版本號會 +1。指令一覽
| 指令 | 做什麼 | 什麼時候用 |
|---|---|---|
kobo | 更新網站＋AI 重點＋Markdown，不碰 Notion | 最常用，每次讀完書 |
kobo full | 同上，並把新畫線歸檔到 Notion（不詢問） | 想在 Notion 保留備份時 |
kobo fast | 只更新網站，略過 AI 重點 | 趕時間、只想看最新排序 |
kobo --export-md ~/路徑 | Markdown 改輸出到指定資料夾 | 直接同步到知識庫資料夾 |
kobo notion（= 原始互動模式） | 執行 kobo_to_notion.py，上傳 Notion 前會詢問 y/n；回答 n 仍會更新網站 | 想逐次確認 Notion 上傳內容 |
如果新的 Terminal 視窗找不到
kobo，可直接執行 ~/Downloads/Kobo2Notion/kobo.sh，效果相同。網站功能說明
📚 書庫首頁
排序：最近活動（預設，取最後閱讀與最後畫線較新者）、最近畫線、最近閱讀、閱讀進度、標註數、書名。
狀態篩選：閱讀中／已讀完／未讀。
卡片：💡 一句話核心觀點、閱讀進度條（%）、最後閱讀日與最後畫線日；7 天內有動態的書會有橘色圓點。
搜尋：可搜書名、作者、分類，以及 AI 重點內容。排序與篩選會記住你上次的選擇。
狀態篩選：閱讀中／已讀完／未讀。
卡片：💡 一句話核心觀點、閱讀進度條（%）、最後閱讀日與最後畫線日；7 天內有動態的書會有橘色圓點。
搜尋：可搜書名、作者、分類，以及 AI 重點內容。排序與篩選會記住你上次的選擇。
📖 單本書頁
AI 閱讀重點：核心觀點＋3–5 點重點，只根據你的畫線與手寫備註生成；可收合。出現「有新畫線，下次同步會更新重點」表示執行
章節目錄：左側顯示書的真實章節名稱（取自 Kobo 目錄），依書中順序排列。
約全書 %：每筆畫線標示在全書的位置，可切換「書中順序／畫線日期」排序。
kobo 後會重生。章節目錄：左側顯示書的真實章節名稱（取自 Kobo 目錄），依書中順序排列。
約全書 %：每筆畫線標示在全書的位置，可切換「書中順序／畫線日期」排序。
🔎 怎麼在 Kobo 上找回某段畫線
電子書沒有固定頁碼（字級一改頁數就變），請改用兩個線索：
① 先看章節名稱，在 Kobo 開啟目錄跳到該章；② 對照「約全書 %」，Kobo 頁面上方的閱讀百分比就是同一個尺度。
例：「管理的第一規則是…」→
① 先看章節名稱，在 Kobo 開啟目錄跳到該章；② 對照「約全書 %」，Kobo 頁面上方的閱讀百分比就是同一個尺度。
例：「管理的第一規則是…」→
10 別送你的鴨子去老鷹學校 · 約全書 38%。少數沒有完整目錄的書會顯示原始檔名（如 Section0015）。
系統資訊
同步腳本
~/Downloads/Kobo2Notion/
kobo.sh（快捷指令）· kobo_to_notion.py（主程式 v5）
Markdown 匯出
Kobo2Notion/wiki_export/
每本書一個 .md，內容沒變的不會重寫
本機快取
.book_summaries.json · .book_tags.json
刪除某本書的項目 → 下次同步會重新生成
Worker API
kobo-api.william-6c4.workers.dev
KV 永久儲存，推送式更新
網站維護 網頁或程式有改動時
部署網頁（Pages）
~/Downloads/Kobo_Viewer/deploy_site.sh
只會部署
public/ 內的 4 個網頁；請勿直接部署整個 Kobo_Viewer 資料夾，否則 .env 等檔案會被公開。部署 Worker（worker/src/index.js 有改動時）
cd ~/Downloads/Kobo_Viewer/worker && npx wrangler deploy
更換 Admin Token
執行
npx wrangler secret put ADMIN_TOKEN（在 worker 資料夾），再把相同的值更新到 kobo_to_notion.py 的 WORKER_ADMIN_TOKEN。推送出現 401 未授權 代表兩邊不一致。備援指令 手動 · 較慢 · 點擊展開
以下指令會即時查詢 Notion 重建資料，僅在沒有 Kobo 可連接、又懷疑網站資料有誤時使用。
注意：從 Notion 重建的資料沒有閱讀進度、AI 重點與章節位置；之後接上 Kobo 執行一次
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>"