searching-context

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenViking (OV) context searching

OpenViking（OV）上下文搜索

The

ov search

command performs context-aware retrieval across all memories and resources in OpenViking — combining semantic understanding with directory recursive retrieval to find the most relevant context for any query.

ov search

命令可在OpenViking的所有记忆和资源中执行上下文感知检索——结合语义理解与目录递归检索，为任意查询找到最相关的上下文。

Table of Content

When to Use
Search Modes
- Context-Aware Search (
```
ov search
```
  )
- Content Pattern Search (
```
ov grep
```
  )
- File Glob Search (
```
ov glob
```
  )
Search Options
- Result Control
- Scope Control
- Session-Aware Search
Output
Other Utilities
- List Contents (
```
ov ls
```
  )
- Tree View (
```
ov tree
```
  )
- Read File Content (
```
ov read
```
  )
Agent Best Practices
- Choosing Search Methods
- Query Formulation
- Combining with Other Commands
Prerequisite

使用场景
搜索模式
- 上下文感知搜索（
```
ov search
```
  ）
- 内容模式搜索（
```
ov grep
```
  ）
- 文件通配符搜索（
```
ov glob
```
  ）
搜索选项
- 结果控制
- 范围控制
- 会话感知搜索
输出
其他实用工具
- 列出内容（
```
ov ls
```
  ）
- 树形视图（
```
ov tree
```
  ）
- 读取文件内容（
```
ov read
```
  ）
Agent最佳实践
- 选择搜索方法
- 查询表述
- 与其他命令结合使用
前提条件

When to Use

使用场景

Finding specific information within imported resources or saved memories
Retrieving context about topics, APIs, or patterns previously added
Searching across project documentation, code, and learnings
When an agent needs to reference previously stored knowledge

note: cli command can be outdated, when sees error, use
--help
to get latest usage

在已导入的资源或保存的记忆中查找特定信息
检索之前添加的主题、API或模式相关上下文
跨项目文档、代码和学习资料进行搜索
当Agent需要参考之前存储的知识时

注意：CLI命令可能会过时，若遇到错误，请使用
--help
获取最新用法

Search Modes

搜索模式

Context-Aware Search (

ov search

)

上下文感知搜索（

ov search

）

Primary search method with session context awareness:

bash

undefined

具备会话上下文感知的主要搜索方法：

bash

undefined

Basic search across all context

跨所有上下文进行基础搜索

ov search "how to handle API rate limits"

Search within specific URI scope

在特定URI范围内搜索

ov search "authentication flow" --uri "viking://resources/my-project"

Limit results and set threshold

限制结果数量并设置阈值

ov search "error handling" --limit 5 --threshold 0.7

undefined

ov search "error handling" --limit 5 --threshold 0.7

undefined

Content Pattern Search (

ov grep

)

内容模式搜索（

ov grep

）

Literal pattern matching:

bash

undefined

字面模式匹配：

bash

undefined

Search for exact text pattern

搜索精确文本模式

ov grep "viking://resources" "TODO:"

Case-insensitive search

不区分大小写的搜索

ov grep "viking://resources" "API_KEY" --ignore-case

undefined

ov grep "viking://resources" "API_KEY" --ignore-case

undefined

File Glob Search (

ov glob

)

文件通配符搜索（

ov glob

）

File path pattern matching:

bash

undefined

文件路径模式匹配：

bash

undefined

Find all markdown files

查找所有markdown文件

ov glob "**/*.md"

Find Python files in specific directory

在特定目录中查找Python文件

ov glob --uri="viking://user/" "**/*.md"

undefined

ov glob --uri="viking://user/" "**/*.md"

undefined

Search Options

搜索选项

Result Control

结果控制

bash

undefined

bash

undefined

Limit number of results

限制结果数量

ov search "authentication" --limit 5

Set minimum relevance threshold (0.0-1.0)

设置最低相关性阈值（0.0-1.0）

ov search "deployment" --threshold 0.8

Combine limit and threshold

同时设置结果数量限制和阈值

ov search "monitoring" --limit 10 --threshold 0.7

undefined

ov search "monitoring" --limit 10 --threshold 0.7

undefined

Scope Control

范围控制

bash

undefined

bash

undefined

Search specific directory

在特定目录中搜索

ov search "API design" --uri "viking://resources/xxx"

Search within memories

在记忆中搜索

ov search "user habits" --uri "viking://user/memories"

undefined

ov search "user habits" --uri "viking://user/memories"

undefined

Session-Aware Search

会话感知搜索

bash

undefined

bash

undefined

Search with session context (uses conversation history for better retrieval)

结合会话上下文进行搜索（使用对话历史以获得更优检索结果）

ov search "previous decision" --session-id "session-abc123"

undefined

ov search "previous decision" --session-id "session-abc123"

undefined

Output

输出

Returns a ranked list of matching resources with relevance scores:

URI: viking://resources/docs/api.md
Score: 0.8523
Abstract: API endpoints for user authentication...

URI: viking://user/memories/preferences
Score: 0.7891
Abstract: User prefers dark mode and compact layout...

返回带有相关性得分的匹配资源排序列表：

URI: viking://resources/docs/api.md
Score: 0.8523
Abstract: API endpoints for user authentication...

URI: viking://user/memories/preferences
Score: 0.7891
Abstract: User prefers dark mode and compact layout...

Other Utilities

其他实用工具

List Contents (

ov ls

)

列出内容（

ov ls

）

Browse directory structure:

bash

undefined

浏览目录结构：

bash

undefined

List root directory

列出根目录

ov ls

List specific directory

列出特定目录

ov ls viking://resources/my-project

Simple path output (for scripts)

简单路径输出（适用于脚本）

ov ls viking://resources --simple

Recursive listing

递归列出内容

ov ls viking://resources --recursive

Show hidden files

显示隐藏文件

ov ls viking://resources --all

Control output limits

控制输出限制

ov ls viking://resources --node-limit 50 --abs-limit 128

undefined

ov ls viking://resources --node-limit 50 --abs-limit 128

undefined

Tree View (

ov tree

)

树形视图（

ov tree

）

Visualize directory hierarchy:

bash

undefined

可视化目录层级：

bash

undefined

Show tree structure

显示树形结构

ov tree viking://resources

Control depth and limits

控制深度和数量限制

ov tree viking://resources --node-limit 100 --abs-limit 128

Show all files including hidden

显示所有文件（包括隐藏文件）

ov tree viking://resources --all

undefined

ov tree viking://resources --all

undefined

Read File Content (

ov read

)

读取文件内容（

ov read

）

Retrieve full content (L2 layer):

bash

undefined

检索完整内容（L2层）：

bash

undefined

Read full content

读取完整内容

ov read viking://resources/docs/api.md

Read abstract (L0 - quick summary)

读取摘要（L0 - 快速概览）

ov abstract viking://resources/docs/api.md

Read overview (L1 - key points)

读取概述（L1 - 关键点）

ov overview viking://resources/docs/api.md

undefined

ov overview viking://resources/docs/api.md

undefined

Agent Best Practices

Agent最佳实践

Choosing Search Methods

选择搜索方法

ov search
— Default choice. Context-aware, combines semantic + directory recursive retrieval
ov grep
— Exact text pattern matching (like
```
grep
```
command)
ov glob
— File path pattern matching (like shell glob)

ov search
— 默认选择。具备上下文感知能力，结合语义检索与目录递归检索
ov grep
— 精确文本模式匹配（类似
```
grep
```
命令）
ov glob
— 文件路径模式匹配（类似shell通配符）

Query Formulation

查询表述

Write specific, contextual queries:

bash

undefined

编写具体的、带有上下文的查询：

bash

undefined

Too vague

过于模糊

ov search "API"

Better

更优

ov search "REST API authentication with JWT tokens"

Even better with scope

结合范围限制更佳

ov search "JWT token refresh flow" --uri "viking://resources/backend"

undefined

ov search "JWT token refresh flow" --uri "viking://resources/backend"

undefined

Combining with Other Commands

与其他命令结合使用

Use search results to guide further actions:

bash

ov ls viking://resources/

利用搜索结果指导后续操作：

bash

ov ls viking://resources/

Search for relevant files

搜索相关文件

ov search "authentication" --uri "viking://resources/xxx"

Then read specific content

然后读取特定内容

ov read viking://resources/backend/auth.md

Or get overview for context

或获取概述以了解上下文

ov overview viking://resources/backend

undefined

ov overview viking://resources/backend

undefined

Prerequisites

前提条件

CLI configured:
```
~/.openviking/ovcli.conf
```
Resources or memories previously added to OpenViking

CLI已配置：
```
~/.openviking/ovcli.conf
```
已向OpenViking添加资源或记忆

searching-context

Original

Translation

OpenViking (OV) context searching

OpenViking（OV）上下文搜索

Table of Content

目录

When to Use

使用场景

Search Modes

搜索模式

Context-Aware Search (ov search)

上下文感知搜索（ov search）

Basic search across all context

跨所有上下文进行基础搜索

Search within specific URI scope

在特定URI范围内搜索

Limit results and set threshold

限制结果数量并设置阈值

Content Pattern Search (ov grep)

内容模式搜索（ov grep）

Search for exact text pattern

搜索精确文本模式

Case-insensitive search

不区分大小写的搜索

File Glob Search (ov glob)

文件通配符搜索（ov glob）

Find all markdown files

查找所有markdown文件

Find Python files in specific directory

在特定目录中查找Python文件

Search Options

搜索选项

Result Control

结果控制

Limit number of results

限制结果数量

Set minimum relevance threshold (0.0-1.0)

设置最低相关性阈值（0.0-1.0）

Combine limit and threshold

同时设置结果数量限制和阈值

Scope Control

范围控制

Search specific directory

在特定目录中搜索

Search within memories

在记忆中搜索

Session-Aware Search

会话感知搜索

Search with session context (uses conversation history for better retrieval)

结合会话上下文进行搜索（使用对话历史以获得更优检索结果）

Output

输出

Other Utilities

其他实用工具

List Contents (ov ls)

列出内容（ov ls）

List root directory

列出根目录

List specific directory

列出特定目录

Simple path output (for scripts)

简单路径输出（适用于脚本）

Recursive listing

递归列出内容

Show hidden files

显示隐藏文件

Control output limits

控制输出限制

Tree View (ov tree)

树形视图（ov tree）

Show tree structure

显示树形结构

Control depth and limits

控制深度和数量限制

Show all files including hidden

显示所有文件（包括隐藏文件）

Read File Content (ov read)

读取文件内容（ov read）

Read full content

Context-Aware Search (
`ov search`
)

上下文感知搜索（
`ov search`
）

Content Pattern Search (
`ov grep`
)

内容模式搜索（
`ov grep`
）

File Glob Search (
`ov glob`
)

文件通配符搜索（
`ov glob`
）

List Contents (
`ov ls`
)

列出内容（
`ov ls`
）

Tree View (
`ov tree`
)

树形视图（
`ov tree`
）

Read File Content (
`ov read`
)

读取文件内容（
`ov read`
）