使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 6 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月3日),安裝前請先考慮。
crates:calamine 0.37.0在 CFB/OLE2 解析器中,格式錯誤的輸入會導致 Panic 與無限制配置(OOM) (RUSTSEC-2026-0436,高風險,0.38.0 已修正)crates:openssl 0.10.77rust-openssl 在 AES 金鑰包裝中的邊界斷言錯誤 (GHSA-8c75-8mhr-p7r9,高風險,0.10.78 已修正)
再看 4 個
crates:openssl 0.10.77— GHSA-ghm9-cr32-g9qj(高風險),0.10.78 已修正crates:openssl 0.10.77— GHSA-hppc-g8h3-xhp3(高風險),0.10.78 已修正crates:openssl 0.10.77— GHSA-pqf5-4pqq-29f5(高風險),0.10.78 已修正crates:openssl 0.10.77— GHSA-xp3w-r5p5-63rr(高風險),0.10.79 已修正
Linux x86_64
需要先準備
- 執行環境:
Rust 1.89 or later - 需要網路
從 GitHub releases 下載預先建置的 Linux x86_64 壓縮檔
curl -L -o /tmp/grooveseek.tar.xz https://github.com/alphabet-h/grooveseek/releases/download/v1.23.0/grooveseek-x86_64-unknown-linux-gnu.tar.xz && mkdir -p /tmp/groove-extract && tar -xf /tmp/grooveseek.tar.xz -C /tmp/groove-extract將 groove 執行檔安裝至 ~/.local/bin
mkdir -p ~/.local/bin && cp /tmp/groove-extract/grooveseek-x86_64-unknown-linux-gnu/groove ~/.local/bin/groove && chmod +x ~/.local/bin/groove
確認能用
groove --version輸出應包含「groove 1.23.0」。
先試試這個
mkdir -p /tmp/kb && cat > /tmp/kb/intro.md <<'EOF'
---
title: Introduction
date: 2024-01-01
topic: general
depth: 1
tags: [intro, overview]
---
# Introduction
GrooveSeek is a knowledge base search system.
## Semantic Chunking
Semantic chunking splits documents into meaningful pieces based on headings.
It uses embeddings to find relevant content.
## Features
GrooveSeek supports hybrid search combining semantic and full-text search.
EOF
cat > /tmp/kb/advanced.md <<'EOF'
---
title: Advanced Guide
date: 2024-02-15
topic: advanced
depth: 2
tags: [search, hybrid]
---
# Advanced Guide
## Hybrid Search
Hybrid search combines vector similarity with keyword matching for better results.
## Embeddings
Embeddings are generated with FastEmbed using BGE models for semantic search.
## Live Sync
A file watcher keeps the index fresh when files change.
EOF
ls -l /tmp/kb/
cat /tmp/kb/intro.md
groove index --kb-path /tmp/kb 2>&1加進你的 agent
claude mcp add grooveseek -- groove serve --kb-path '<kb-path>'Claude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"grooveseek": {
"command": "groove",
"args": [
"serve",
"--kb-path",
"<kb-path>"
]
}
}
}請把 <kb-path> 換成你自己的路徑。
執行 groove serve --kb-path <your knowledge base folder>,並將 MCP 用戶端連線到它。
它能做什麼
- 以混合搜尋搜尋 Markdown 知識庫已測試
怎麼使用
- 將 Markdown 筆記放在資料夾中,例如 <kb folder>。
- 用
groove serve --kb-path <kb folder>啟動伺服器,並連線 MCP 用戶端。 - 以查詢內容與數量上限呼叫
search工具,例如 {"query": "<your text>", "limit": 3}。
- 產生 embedding 以進行語意向量搜尋沒有看到它可用
- 檔案變更時保持索引最新未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 3 項功能中 1 項可用
- 需要網路
適合用來
- 為 Markdown 知識庫建立索引
- 搜尋已索引的知識庫區塊
可替代 QMD。
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 需要網路
- 檢查於 2026年10月31日
- 版本 1.23.0
MCP 用戶端透過 stdio 連線,列出 6 個工具,呼叫 search 也回傳了結果。
測試機器遇到的差異
- README: cargo build --release (needs Rust 1.89+)
測試中: 由於沒有 Rust 工具鏈,改用 GitHub releases 的預先建置執行檔 grooveseek-x86_64-unknown-linux-gnu.tar.xz(glibc 2.41 符合 2.38+ 的需求)