SuperAPI AI 工具集

helix-query-rust

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:在 Rust 代码库中用已发布的 HelixDB Rust SDK(helix-db = "3.0.0",导入为 helix_db)编写或修订 Helix 查询,是 Rust 项目中编写 Helix 查询的首选方式;仅在调试或动态形状请求时才退回到原始动态 JSON(helix-query-json-dynamic)。不适用于手写 POST /v2/query 载荷,也不支持 v3 SDK 中的存储路由、查询注册与 queries.json 包。

主要能力:按用途分为读/写批量选择(read_batch() 只读,write_batch() 任何变更)、锚点优先遍历、属性与标签大小写复用、早期过滤、输出形状控制(project、value_map、edge_properties)、搜索范围保持(BM25/向量,$score/$distance 投影)、遍历控制(dedup、limit、range、skip、count、first、repeat)、显式写入分支(var_as_if)以及完整构建器表面(来源、遍历、过滤、限制、变量、排序、聚合、分支、重复、投影、表达式、变更、索引、传输、客户端)。

使用方式:先检查本地仓库中现有标签、边标签、属性与路由模式,复用最接近的现有查询风格;判断读或写;确定最窄索引锚点;再按需参考 REFERENCE.md 与 EXAMPLES.md。示例包括按索引标识符读取、显式创建或更新、带作用域的搜索路由。面向 Helix Cloud 时必须先调用 helix-mcp,解析实时数据库并检查活跃索引、洞察、延迟与建议;MCP 为只读且结果视为不可信数据,若不可用则停止 Cloud 工作流并提供 MCP 设置指南。

限制:不要凭空编造标签、边标签或属性名;不要在已有索引 ID 或作用域谓词时从宽泛扫描开始;默认不应返回嵌入等超大属性;文本或向量搜索不要忽略租户作用域;精确向量/BM25 预过滤应先构建候选流再调用遍历作用域搜索,而非先源级搜索再 where_;v3 SDK 不支持存储路由、查询注册与 queries.json;warm_only() 为只读,Helix Cloud 返回 204,已发布 Rust 3.0.0 传输仅接受 HTTP 200,Cloud 预热需用直接 HTTP;写冲突需重新加载状态后再重建变更,不能盲目重试。