Buzee 是什麼？開源檔案全文搜尋工具實測，中文搜尋卡在斷詞

Facebook Line Messenger Telegram

Mac 有 Spotlight，Windows 有內建搜尋和老牌的 Everything，多數人的檔案搜尋就停在這一步。Buzee 是另一種嘗試：一個免費開源、安裝在本機的全文搜尋工具，連檔案「內文」都建進索引，還能搜瀏覽器歷史。它由開發者 Gurjot Sidhu 用兩年業餘時間打造，曾經想做成一門生意，失敗之後在 2024 年 12 月整包開源。

我把它的最後一版 v0.2.1 裝進 macOS 26 實測，先講結論：程式還跑得動，英文檔案的內文搜尋真的好用；但中文內文搜尋卡在斷詞器沒有中文支援，官網宣稱的圖片文字搜尋也沒有兌現。它比較接近一份可以自由取用的技術遺產，而不是能長期依賴的日常工具。

Spotlight 也會搜內容，Buzee 多給的是查詢方式

先誠實面對一個前提：Spotlight 本身就會搜檔案內容，不是只有檔名。Buzee 想多給的是查詢的表達方式。它支援用引號鎖定精確片語（"annual report"）、在關鍵字前面加連字號排除（-pdf），也能把日期直接寫進查詢裡，像 invoice pdf last month 或 annual report q2 2023 to q3 2023 這種寫法，它會自己換算成時間範圍。

搜尋範圍也不只文件：csv、docx、pdf、pptx、xlsx 這類文件，epub、mobi 電子書，jpg、png 圖片，mp3、mp4 等音訊視訊檔都在預設支援清單，另外會直接去讀 Chrome、Firefox 與 Arc 三套瀏覽器的歷史資料庫，把造訪紀錄一起納入搜尋。這個設計等於把「找檔案」和「找我去過哪個網站」放進同一個搜尋框。

整個程式用 Tauri 加 Rust 打造，索引存在本機的 SQLite 資料庫，搭配全文檢索引擎 Tantivy，安裝後佔 27MB，以 MIT 授權開源。同樣走開源路線的搜尋工具還有主打 AI 網路搜尋的 scira，兩者定位不同，一個挖你自己的硬碟，一個挖網路。

兩年前的最終版，裝進最新 macOS 還能跑

先看維護狀態，這會影響你所有後續期待。GitHub 上的版本發佈停在 2024 年 12 月 18 日的 v0.2.1，原始碼主分支的實質開發停在 2024 年 12 月 15 日，之後唯一的一筆變更是 2025 年 12 月把 README 裡的官網網址換掉。接近兩年沒有新版本，也沒有修 bug。

我在 macOS 26.6.2 的 Mac 上裝 Apple Silicon 版，可以正常啟動、建索引、搜尋。過程有兩件事要先知道。其一是簽名狀態：我用 codesign 檢查這個版本，它是 adhoc 簽名、未經 Apple 公證，系統安全性工具也直接判定拒絕。從瀏覽器下載的話，第一次打開會被 Gatekeeper 擋下，需要到系統設定裡手動放行。這一步值不值得做，取決於你信不信一份停在 2024 年的安裝包。

其二是版本陷阱：官網下載頁的 Windows 按鈕連的是 2024 年 5 月的 v0.1.1 舊版，不是最終版。更進一步看，v0.2.1 其實只出了 Mac 版，Windows 的最後一個安裝包是 releases 專頁裡 v0.2.0 的 .msix，想裝 Windows 版只能退一版抓。

順帶一提，官網本身有兩個網址並存：原本的 buzee.co 至今仍可連上，2025 年 12 月作者把原始碼文件裡的連結改指到 buzee.thatgurjot.com，兩邊是同一套網站、內容幾乎一致。程式內建的自動更新檢查打的則是那份 2024 年就凍結的版本資訊檔，也就是說它每次啟動都會確認更新，但永遠不會真的等到新版。

第一次啟動時，歡迎畫面直接寫著它的承諾：掃描結果會存在你文件夾裡的資料庫，「你的資料永不出你的電腦」。它預設想掃整個家目錄，過程會接連跳出媒體庫、桌面、下載夾的系統權限詢問；不想要這麼大範圍的人可以改走手動模式，自己指定資料夾，我就是用手動模式做後面的測試。事後檢查，它在我機器上建的資料庫就放在文件夾裡一個自己的子目錄，索引範圍完全照指定走，沒有多掃一個檔案；退出程式後也沒有登入項或背景常駐留下來，把應用程式與資料庫目錄刪掉就是乾淨移除。

Buzee 首次啟動的權限說明畫面，卡片文字寫明掃描結果存在本機資料庫、使用者資料不出自己的電腦 — Buzee 首次啟動畫面直接寫出資料不出本機的承諾，也可選手動模式自訂索引範圍

英文內文搜尋：找得到檔名裡根本沒有的字

這是 Buzee 最有價值的部分，我設計了一個最小測試：放一個 Markdown 檔，檔名完全不提內容，只在內文寫了一種澳洲小袋鼠 quokka。索引完成後搜「quokka」，它直接命中這個檔案。

結果列表有檔名、修改時間、大小、完整路徑，可以切換緊湊表格或帶預覽的版型，也能用位置、檔案類型、日期範圍過濾。對英文文件、程式碼、編號報告堆成山的人，這種「只記得內容裡某個單字」的找法，確實比翻資料夾省力。

Buzee 以英文單字 quokka 搜尋的結果畫面，命中內文含有這個單字的 english-notes.md 檔案 — 英文內文搜尋實測：只存在檔案內文、檔名裡沒有的單字也能命中

它還把「隨叫隨到」做成了預設行為：全域快捷鍵 Option 加空白鍵，在任何畫面按下去就浮出搜尋框，離開就縮走，不用駐留在 Dock。附帶一個快速筆記本（Cmd 加 Shift 加 S 呼叫），打完自動存成檔案，而這個檔案接著就進索引、變得可搜尋。設定頁裡有檔案類型清單與忽略清單，可以把整個資料夾排除在索引外，或只排除內文掃描；統計頁則會算出你的文件組成，作者叫它個人文件側寫。

中文搜尋實測：標點救了它，連寫毀了它

中文環境是另一個故事。我準備了兩個純文字檔：一個寫「台積電、聯發科都在台灣。」，靠頓號斷開；另一個寫「台積電工程師的年度報告完成了嗎」，一路連寫到底。兩個檔案都完成了索引，內文也確實被抽出存進資料庫。

接著搜「台積電」。結果只出現標點分隔的那個檔案，連寫的那個完全沒有命中。

Buzee 以中文關鍵字台積電搜尋的結果畫面，只有標點分隔的測試檔案出現在結果列表 — 中文搜尋實測：同樣寫著台積電的兩個檔案，只有標點分隔的那個被找到

原因在斷詞。全文搜尋要先把文章切成一個個詞，才能建索引。Buzee 的兩層索引都用英文思路的切法：SQLite 的 FTS5 設了 porter unicode61 斷詞器，Tantivy 用預設的 SimpleTokenizer，兩者都只按空格和標點切，不認得中文的詞界。英文單字之間有空格，這套邏輯運作良好；中文句子沒有空格，一整句連寫會被當成同一個詞，你搜句子裡的任何一段都找不到。我用相同的 FTS5 設定另外做了一次資料庫實驗，行為完全一致：這是寫進架構的限制，不是設定沒調好，也不會因為等它更新就解決，除非整個斷詞器被換掉。

對台灣讀者的實際意義：檔名或內文裡有標點、空格隔開的中文，還能部分命中；純中文連寫的內文搜尋基本不能用。英文檔案不受影響。實測裡唯一的例外是把整句一字不漏地貼進搜尋框可以命中連寫檔，但連內容都要先背起來了，這已經不叫搜尋。

官網說圖片裡的文字也搜得到，我沒有重現出來

官網把「搜尋圖片裡的文字」列為賣點，背後用的是 macOS 與 Windows 的原生辨識引擎（Mac 版捆了 textra 命令列工具，Windows 版捆 winocr，還會在處理 PDF 時臨時從第三方的 GitHub 專案下載 Poppler 轉檔器）。

我做了一張 685KB、內含一個罕見英文字的 PNG 放進索引資料夾，這張遠超過原始碼裡寫死的 50KB 門檻（低於門檻的圖程式會直接跳過）。兩輪同步之後，資料庫裡這張圖的解析狀態一直是零，沒有抽出任何文字，負責辨識的元件也沒有產出。沒有兌現的原因我無法確認，但事實就是：在 2024 年的最終版配上 2026 年系統的組合下，這個功能沒有發生。想把「找圖片裡的文字」當理由的人，先把它從清單上劃掉。

「資料不出本機」的承諾，在原始碼層站得住

隱私政策只有短短幾行，兩個承諾：不追蹤可識別個人的資訊、永遠不把用戶資料上傳到任何伺服器。我把整包原始碼抓下來找對外連線：索引與搜尋全部在本機完成，整個程式只有兩個網路觸點，一個是啟動時向 GitHub 檢查更新的 json 檔，一個是 Windows 版下載 Poppler。沒有任何把你的資料送出去的管道。

還有一個反向的細節：政策寫著「使用 Aptabase 收集匿名使用統計」，但原始碼裡 Aptabase 的初始化呼叫在 2024 年 5 月就被註解掉，最終版裡五十多個埋點呼叫全部形同空線，一個封包都不會送出去。政策比代碼講得多，對隱私來說是好消息，對文件維護來說是停更的另一個痕跡。官網本身用 GoatCounter 做匿名統計，那是網站層的事，與程式無關。

這種「宣稱本機處理，代碼層真的沒有外送」的組合，近來在開源工具裡逐漸成為可檢驗的常態，換臉工具 magicmirror 的零遙測設計是另一個例子。

作者把失敗原因講得很少見地清楚

Buzee 的來歷本身就是故事。開源當天，作者在 Hacker News 發文，標題直接寫「把我失敗的新創開源」，拿到 229 分與 84 則討論。他自述的失敗原因很具體：目標放在辦公室場景，實際去幫辦公室裝機後發現，企業電腦不給裝未簽名的程式，而 Windows 的簽章證書要價 500 美元，他負擔不起；真正有痛點的 Windows 用戶他反而服務不到，因為他自己只有 Mac，測 Windows 靠一台十年的老筆電。

更大的問題是需求本身。他寫下一段很誠實的觀察：日常辦公的人有自己的檔案管理慣性，有人把所有東西塞進一份千頁 Word 文件，用文件內的 Ctrl+F 就解決了，根本不想換搜尋工具。他的原話是，這個專案最後變成他為了學新技術而不斷打磨的熱情作品，而不是為用戶創造價值的產品。檔案搬到 Google Drive 與 OneDrive 的趨勢，也讓本機搜尋的舞臺一直縮小。

數字也說了話：全部版本累積下載約 3,453 次，GitHub 上 1,144 顆星。作者不是職業開發者，做這個專案的養分之一來自 SQLite 圈的名人 Simon Willison 的作品，現在則開放任何人接手：MIT 授權、樂於幫你讀懂程式碼，還留了一份完整的開發筆記。想深入研究別人專案的人，可以搭配 gitingest 把整個 repo 轉成好讀的摘要。

一些痕跡還留在原地：官方部落格最後一篇停在 2024 年 5 月；開發筆記裡畫好的下一階段藍圖，想用瀏覽器擴充把 Gmail、Notion、YouTube 的內容全部收進索引，從未問世。連名字都是私人的：Buzee 是作者養的狗，一隻不會撿球但很愛人的拉布拉多，他在討論串裡替牠留過一個介紹網址，如今已經連不上。