用途:启动 Understand Anything 仪表盘,可视化当前项目的知识图谱。
主要能力:确定项目目录(参数含路径则用之,否则用当前工作目录);检查项目目录下是否存在 .understand-anything/knowledge-graph.json,若不存在则提示先运行 /understand 分析项目;定位仪表盘代码(位于插件根目录的 packages/dashboard/),按优先级依次查找多个候选路径;安装依赖并构建核心包;启动指向项目知识图谱的 Vite 开发服务器。
使用方式:通过 /understand-dashboard 调用。启动命令为 cd <dashboard-dir> && GRAPH_DIR=<project-dir> npx vite --host 127.0.0.1,需在后台运行。依赖安装使用 pnpm install --frozen-lockfile 或 pnpm install,核心包构建使用 pnpm --filter @understand-anything/core build。服务器会输出带 token 的访问地址,形如 http://127.0.0.1:<PORT>?token=<TOKEN>,必须完整包含 ?token= 参数,否则会被访问令牌拦截。
适用场景:需要以图形化方式浏览代码库知识图谱、理解项目结构时。
限制:需先有知识图谱文件;需能找到插件根目录,否则报错退出;仪表盘默认通过 --open 自动打开浏览器;若 5173 端口被占用,Vite 会选择下一个可用端口;GRAPH_DIR 环境变量用于指定知识图谱位置。