AI News HubLIVE
站內改寫2 分鐘閱讀

Show HN:本地優先的 CLI 工具,讓 Obsidian 倉庫對 AI 智能體可搜索

NoteBrain 是一個 Go 語言編寫的 CLI 工具,可將 Obsidian 筆記倉庫轉為離線知識後端,供 AI 編碼智能體使用。它通過本地 ChromaDB 向量數據庫實現語義搜索、維基鏈接圖遍歷和隱藏連接發現,並支持結構化輸出。工具內置 AI 智能體技能和 OpenCode 代理配置,可輕鬆集成到自主編碼工作流中。

來源Hacker News AI作者: nmdra

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 許可證,歡迎貢獻。