SuperAPI AI 工具集

index

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:/modules/index 是 Arc 的检索索引,对按路径寻址的对象提供结构化发现能力(FTS、锚点、可选语义/向量),使“看起来像 AFS 上的文件”的内容无需全树扫描即可查询。注意名称区分:/modules/index 是检索提供者(index/query/reindex),而 AFS Index(manifest-of-manifests)是联邦路由与分布式命名,属架构文档,不应混入查询配方。若任务是“搜索我的对象”,应使用 /modules/index。

主要能力:提供 index、query、reindex、get、cleanup、register-domain、discover 等动作;query 支持 fts 模式,语义/向量模式需在实时环境中配置嵌入后可用。

使用方式:需守护进程运行。先查看:arc afs explain /modules/index --instance <name>、arc afs ls /modules/index --instance <name>、arc afs ls /modules/index/.actions --instance <name>、arc afs read /.knowledge/index --instance <name>(当该知识条目存在时)。在自造 --args 前务必先 explain 动作路径。典型流程:写入对象后索引再查询,例如 arc afs write /user/notes/hello.md "arc space index golden path" --instance <name>;显式索引 arc afs exec /modules/index/.actions/index --instance <name> --args '{"entryPath":"/user/notes/hello.md","summary":"arc space index golden path"}';FTS 查询 arc afs exec /modules/index/.actions/query --instance <name> --args '{"mode":"fts","text":"golden path","opts":{"limit":10}}'。

适用场景:已知路径时用 arc afs ls/read/stat;需要搜索、分面或召回时用 query;需要持久存储且不想用数据库加 blob 时用 arc skill show space;产品表面为“智能体记忆”时优先用记忆工具,显式搜索再用 /modules/index。

限制:本技能为离线手册,守护进程启动后优先使用实时 explain;语义/向量查询依赖实时世界中的嵌入配置;各动作参数需通过 explain 获取,资料未提供完整参数说明。安装:arc skill install index。