SuperAPI AI 工具集

cognee-search

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:搜索 Cognee 的会话记忆与永久知识图谱,按需限定数据类别或搜索范围。会话记忆会在每次用户提示时通过 UserPromptSubmit 钩子自动搜索,无需手动调用;本技能用于显式发起知识图谱或指定类别的检索。

主要能力:知识按 node_set 分为三类——user(user_context:用户偏好、纠正、个人事实)、project(project_docs:仓库文档、代码上下文、架构决策)、agent(agent_actions:工具调用日志、推理轨迹、生成物)。搜索结果带 _source 字段,标识来自 session(会话缓存)、graph(永久知识图谱)或 code(已索引仓库的确定性代码图)。

使用方式:默认走运行中的 Cognee 服务器(POST /api/v1/recall),通过包装脚本执行:${CLAUDE_PLUGIN_ROOT}/scripts/cognee-search.sh "$ARGUMENTS"。仅搜永久图谱加 --graph,仅搜当前会话加 --session,确定性代码图加 --code。按类别过滤时包装脚本不暴露该参数,需直接向服务器传 node_name。建议一次宽泛检索即可,避免多次定向检索触发额外权限提示。结构性问题(如谁调用了某符号)应使用 --code 与 cognee-code 技能,语义概念问题才用本技能。

限制与注意事项:服务器为唯一事实来源,cognee-cli 仅作服务器不可达时的最后手段,且需要本地 cognee 源码检出;CLI 输出为空不等于内容不存在。本地模式下 $COGNEE_API_KEY 不会导出到 shell,需通过 ${CLAUDE_PLUGIN_ROOT}/scripts/cognee-forget.sh env 在同一 shell 调用中解析凭据,否则会出现 401。搜索限定在当前活动数据集,若返回权威空结果可列出其他可读数据集(python3 ${CLAUDE_PLUGIN_ROOT}/scripts/list-datasets.py --others)并询问用户后按 UUID 一次性检索:cognee-search.sh "$ARGUMENTS" 10 --graph --dataset-id <id>,切换数据集请使用 /cognee-memory:cognee-switch-datasets。