SuperAPI AI 工具集

understand-dashboard

编程与开发

查看项目

更新于 11-10 16:20

技能介绍

该技能用于启动 Understand Anything 仪表盘,以可视化当前项目的知识图谱。

用途:在浏览器中查看代码库的知识图谱。启动前要求项目中已存在知识图谱文件,若缺失需先运行 /understand 分析项目。

主要能力:

  • 确定项目目录:若参数包含路径则使用该路径,否则使用当前工作目录。
  • 选择数据目录:存在 .understand-anything/ 时优先使用,否则使用 .ua/。
  • 校验 $UA_DIR/knowledge-graph.json 是否存在,不存在则提示先运行 /understand。
  • 按顺序查找仪表盘代码位置,包括 Claude Code 运行时根目录、通用符号链接、自身相对路径回退、Copilot 个人技能回退以及常见克隆安装根目录。
  • 快速路径:从 GitHub Release 下载与已安装插件版本绑定的自包含查看器包,通过 npx 运行,无需安装依赖或构建。
  • 回退路径:安装依赖(pnpm install)、构建核心包(pnpm --filter @understand-anything/core build),再以 GRAPH_DIR 指向项目目录启动 Vite 开发服务器。

使用方式:调用 /understand-dashboard,可传入项目路径参数。启动后在后台运行,服务器输出形如 🔑 Dashboard URL: http://127.0.0.1:<PORT>?token=<TOKEN> 的地址,需将包含 ?token= 参数的完整 URL 提供给用户,否则会被访问令牌门禁拦截。仪表盘会自动在默认浏览器打开;若 5173 端口被占用,会自动选择下一个可用端口。

适用场景:需要以图形化方式理解、浏览项目代码知识图谱的开发者。

限制:依赖已生成的知识图谱文件;快速路径在无对应版本发布资产或无网络时回退;回退路径需要 pnpm 环境与依赖安装构建;访问必须携带 token;停止方式为在终端按 Ctrl+C。