# 洗衣機保固寫在哪？用 NoteDiscovery 在三百篇筆記裡十幾毫秒找到

- 網址：https://blog.valenvan.uk/posts/gamosoft-notediscovery.html
- 發布日期：2026-11-05
- 測試設備：Mac mini M4 Pro（12 核、64GB）
- 專案：gamosoft/NoteDiscovery（https://github.com/gamosoft/NoteDiscovery），MIT 授權
- 測試版本：main 分支（2026-11-04）
- 實測影片：https://www.youtube.com/shorts/gZtag5i7MCg

## 重點摘要

- 在 Mac mini M4 Pro 上，用虛擬環境安裝 NoteDiscovery 約 11 秒完成。
- 約 300 篇、共約 1.3MB 的家用筆記，搜「保固」約 14 毫秒找到目標筆記，搜內文裡的「客服」約 13 毫秒。
- 兩個程序合計約 71MB 記憶體。
- 文末的 #標籤 不會被算成標籤，要寫在檔頭的 tags；連結要寫含資料夾的完整路徑才連得上。
- **結論：** 筆記不多、想自己顧資料的人，值得裝；手機與多人共用未測。
- **適合：** 想把家用筆記放在自己電腦、用純文字檔保存的人
- **不適合：** 需要手機離線編輯、多人協作，或不想自己安裝的人

| 實測項目 | 結果 |
|---|---|
| 筆記數量 | 約 300 篇（1.3MB） |
| 安裝時間 | 約 11 秒 |
| 搜尋「保固」 | 約 14 毫秒 |
| 搜尋「客服」（內文） | 約 13 毫秒 |
| 記憶體 | 約 71MB（兩個程序） |
| 文末 #標籤 | 0 個標籤 |
| 檔頭 tags | 認得 3 個標籤 |

洗衣機突然不動了，客服問你保固到什麼時候。你翻了手機備忘錄、LINE 的「我的筆記」，最後還在抽屜裡找發票。家裡的資料散在好幾個地方，要用的時候才發現找不到。

NoteDiscovery 是一套免費、自己架的筆記網站（MIT 授權），筆記就是一個個純文字的 Markdown 檔，放在資料夾裡。這次的實測不是看介紹，而是真的架起來、塞進三百篇家用筆記，看它找不找得到那一篇保固。

測試設備：Mac mini M4 Pro（12 核、64GB）。受測版本為 2026-11-04 當天的 main 分支。

## 怎麼裝

需要 Python 3 與 pip。我用虛擬環境安裝，約 11 秒完成：

```bash
git clone https://github.com/gamosoft/NoteDiscovery.git
cd NoteDiscovery
python3 -m venv venv
venv/bin/pip install -r requirements.txt
venv/bin/python run.py
```

啟動後打開 `http://localhost:8000` 就是筆記畫面，第一次啟動沒有任何筆記。專案也提供 Docker 的裝法，README 有完整指令，這次沒測。

## 我怎麼測

我用腳本造了 300 篇家用筆記，分成食譜、旅遊、帳單、讀書心得、工作會議、健身、植物、維修八個資料夾（每篇約一百多字，內容是隨機組出來的家用詞彙），再手寫一篇「洗衣機保固」藏在維修資料夾。首頁看起來是這樣：

![八個資料夾的首頁](https://blog.valenvan.uk/img/gamosoft-notediscovery-article_1.png)

那一篇的內容很簡單，記著買的時間、保固到哪一天、發票放哪裡：

![洗衣機保固這篇筆記](https://blog.valenvan.uk/img/gamosoft-notediscovery-article_2.png)

## 搜尋結果

| 項目 | 結果 |
|---|---|
| 筆記數量 | 約 300 篇，共約 1.3MB |
| 安裝時間 | 約 11 秒（含建立虛擬環境） |
| 搜「保固」 | 找到維修/洗衣機保固.md，約 14 毫秒（首次查詢約 32 毫秒） |
| 搜內文裡的「客服」 | 找到同一篇，約 13 毫秒 |
| 記憶體 | 兩個程序合計約 71MB |

搜尋會比對內文，不只標題，所以不用記得當初把筆記取什麼名字。

## 踩到的兩個雷

**一、文末打 `#標籤` 不算標籤。** 我照在其他筆記軟體的習慣，在文章最後寫 `#維修 #保固`，結果標籤清單是空的。要把標籤寫在檔案最上面：

```markdown
---
tags: [維修, 保固]
---
# 洗衣機保固
```

改完以後標籤清單馬上出現「保固、帳單、維修」三個。

**二、連結要寫完整路徑。** 我一開始只寫 `[[旅遊1]]` 這種名字，關係圖上沒有連線；改成 `[[維修/洗衣機保固]]` 這樣帶資料夾路徑，關係圖才出現「家電清單 → 洗衣機保固」的連線。這是我這次測試中的觀察，若你的筆記放在同一層，結果可能不同。

另外用 curl 自己呼叫搜尋介面時，中文要用 `--data-urlencode` 編碼，直接把中文貼在網址會失敗；用網頁畫面操作則不會有這個問題。

## 沒測到的部分

這次只測了網頁版的搜尋、標籤、連結圖與寫入。手機操作、多人共用、登入密碼、分享連結、匯出與 AI 助理（MCP）功能都沒有測。

## 我的看法

適合：筆記量不算誇張、想把資料留在自己手上、不想被某個筆記軟體綁住的人。筆記全是純文字檔，哪天不想用了，整個資料夾搬走就好。

不適合：需要手機隨時離線編輯、多人同時協作，或不想碰任何安裝步驟的人，這些我沒有驗證到。

專案連結：https://github.com/gamosoft/NoteDiscovery　授權：MIT