SuperAPI AI 工具集

gsd-graphify

通用与其它

查看项目

更新于 10-16 07:25

技能介绍

用途:gsd-graphify 是 open-gsd/gsd-core 提供的命令行技能,用于构建、查询和检查位于 .planning/graphs/ 的项目知识图谱。

主要能力:支持四种模式——build 构建或重建知识图谱;query <term> 在图中检索关键词;status 显示图谱的新鲜度与统计(节点、边、超边数量及 STALE/FRESH 标识,并展示 Source commit 与落后 HEAD 的提交数);diff 显示自上次构建以来的变更(节点与边的增删改计数)。查询结果按类型分组,含边关系与 EXTRACTED/INFERRED/AMBIGUOUS 置信分层。

使用方式:需先在 .planning/config.json 中设置 graphify.enabled 为 true,可通过 node <runtime-home>/gsd-core/bin/gsd-tools.cjs config-set graphify.enabled true 开启,再执行 /gsd-graphify build 创建初始图谱。graphify 子命令仅支持 CJS,不注册在 gsd-tools query 上,需通过 gsd_run 启动器或直接调用 node <runtime-home>/gsd-core/bin/gsd-tools.cjs graphify … 运行;若找不到工具可执行 npx -y @opengsd/gsd-core@latest --claude --local。build 为内联执行(出于图谱构建阶段拆分原因,spawn_agent 为历史信号),建议用 600000 毫秒超时以覆盖默认 300 秒构建上限。

适用场景:在具备 git 仓库的项目中维护和检索项目知识图谱,辅助识别节点关系与图谱新鲜度。

限制:需显式启用且未启用时直接停止;查询与构建返回 JSON,遇错误或禁用则终止;commit_stale 为 null 时新鲜度未知;无基线快照时 diff 会提示先构建两次;当 built_at_commit 为空时省略来源提交行。