SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场searching-context

searching-context

通用与其它

查看项目

更新于 10-16 01:58

技能介绍

用途

searching-context 是 OpenViking（简称 ov）的上下文检索技能，用于在 OpenViking 中搜索记忆与资源上下文。当出现关键词 "ovs"，或被明确要求搜索文件等场景时触发。它帮助用户或智能体在已导入的资源、已保存的记忆中定位特定信息，检索关于此前添加的主题、API 或模式的上下文，跨项目文档、代码与学习记录进行搜索，或在智能体需要引用此前存储的知识时使用。

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

主要能力

检索模式

上下文感知搜索（ov search）：主要检索方式，具备会话上下文感知能力，结合语义理解与目录递归检索。示例：

# 跨所有上下文的基础搜索
ov search "how to handle API rate limits"

# 在指定 URI 范围内搜索
ov search "authentication flow" --uri "viking://resources/my-project"

# 限制结果数量并设置阈值
ov search "error handling" --limit 5 --threshold 0.7

内容模式搜索（ov grep）：字面模式匹配。示例：

# 搜索精确文本模式
ov grep "viking://resources" "TODO:"

# 忽略大小写搜索
ov grep "viking://resources" "API_KEY" --ignore-case

文件 Glob 搜索（ov glob）：文件路径模式匹配。示例：

# 查找所有 markdown 文件
ov glob "**/*.md"

# 在指定目录查找 Python 文件
ov glob --uri="viking://user/" "**/*.md"

搜索选项

结果控制：

# 限制结果数量
ov search "authentication" --limit 5

# 设置最低相关度阈值（0.0-1.0）
ov search "deployment" --threshold 0.8

# 组合使用
ov search "monitoring" --limit 10 --threshold 0.7

范围控制：

# 搜索指定目录
ov search "API design" --uri "viking://resources/xxx"

# 在记忆中搜索
ov search "user habits" --uri "viking://user/memories"

会话感知搜索：

# 结合会话上下文（利用对话历史提升检索效果）
ov search "previous decision" --session-id "session-abc123"

输出

返回带相关度评分的排序匹配资源列表，例如：

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...

其他辅助命令

列出内容（ov ls）：浏览目录结构。

# 列出根目录
ov ls

# 列出指定目录
ov ls viking://resources/my-project

# 简单路径输出（用于脚本）
ov ls viking://resources --simple

# 递归列出
ov ls viking://resources --recursive

# 显示隐藏文件
ov ls viking://resources --all

# 控制输出限制
ov ls viking://resources --node-limit 50 --abs-limit 128

树状视图（ov tree）：可视化目录层级。

# 显示树结构
ov tree viking://resources

# 控制深度与限制
ov tree viking://resources --node-limit 100 --abs-limit 128

# 显示所有文件（含隐藏）
ov tree viking://resources --all

读取文件内容（ov read）：获取完整内容（L2 层）。

# 读取完整内容
ov read viking://resources/docs/api.md

# 读取摘要（L0 - 快速概要）
ov abstract viking://resources/docs/api.md

# 读取概览（L1 - 要点）
ov overview viking://resources/docs/api.md

使用方式（智能体最佳实践）

选择检索方法：

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

构造查询：编写具体、带上下文的查询。

# 过于模糊
ov search "API"

# 更好
ov search "REST API authentication with JWT tokens"

# 结合范围更好
ov search "JWT token refresh flow" --uri "viking://resources/backend"

与其他命令组合：用检索结果指导后续操作。

ov ls viking://resources/

# 搜索相关文件
ov search "authentication" --uri "viking://resources/xxx"

# 然后读取具体内容
ov read viking://resources/backend/auth.md

# 或获取概览作为上下文
ov overview viking://resources/backend

适用场景

  • 在已导入资源或已保存记忆中查找特定信息
  • 检索此前添加的主题、API 或模式的上下文
  • 跨项目文档、代码与学习记录进行搜索
  • 智能体需要引用此前存储的知识时

前提条件与限制

  • 需已配置 CLI：~/.openviking/ovcli.conf
  • 需已向 OpenViking 添加资源或记忆
  • CLI 命令可能已过时，遇到错误时使用 --help 获取最新用法
  • 资料未提供收费、价格、平台支持范围等信息