展示 HN：通过 CLI 在您的本地笔记上进行开源语义搜索

展示 HN：通过 CLI 在您的本地笔记上进行开源语义搜索
Show HN: Open-source semantic search over your local notes via CLI

原始链接: https://github.com/chenxin-yan/nia-vault

## Nia-Vault：AI驱动的本地搜索 Nia-Vault是一个CLI工具，允许你使用AI驱动的语义搜索查询本地笔记和文件，由Nia提供支持。它与`nia-sync`无缝集成，用于访问和搜索同步文件夹。 **主要特性：** * **语义搜索：** 用自然语言提问以找到相关信息。 * **多文件夹支持：** 在多个同步文件夹中搜索。 * **易于设置：** 使用现有的`nia-sync`凭据，并提供交互式初始化向导。 * **灵活同步：** 按需同步文件夹或在每次搜索前同步。 **安装：** 需要Node.js 18+ 或 Bun，以及配置好的`nia-sync`（使用`pip install nia-sync`安装并使用`nia login`进行身份验证）。使用`bun install -g nia-vault` 或 `npm/pnpm install -g nia-vault`全局安装`nia-vault`。使用`vault init`配置搜索文件夹，然后使用`vault ask "你的问题"`开始。选项包括指定文件夹（`-f`），结果限制（`-l`）和强制同步（`-s`）。配置存储在`~/.config/nia-vault/config.json`中。

## Nia Vault：本地笔记的语义搜索 Nia Vault 是一款新的开源命令行工具，可以对本地 markdown 和文本文件进行语义搜索。它允许你使用自然语言查询笔记，并从你的文件中获得带有引用的 RAG 风格（检索增强生成）答案。该工具通过查询 `POST /search/query` 端点工作，利用一种专注于返回源文件的 `search_mode`。用户可以提出诸如“我关于项目计划的笔记有哪些？”的问题，并从自己的文档中获取相关信息。目前在 GitHub 上可用 (https://github.com/chenxin-yan/nia-vault)，Hacker News 上的讨论将其与 QMD 进行了比较，并质疑 API 密钥的用途，该密钥似乎连接到 Nia API 以提供上下文并防止响应中的“幻觉”。

原文

A CLI application for querying your local notes and files using AI-powered semantic search via Nia.

Semantic Search: Query your notes using natural language
Multiple Folders: Search across multiple synced folders
Seamless Integration: Automatically uses credentials from nia-sync
Flexible Sync: Sync folders on-demand or before searches

Node.js >= 18.0.0 or Bun
nia-sync installed and configured

# Install nia-sync
pip install nia-sync

# Authenticate with Nia
nia login

# Add folders to sync
nia add ~/Documents/notes
nia start

# With Bun (recommended)
bun install -g nia-vault

# With npm
npm install -g nia-vault

# With pnpm
pnpm install -g nia-vault

After installation, the vault command is available globally.

# Initialize nia-vault (select which folders to search)
vault init

# Ask a question
vault ask "What are my notes about project planning?"

# Sync folders before searching
vault ask "meeting notes from last week" --sync

Interactive setup wizard that detects your nia-sync configuration and lets you select which folders to include in searches.

Query your notes using semantic search.

Options:

Flag	Description
`-f, --folder <id>`	Search specific folder only
`-l, --limit <n>`	Max results (default: 5)
`-s, --sync`	Sync folders before searching

Manually trigger a sync of all folders.

List, add, or remove folders from search scope.

View or reset configuration.

nia-sync Configuration (read-only)

nia-vault reads the API key from ~/.nia-sync/config.json. This file is managed by nia-sync.

Location: ~/.config/nia-vault/config.json

{
  "selectedFolders": ["folder-id-1", "folder-id-2"]
}

This file only stores which folders are included in searches. The API key is always read from nia-sync.

Error	Solution
`nia-sync not configured`	Run `nia login` to authenticate
`No configuration found`	Run `vault init` to set up
`Invalid API key`	Run `nia login` to re-authenticate
`No synced folders found`	Run `nia add ~/path` to add folders
`No folders selected`	Run `vault folders` to select folders
`Could not connect to Nia API`	Check your internet connection

When making changes that should be included in a release, please add a changeset:

This will prompt you to describe your changes. Choose the appropriate version bump:

patch (0.0.x): Bug fixes, small improvements, documentation updates
minor (0.x.0): New features, non-breaking changes
major (x.0.0): Breaking changes

The changeset file should be committed with your PR.

# Clone the repository
git clone https://github.com/chenxin-yan/nia-vault.git
cd nia-vault

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build the project
bun run build

MIT

展示 HN：通过 CLI 在您的本地笔记上进行开源语义搜索 Show HN: Open-source semantic search over your local notes via CLI

nia-sync Configuration (read-only)

展示 HN：通过 CLI 在您的本地笔记上进行开源语义搜索
Show HN: Open-source semantic search over your local notes via CLI