# 策展 · X (Twitter) 🔥

> 作者：Clelia Bertelli (🦙/acc) (@itsclelia) · 平台：X (Twitter) · 日期：2026-03-30

> 原始來源：https://x.com/itsclelia/status/2038342859641037300

## 中文摘要

litesearch 是一款完全本地化的語意搜尋 CLI 和 TUI 應用，整合了 LiteParse 解析引擎、Chonkie 分塊工具和 Qdrant Edge 向量儲存，無需外部服務即可實現文件攝取、嵌入和檢索的完整流程。

**核心工作流程**

litesearch 的文件攝取透過四階段管道運作：

- **解析階段**：使用 LiteParse 從文件中提取純文本，支援透過配置文件自訂解析邏輯
- **分塊階段**：透過 Chonkie 將文本分割成重疊的片段，預設為 512 字元
- **嵌入階段**：使用本地模型 `nomic-ai/nomic-embed-text-v1.5` 生成 768 維度的向量嵌入，透過 `@huggingface/transformers` 執行
- **儲存階段**：將向量及其 payload 寫入 Qdrant Edge 本地分片，持久化儲存於 `.litesearch.qdrant/` 目錄

檢索時，應用使用相同的嵌入模型對查詢進行向量化，隨後對本地分片執行餘弦相似度搜尋。

**技術堆疊**

- 向量儲存由 Rust 原生 addon（使用 napi-rs）提供，包裝 qdrant-edge 以支援磁碟型 mmap 備份儲存
- 專案依賴 Bun 作為執行時環境，Rust 工具鏈僅在重建 `qdrant-edge-utils` 時需要
- 程式碼庫分為 CLI 入口點、管道編排、解析、分塊、嵌入和儲存等模組

**使用介面與功能**

應用提供命令列和終端使用者介面兩種方式：

- **攝取命令** (`bun run ingest <file>`)：支援自訂 LiteParse 配置文件和分塊大小
- **檢索命令** (`bun run retrieve <query>`)：支援指定檔案範圍、結果數量上限和相似度閾值篩選
- **TUI 模式** (`bun run tui`)：提供互動式終端介面，引導使用者完成攝取和檢索操作

範例輸出顯示，查詢結果會返回相似度評分（如 0.8723）和對應的文本片段。

**本地化優勢**

整個流程在本地執行意味著無隱私風險、無網路依賴、無外部服務費用。向量儲存可透過刪除 `.litesearch.qdrant/` 目錄快速重置，易於管理和維護。

## 標籤

CLI, 開源專案, RAG, Embedding, litesearch