Bookmark Butler

🔖 Bookmark Butler 是一個強化版的 Chrome 書籤管理工具，在 Side Panel 直接管理你的書籤、加上 tag、分類、搜尋、清理失效連結。

🔒 所有資料只儲存在你的瀏覽器，不上傳、不需要帳號、不訂閱、所有功能對所有用戶開放。

🗂️ 介面與同步
- 直接讀取 Chrome 原生書籤，雙向即時同步
- List / Grid 兩種檢視，Compact 緊湊模式，Larger Text 大字模式
- Light / Dark / System 三段主題，Side Panel 與設定頁同步切換

🧭 五大分類區塊（可摺疊）
- Overview：All Bookmarks、Recent、Tagged（依 tag 分組顯示）、Duplicates、Link Issues
- Domains：依 hostname 自動分群（Top N 可調整）
- Folders：Chrome 原生資料夾樹狀結構與項目數量
- Tags：你定義的所有 tag 與書籤數
- Saved Searches：一鍵還原任何搜尋條件 + tag/domain 篩選

🏷️ Tag 系統
- 一個書籤最多 5 個 tag，全程強制
- Edit Tags 對話框：chip-style 輸入、輸入時自動建議已存在的 tag、右上角即時 0/5 計數
- 拖曳書籤到 sidebar 上的 tag 即可加上該 tag
- 右鍵 tag 可重新命名（更新所有使用者）或刪除（5 秒 Undo）

🔍 搜尋
- 預設：標題、URL、tag 三向 token-AND 模糊比對
- 進階：Regex 搜尋（可選擇開啟），語法錯誤時搜尋框會變紅
- `/` 鍵聚焦、`Esc` 清空

🔄 排序
- Default (Manual)、Date Added、Title、Domain、Most Visited、Last Visited
- Most Visited / Last Visited 在第一次選用時才向 chrome.history 查詢

🤝 拖曳功能
- 換順序：在 Default (Manual) 排序下，拖到別本書籤上方/下方插入
- 換資料夾：拖到 sidebar 任一資料夾
- 加 tag：拖到 sidebar 任一 tag
- 多選批次：勾選或 ⌘/Ctrl-click 多選後一起拖

🚨 Link Issues：失效連結 + 隱私／衛生檢查
- Broken links：手動掃描所有書籤是否仍可連線（HEAD → GET fallback、6 條並行、7 秒逾時）
- Sensitive token in URL：query 含 token / api_key / signature / password 等敏感參數
- Localhost / 私網 IP：localhost、127.x、10.x、192.168.x、169.254.x、::1
- Internal URL：無 TLD 或 .local / .internal / .test / .corp / .lan 等內網域
- Magic-link / 短期授權：路徑為 /auth/verify / /magic-link / /reset-password 且 query 帶簽章
- Suspicious domain：punycode 或 hostname 含非 ASCII（同形字攻擊偵測）
- HTTP only：公開網域上的非 HTTPS 連線
- 隱私分類來自 URL 模式分析，不需要掃描即時可看；只有 Broken 需要按下 Scan All

✅ 多選與批次操作
- 一次選多個書籤後，浮動 bulk bar 顯示
- 批次：加 tag、AI 自動 tag、刪除（5 秒 Undo）

🤖 AI Feature（自帶 API Key）
- 支援 Google Gemini / OpenAI / Anthropic 三家
- Auto-tag with AI：依 title + URL 自動建議最多 3 個 tag
- Rename with AI：抓取頁面 og:title / meta description 後請 AI 提供更好的標題
- AI first 開關：開啟後 hover 書籤時的兩個按鈕變為 AI 版；未設定 API Key 時自動禁用
- 所有 API 呼叫只送 title + url（除了 Rename 會額外讀頁面 head）
- Key 只存在本機 chrome.storage.local，不會 sync 到其他裝置

↩️ 處處可 Undo
- 每個破壞性操作都有 5 秒 Undo toast，不跳原生確認彈窗
- 包含：刪書籤、移動書籤、改標題、刪 tag / 改 tag 名 / 清空全部 tag、刪 saved search、刪資料夾（含書籤）、移除重複

🔒 權限說明
- bookmarks：讀寫 Chrome 書籤（核心功能）
- storage：本機儲存設定／tag／saved search／API key／linkStatus
- sidePanel：UI 主介面
- tabs：點擊書籤時開新分頁
- history：Most Visited / Last Visited 排序需要
- favicon：顯示書籤 favicon
- host_permissions：三家 AI 提供商 + `<all_urls>`（手動失效連結掃描 / AI Rename 抓 head）

無分析追蹤、無遠端同步、無帳號制度、無訂閱、無付費功能。

-

🔖 Bookmark Butler is a richer Chrome bookmark manager that lives in the Side Panel — manage bookmarks, add tags, organise, search, and clean up dead links, all from one place.

🔒 All data stays in your browser only — never uploaded, no account required, no subscription, every feature unlocked for everyone.

🗂️ UI & Live Sync
- Reads Chrome's native bookmarks directly with two-way live sync
- List / Grid views, Compact mode, Larger Text mode
- Light / Dark / System theme — synced between side panel and options page

🧭 Five Sidebar Sections (collapsible)
- Overview — All Bookmarks, Recent, Tagged (grouped per tag), Duplicates, Link Issues
- Domains — Auto-grouped by hostname (Top N configurable)
- Folders — Chrome's native folder tree with item counts
- Tags — All your tags with bookmark counts
- Saved Searches — One-click recall of any saved query + tag/domain filter

🏷️ Tag System
- Max 5 tags per bookmark, enforced everywhere
- Edit Tags dialog: chip-style input, autocomplete from your existing tags as you type, live `0/5` counter
- Drag a bookmark onto a tag in the sidebar to add that tag
- Right-click a tag → Rename (updates every bookmark using it) or Delete (with 5-second Undo)

🔍 Search
- Default: token-AND fuzzy across title, URL, and tags
- Advanced: Regex search (opt-in); invalid patterns turn the search bar red
- `/` to focus, `Esc` to clear

🔄 Sort
- Default (Manual), Date Added, Title, Domain, Most Visited, Last Visited
- Most Visited / Last Visited lazy-fetch chrome.history on first use

🤝 Drag & Drop
- Reorder: under Default (Manual) sort, drag onto another bookmark to insert above/below
- Move to folder: drag onto any sidebar folder
- Add tag: drag onto any sidebar tag
- Multi-select batch: select multiple bookmarks (checkbox or ⌘/Ctrl-click) and drag them as a group

🚨 Link Issues — broken + privacy / hygiene checks
- Broken links: manual scan that probes every URL (HEAD then GET, 6 concurrent, 7 s timeout)
- Sensitive token in URL: query/hash carries token / api_key / signature / password / secret etc.
- Localhost / private IP: localhost, 127.x, 10.x, 192.168.x, 169.254.x, ::1
- Internal URL: TLD-less or `.local` / `.internal` / `.test` / `.corp` / `.lan` etc.
- Magic-link / expiring auth URL: path is `/auth/verify`, `/magic-link`, `/reset-password` etc. AND query carries a signature/expiry
- Suspicious domain: punycode (xn--) or non-ASCII letters in hostname (homoglyph heuristic)
- HTTP only: non-HTTPS on a public host
- Privacy buckets are derived from URL pattern alone — visible immediately, no scan needed; only Broken Links requires the Scan All button

✅ Multi-select & Bulk Actions
- Select multiple bookmarks → a floating bulk bar appears
- Batch: add tags, AI auto-tag, delete (with 5-second Undo)

🤖 AI Feature (Bring Your Own Key)
- Supports Google Gemini, OpenAI, and Anthropic
- Auto-tag with AI: suggests up to 3 tags from title + URL
- Rename with AI: fetches page og:title / meta description, then asks the model for a cleaner title
- "AI first" toggle: when enabled, hover row buttons become AI versions; auto-disabled until you save an API key
- API requests only carry title + URL (Rename additionally reads the page head)
- Keys live in `chrome.storage.local` on this device only — never synced

↩️ Undo Everywhere
- Every destructive action shows a 5-second Undo toast — no native confirm popups
- Covers: delete bookmark, move bookmark, rename, delete tag / rename tag / clear all tags, delete saved search, delete folder (with bookmarks), remove duplicates

🔒 Permissions
- bookmarks — read/write Chrome bookmarks (the entire point)
- storage — local-only settings, tags, saved searches, API keys, linkStatus
- sidePanel — the UI surface
- tabs — open clicked bookmarks in new tabs
- history — Most Visited / Last Visited sort
- favicon — render bookmark favicons
- host_permissions — the three AI provider endpoints + `<all_urls>` (manual link scanner / AI rename head fetch)

No analytics. No remote sync. No account. No subscription. Every feature unlocked.