雲書籤
雲書籤是 BookmarkSync 的核心功能之一，允許使用者將書籤儲存在雲端而不佔用瀏覽器書籤列空間。
功能概述
雲書籤提供了一個獨立於瀏覽器書籤列的書籤儲存空間：
- 雲端儲存：書籤儲存在雲端伺服器，不佔用瀏覽器書籤列
- 多裝置同步：使用同一帳號登入的裝置自動同步雲書籤
- 分類管理：支援樹狀分類結構，可建立多層級資料夾
- 快速搜尋：支援依標題與網址搜尋書籤
- 拖曳排序：可自訂書籤與分類的顯示順序
- 批次管理：支援批次移動、刪除書籤
使用情境
雲書籤適合以下使用情境：
- 備用網址保存：不常用但需要保留的網站
- 資源收藏：學習資料、教學、工具站等收藏
- 專案資源：依專案分類保存相關網站連結
- 書籤列瘦身：將低頻存取的書籤移至雲端，保持書籤列簡潔
- 跨裝置存取：在任何裝置上都能存取完整的書籤庫
如何使用
存取雲書籤
- 點擊瀏覽器工具列的 BookmarkSync 擴充功能圖示
- 在首頁選擇「雲書籤」卡片
- 自動開啟雲書籤管理頁面
新增雲書籤
方式一：手動新增
- 在雲書籤管理頁面點擊右上角「新增書籤」按鈕
- 填寫書籤資訊：
- 標題：網站名稱或自訂標題
- 網址：完整的 URL 位址
- 選擇所屬分類（選填）
- 點擊確認儲存
方式二：快速新增目前頁面
- 在擴充功能 Popup 中選擇「雲書籤」模組
- 點擊「新增目前頁面」（如果提供此功能）
- 自動取得目前分頁的標題與網址
- 確認後儲存
分類管理
雲書籤支援樹狀分類結構，可以建立多層級資料夾整理書籤。
建立分類：
- 點擊右上角「新增分類」按鈕
- 輸入分類名稱
- 選擇上層分類：
- 留空則建立為頂層分類
- 選擇現有分類則建立為其子分類
- 點擊確認建立
編輯分類：
- 點擊「更多」下拉選單，選擇「分類編輯」
- 在分類編輯介面可以：
- 重新命名分類
- 刪除分類（需確認，會同時刪除該分類下的所有書籤）
- 調整分類層級關係
切換分類：
- 點擊左側分類樹中的任意分類
- 右側內容區會顯示該分類下的所有書籤
- 支援展開/收合多層級分類
書籤操作
查看書籤：
- 左側分類樹選擇分類
- 右側以卡片形式顯示該分類下的書籤
- 每個書籤卡片顯示：網站圖示、標題、網址
開啟書籤：
- 點擊書籤卡片的標題或網址區域
- 在新分頁中開啟該網址
編輯書籤：
- 點擊書籤卡片右側的「操作」按鈕
- 選擇「編輯」
- 可修改標題或網址
- 點擊確認儲存
移動書籤：
- 點擊書籤卡片的「操作」按鈕
- 選擇「移動」
- 在彈出的分類選擇器中選擇目標分類
- 確認移動
刪除書籤：
- 點擊書籤卡片的「操作」按鈕
- 選擇「刪除」
- 確認刪除操作（不可復原）
排序功能
書籤排序：
- 點擊右上角「更多」下拉選單
- 選擇「書籤排序」
- 進入排序模式，書籤卡片變為可拖曳狀態
- 拖曳書籤卡片調整順序
- 點擊「儲存」按鈕確認新順序
分類排序：
- 在「分類編輯」介面
- 拖曳分類節點調整順序或層級
- 儲存修改
搜尋功能
- 在頂部搜尋框輸入關鍵字
- 支援搜尋：
- 書籤標題
- 網址內容
- 點擊「搜尋」按鈕或按 Enter 鍵
- 顯示符合的書籤清單
- 點擊「清空」按鈕或刪除關鍵字恢復全部書籤
分頁瀏覽
- 當書籤數量較多時，自動分頁顯示
- 底部顯示分頁控制項
- 可切換到不同頁碼查看更多書籤
與瀏覽器書籤的區別
| 特性 | 瀏覽器書籤 | 雲書籤 |
|---|---|---|
| 儲存位置 | 瀏覽器本機 + 瀏覽器同步服務 | BookmarkSync 雲端 |
| 佔用書籤列 | 是 | 否 |
| 存取方式 | 瀏覽器書籤列/管理員 | 擴充功能頁面 |
| 同步要求 | 需要 Google 帳號（Chrome） | 僅需 BookmarkSync 帳號 |
| 儲存限額 | 瀏覽器限制 | 1000 條（免費額度） |
| 適用情境 | 高頻存取的網站 | 低頻但需保留的網站 |
與私密書籤的區別
| 特性 | 雲書籤 | 私密書籤 |
|---|---|---|
| 存取限制 | 登入即可存取 | 需要二次密碼驗證 |
| 安全層級 | 標準加密 | 增強加密 + 密碼保護 |
| 使用情境 | 一般收藏 | 敏感/隱私內容 |
| 存取便利性 | 高 | 中（需輸入密碼） |
儲存額度說明
- 免費額度：1000 條書籤（不包括分類資料夾本身）
- 共用配額：雲書籤與私密書籤共用 1000 條額度
- 計數規則：
- 每個書籤連結計為 1 條
- 分類資料夾不計入額度
- 額度查看：在設定頁面可查看目前已使用的額度
- 超額處理：超過 1000 條後無法繼續新增書籤
資料同步
自動同步
- 登入帳號後，雲書籤資料自動與雲端保持同步
- 新增、編輯、刪除操作即時上傳到雲端
- 多裝置間自動同步更新
同步狀態
擴充功能會顯示同步狀態：
- 正常：資料已同步
- 同步中：正在上傳或下載資料
- 衝突：偵測到資料衝突（需手動處理）
- 網路中斷：無法連線到伺服器
衝突處理
當多裝置同時修改同一書籤時可能產生衝突：
- 擴充功能會提示資料衝突
- 可選擇保留本機版本或雲端版本
- 或手動合併兩個版本的內容
資料安全
- 加密傳輸：所有資料透過 HTTPS 加密傳輸
- 加密儲存：資料在雲端加密儲存
- 金鑰隔離：加密金鑰與資料分開儲存
- 隱私保護：管理員無法查看使用者的書籤內容
常見問題
Q: 雲書籤和瀏覽器書籤會衝突嗎？
A: 不會。雲書籤是獨立的儲存空間，不會影響瀏覽器內建的書籤功能。兩者可以同時使用。
Q: 可以將瀏覽器書籤匯入到雲書籤嗎？
A: 目前版本暫不支援批次匯入功能。可以手動將常用書籤新增至雲書籤，或等待未來版本提供匯入功能。
Q: 雲書籤可以匯出嗎？
A: 目前版本暫不支援匯出功能。如需備份，建議定期截圖保存書籤清單。
Q: 刪除的雲書籤可以恢復嗎？
A: 目前不支援資源回收筒功能，刪除的書籤無法恢復。刪除前請謹慎確認。
Q: 雲書籤的圖示是如何取得的？
A: 擴充功能會自動從網站的 favicon 取得圖示。如果網站沒有設定圖示，則顯示預設的連結圖示。
Q: 為什麼我的雲書籤載入很慢？
A: 可能原因：
- 網路連線不穩定
- 書籤數量過多（接近 1000 條）
- 伺服器回應較慢
建議檢查網路連線，或嘗試重新整理頁面。
Q: 雲書籤會佔用瀏覽器效能嗎？
A: 不會。雲書籤資料儲存在雲端，只在開啟管理頁面時才載入，不會影響瀏覽器日常使用的效能。
技術實現
雲書籤基於以下技術架構實現：
- 模組名稱：
cloudBookmark - 路由路徑：
/cloudBookmark - 主要元件：
E:\bookmark_chrome\src\modules\cloudBookmark\index.ts- 模組定義E:\bookmark_chrome\src\modules\cloudBookmark\popup.vue- Popup 介面E:\bookmark_chrome\src\tab-app\views\user\Cloud.vue- 完整管理頁面E:\bookmark_chrome\src\utils\bookmark.ts- 書籤同步核心邏輯
- 資料儲存：雲端儲存，透過 RESTful API 與伺服器互動
- 通訊機制：基於 Channel 通訊系統實現跨元件訊息傳遞
- API 端點：
bookmarks/overideData- 覆蓋上傳書籤資料bookmarks/downloadData- 下載雲端書籤資料
開發者可參考以下文件瞭解詳細架構：
E:\bookmark_chrome\CLAUDE.md- 專案開發規範E:\bookmark_chrome\docs\ARCHITECTURE.md- 架構說明E:\bookmark_chrome\docs\CORE_API.md- 核心 API 參考
最佳實踐
分類組織建議
- 依主題分類：如「工作」、「學習」、「娛樂」等
- 依專案分類：每個專案建立獨立分類
- 依用途分類：如「開發工具」、「設計資源」、「參考文件」等
- 多層級分類：合理使用子分類，避免單層分類過多
命名建議
- 標題簡潔明瞭：使用描述性的標題，方便搜尋
- 分類名稱規範：統一命名風格，如全部使用中文或英文
- 避免重複：定期檢查並合併重複的書籤
維護建議
- 定期清理：刪除失效的書籤連結
- 及時更新：網站位址變更時及時修改書籤
- 合理分類：隨著書籤增多，及時調整分類結構
- 備份重要書籤：對於特別重要的書籤，建議同時保存在瀏覽器書籤列