命令说明

进行上下文感知检索，可选择限定到某个会话，支持文本和图片查询。

语法

ov search [QUERY] [OPTIONS]

参数与选项

参数	默认值	说明
QUERY	不指定	查询文本，与 --image 至少提供一个。
--image IMAGE	不指定	本地图片路径、URL、viking:// 图片 URI 或 data:image/...；本地文件会编码后发送。
-u, --uri URI	当前身份默认范围	单个检索目录，不支持目录数组。
--session-id ID	不指定	已有会话 ID，服务端按会话内容进行查询规划。
-n, --node-limit N	10	每轮检索的数量上限；别名 --limit。多轮合并后的结果数量可能大于 N。
-t, --threshold SCORE	不指定	最低相关性分数。
--context-type TYPES	不指定	memory、resource、skill，多个值以逗号分隔。
--tags TAGS	不指定	多个 key=value 标签，逗号分隔，按 AND 筛选。
--after TIME	不指定	updated_at 时间下界，包含边界。
--before TIME	不指定	updated_at 时间上界，包含边界。
-L, --level LEVELS	不指定	检索层级，多个值以逗号分隔。
--read-content	false	为命中项读取正文；失败的条目可不带 content。

时间、标签和图片规则与 find 相同。search 不支持纯过滤调用。当前 CLI 没有 --mode context、--max-tokens、--quotas、--purpose、--detail 或 --dedup-turns 等参数；需要上下文组装时调用 HTTP API。

使用示例

ov search "这个项目上次遇到同类故障时如何处理？" \
  --session-id session-example \
  --uri 'viking://resources/projects/atlas' \
  -n 5 --read-content -o json --compact=false

只搜索相关记忆：

ov search "接口联调时有哪些注意事项？" \
  --session-id session-example --context-type memory --after 30d -n 5

下一步

可以直接查看会话上下文：

ov session get-session-context <id>

返回结果与排障

结果分为 memories、resources、skills，total 为实际返回条目数。生成查询计划时，query_plan 中包含 reasoning 和 queries；每个查询包含 query、context_type、intent、priority。不存在 expanded_queries 这一标准字段。
多轮结果当前不保证按 URI 全局去重或重新排序。应用如需生成统一清单，应按 URI 合并；不要把 CLI 卡片的显示顺序当成所有轮次合并后的全局相关性排名。

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

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

命令说明 #

语法 #

参数与选项 #

使用示例 #

下一步 #

返回结果与排障 #

命令说明

语法

参数与选项

使用示例

下一步

返回结果与排障