Show HN:本地優先的 CLI 工具,讓 Obsidian 倉庫對 AI 智能體可搜索
NoteBrain 是一個 Go 語言編寫的 CLI 工具,可將 Obsidian 筆記倉庫轉為離線知識後端,供 AI 編碼智能體使用。它通過本地 ChromaDB 向量數據庫實現語義搜索、維基鏈接圖遍歷和隱藏連接發現,並支持結構化輸出。工具內置 AI 智能體技能和 OpenCode 代理配置,可輕鬆集成到自主編碼工作流中。
NoteBrain 是一款由 Go 語言構建的命令行工具,旨在將 Obsidian 筆記倉庫轉化為完全離線的知識後端,供 AI 編碼智能體使用。該工具索引 Markdown 筆記至本地 ChromaDB 向量數據庫,並通過結構化輸出提供語義搜索、維基鏈接圖遍歷以及隱藏連接發現等功能,可直接被自主智能體、Shell 管道和 LLM 工具調用工作流所使用。
項目作者 Nimendra 表示,他日常使用 Obsidian 作為主要筆記工具,當 AI 智能體興起時,他希望能將 Obsidian 倉庫用作 RAG 系統,但現有解決方案無法滿足需求。受到一篇文章啓發後,他構建了此工具用於個人使用,並鼓勵用户根據自身需求 fork 和修改。
NoteBrain 的主要功能包括:語義搜索(使用離線 all-MiniLM-L6-v2 ONNX 嵌入模型)、多查詢搜索(提升複雜主題檢索效果)、知識圖譜遍歷(通過反向鏈接、多跳連接和共享標籤關係探索維基鏈接圖)、隱藏連接發現(發現未顯式鏈接但語義相關的筆記,支持可選的深度章節級分析)、圖譜增強排序(結合語義相似性和圖關係提升搜索相關性)、交互式終端 UI(模糊搜索界面及智能引導)等。此外,它還支持高級過濾(按章節、標籤、代碼塊、任務等過濾)、完整筆記重構、結構化輸出(JSON/TSV,內置 JSONPath 查詢)、AI 智能體集成、終端超鏈接、編輯器集成和 Obsidian 感知索引(尊重 Obsidian 配置)。目前該工具僅支持 Markdown 文本,不支持 PDF 或圖片 OCR。
技術實現上,NoteBrain 採用 Goldmark AST 感知分塊(按標題層級分割,而非任意字符偏移),嚴格保留列表、GFM 表格、引用/標註和代碼塊;使用嵌入式 ChromaDB 在磁盤上存儲向量;通過 SHA-256 內容哈希實現增量攝取,重複運行時僅需毫秒即可跳過未修改筆記。
安裝需要 Go 1.26.4+、CGO 啓用的工具鏈以及 Linux 環境(macOS 和 Windows 二進制文件未經測試)。用户可從 GitHub Releases 頁面下載預構建二進制文件,或從源碼編譯。快速入門包括索引倉庫、語義搜索、深度隱藏連接發現、獲取結構化輸出等步驟。工具還支持通過 cron 或 systemd 定時器自動索引。
配置方面,NoteBrain 從 ~/.notebrain/config/config.toml 讀取 TOML 格式配置文件,CLI 標誌可覆蓋 TOML 值。關鍵設置包括倉庫路徑、名稱、輸出格式等。所有持久化數據存儲在 ~/.notebrain/ 下。文檔涵蓋了安裝、命令參考、架構、定時攝取和 AI 智能體使用等內容。項目採用 MIT 許可證,歡迎貢獻。