命令说明

语义检索相关的 OpenViking 上下文，支持文本和图片查询。

语法

ov find [QUERY] [OPTIONS]

参数和常用选项

参数	默认值	说明
QUERY	不指定	查询文本，与 --image 至少提供一个。
--image IMAGE	不指定	HTTP(S) URL、viking:// 图片 URI 或 data:image/...。
-u, --uri URI	当前身份默认范围	单个检索目录。
-n, --node-limit N	10	最终返回结果数量上限；别名 --limit。建议使用正整数。
-t, --threshold SCORE	不指定	最低相关性分数，传给 HTTP score_threshold；不是概率。
--context-type TYPES	不指定	memory、resource、skill；多个值以逗号分隔，按并集筛选。
--tags TAGS	不指定	key=value 标签，多个以逗号分隔，按 AND 筛选。
--after TIME	不指定	updated_at 时间下界，对应 HTTP since，包含边界。
--before TIME	不指定	updated_at 时间上界，对应 HTTP until，包含边界。
-L, --level LEVELS	不指定	0 摘要、1 概览、2 详细内容；多个值以逗号分隔。控制候选层级，不等同于读取正文。
--read-content	false	读取命中内容，在 JSON 结果中提供 content。单条读取失败可能没有该字段。

时间支持 ISO 8601、YYYY-MM-DD，以及 30m、2h、7d、1w 等相对格式（单位 s/m/h/d/w）。仅日期的上下界分别对应 UTC 当日开始和结束；未标时区的时间也按 UTC 解释。建议明确使用 +08:00 或 Z。CLI 暂无 time_field 选项；按 created_at 查询请使用 HTTP API。
标签统一转为小写，同 key 保留最后一个值；不会自动匹配未继承该标签的子目录文件。find/search 对非法标签报错。

使用示例

检索项目资源并查看正文：

ov find "Atlas 发布与回滚流程" \
  --uri 'viking://resources/projects/atlas' \
  --context-type resource -n 5 --level 2 --read-content \
  -o json --compact=false

筛选近期记忆：

ov find "项目交付时间" --context-type memory \
  --tags 'project=atlas,status=active' --after 7d -n 10

通过本地图片查询，执行时会发送图片数据：

ov find --image ./query.png --uri 'viking://resources/design' -n 5

下一步

找到结果后，可以：

# 打开精确结果
ov read <uri>

# 浏览结果附近区域
ov tree <uri>

返回结果与排障

JSON 结果按 memories、resources、skills 分组；total 是本次返回的条目数。命中项包含 uri、context_type、level、score、abstract、tags；--read-content 成功时额外包含 content。当前不保证返回旧示例中的 is_leaf、match_reason。
无结果时依次检查目录范围、类型与标签、时间边界、索引状态和阈值。CLI 不提供 filter 表达式、target_uri 数组、time_field、include_provenance 等 HTTP 参数的同名选项；不要把 JSON 字段名直接拼成 CLI 参数。〔链接占位：find API〕

最近更新时间：2026.09.22 22:14:41

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

命令说明 #

语法 #

参数和常用选项 #

使用示例 #

下一步 #

返回结果与排障 #

命令说明

语法

参数和常用选项

使用示例

下一步

返回结果与排障