名称： gno
描述： 搜索本地文档、文件、笔记和知识库。索引目录，使用 BM25/向量/混合搜索，获取带引用的 AI 答案。当用户想要搜索文件、查找文档、查询笔记、在本地文件夹中查找信息、索引目录、设置文档搜索、构建知识库、需要 RAG/语义搜索，或想为其文档启动本地 Web UI 时使用。
允许工具： Bash(gno:*) Read
快速的本地语义搜索。一次索引，即时搜索。无需云端，无需 API 密钥。
gno init # 在当前目录初始化
gno collection add ~/docs --name docs # 添加文件夹到索引
gno index # 构建索引（摄取 + 嵌入）
gno search "你的查询" # BM25 关键词搜索
| 类别 | 命令 | 描述 |
|---|---|---|
| 搜索 | 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.5秒 | 查找相似概念 |
gno query --fast |
~0.7秒 | 快速查找 |
gno query |
~2-3秒 | 平衡模式（默认） |
gno query --thorough |
~5-8秒 | 最佳召回率，复杂查询 |
gno ask --answer |
~3-5秒 | 带引用的 AI 生成答案 |
重试策略：首先使用默认模式。若无结果：重新表述查询，然后尝试 --thorough。
-n <num> 最大结果数（默认：5）
-c, --collection 筛选到指定集合
--tags-any <t1,t2> 包含任意这些标签
--tags-all <t1,t2> 包含所有这些标签
--json JSON 输出
--files URI 列表输出
--line-numbers 包含行号
--index <name> 使用备用索引（默认："default"）
--config <path> 覆盖配置文件路径
--verbose 详细日志
--json JSON 输出
--yes 非交互模式
--offline 仅使用缓存的模型
--no-color 禁用颜色
--no-pager 禁用分页
如果您编辑/创建了需要通过向量搜索的文件：
gno index # 完全重新索引（同步 + 嵌入）
# 或
gno embed # 仅嵌入（如果已同步）
MCP 的 gno.sync 和 gno.capture 不会自动嵌入。请使用 CLI 进行嵌入。
| 主题 | 文件 |
|---|---|
| 完整的 CLI 参考（所有命令、选项、标志） | cli-reference.md |
| MCP 服务器设置和工具 | mcp-reference.md |
| 使用示例和模式 | examples.md |