介绍
# GNO - Local Knowledge Engine
快速的本地语义搜索。一次索引，即时搜索。无云端，无 API 密钥。
## 何时使用此技能
- 用户要求**搜索文件、文档或笔记** - 用户想要在本地文件夹中**查找信息** - 用户需要**对目录进行索引**以进行搜索 - 用户提到要搜索 **PDF、markdown、Word 文档、代码** - 用户询问关于**知识库**或 **RAG** 的设置 - 用户希望对其文件进行**语义/向量搜索** - 用户需要**设置 MCP** 以访问文档 - 用户想要一个**Web UI** 来浏览/搜索文档 - 用户要求从文档中**获取 AI 答案** - 用户想要对文档进行**标记、分类或筛选** - 用户询问关于**反向链接、wiki 链接或相关笔记** - 用户想要**可视化文档连接**或查看**知识图谱**
## 快速开始
```bash gno init # Initialize in current directory gno collection add ~/docs --name docs # Add folder to index gno index # Build index (ingest + embed) gno search "your query" # BM25 keyword search ```
## 命令概览
| 类别 | 命令 | 描述 | | ------------ | ---------------------------------------------------------------- | --------------------------------------------------------- | | **搜索** | `search`, `vsearch`, `query`, `ask` | 通过关键词、含义查找文档，或获取 AI 答案 | | **链接** | `links`, `backlinks`, `similar`, `graph` | 导航文档关系并可视化连接 | | **检索** | `get`, `multi-get`, `ls` | 通过 URI 或 ID 获取文档内容 | | **索引** | `init`, `collection add/list/remove`, `index`, `update`, `embed` | 设置和维护文档索引 | | **标签** | `tags`, `tags add`, `tags rm` | 组织和筛选文档 | | **上下文** | `context add/list/rm/check` | 添加提示以提高搜索相关性 | | **模型** | `models list/use/pull/clear/path` | 管理本地 AI 模型 | | **服务** | `serve` | 用于浏览和搜索的 Web UI | | **MCP** | `mcp`, `mcp install/uninstall/status` | AI 助手集成 | | **技能** | `skill install/uninstall/show/paths` | 为 AI 代理安装技能 | | **管理** | `status`, `doctor`, `cleanup`, `reset`, `vec`, `completion` | 维护和诊断 |
## 搜索模式
| 命令 | 速度 | 最适用于 | | ---------------------- | ------- | ---------------------------------- | | `gno search` | 即时 | 精确关键词匹配 | | `gno vsearch` | ~0.5s | 查找相似概念 | | `gno query --fast` | ~0.7s | 快速查找 | | `gno query` | ~2-3s | 均衡（默认） | | `gno query --thorough` | ~5-8s | 最佳召回率，复杂查询 | | `gno ask --answer` | ~3-5s | 带引用的 AI 生成答案 |
**重试策略**：首先使用默认模式。如果没有结果：重新表述查询，然后尝试 `--thorough`。
## 常用标志
``` -n <num> Max results (default: 5) -c, --collection Filter to collection --tags-any <t1,t2> Has ANY of these tags --tags-all <t1,t2> Has ALL of these tags --json JSON output --files URI list output --line-numbers Include line numbers ```
## 全局标志
``` --index <name> Alternate index (default: "default") --config <path> Override config file --verbose Verbose logging --json JSON output --yes Non-interactive mode --offline Use cached models only --no-color Disable colors --no-pager Disable paging ```
## 重要：更改后进行嵌入
如果您编辑/创建的文件应可通过向量搜索找到：
```bash gno index # Full re-index (sync + embed) # or gno embed # Embed only (if already synced) ```
MCP `gno.sync` 和 `gno.capture` 不会自动嵌入。请使用 CLI 进行嵌入。
## 参考文档
| 主题 | 文件 | | ----------------------------------------------------- | ------------------------------------ | | 完整 CLI 参考（所有命令、选项、标志） | [cli-reference.md](cli-reference.md) | | MCP 服务器设置和工具 | [mcp-reference.md](mcp-reference.md) | | 使用示例和模式 | [examples.md](examples.md) |