/understand-dashboard

Inicie o painel Understand Anything para visualizar o grafo de conhecimento do projeto atual.

Instruções

1. Determine o diretório do projeto e o diretório de dados:

   • Se $ARGUMENTS contiver um caminho, use-o como diretório do projeto.
   • Caso contrário, use o diretório de trabalho atual.
   • Prefira o diretório de dados legado .understand-anything/ quando ele existir, caso contrário, use .ua/.

   Use a ferramenta Bash para resolver:

   PROJECT_ARG="$ARGUMENTS"
   if [ -n "$PROJECT_ARG" ]; then
     PROJECT_DIR=$(cd "$PROJECT_ARG" 2>/dev/null && pwd -P)
   else
     PROJECT_DIR=$(pwd -P)
   fi
   
   if [ -z "$PROJECT_DIR" ] || [ ! -d "$PROJECT_DIR" ]; then
     echo "Error: Project directory not found: ${PROJECT_ARG:-$PWD}"
     exit 1
   fi
   
   if [ -d "$PROJECT_DIR/.understand-anything" ]; then
     UA_DIR="$PROJECT_DIR/.understand-anything"
   else
     UA_DIR="$PROJECT_DIR/.ua"
   fi
   

2. Verifique se $UA_DIR/knowledge-graph.json existe no diretório do projeto. Se não existir, informe o usuário:

   No knowledge graph found. Run /understand first to analyze this project.
   

   Use a ferramenta Bash para verificar:

   if [ ! -f "$UA_DIR/knowledge-graph.json" ]; then
     echo "No knowledge graph found. Run /understand first to analyze this project."
     exit 1
   fi
   

3. Encontre o código do painel. O painel está em packages/dashboard/ em relação à raiz deste plugin. Verifique esses caminhos em ordem e use o primeiro que existir:

   • ${CLAUDE_PLUGIN_ROOT}/packages/dashboard/ (raiz de tempo de execução do Claude Code, maior prioridade)
   • ~/.understand-anything-plugin/packages/dashboard/ (link simbólico universal, todas as instalações)
   • Dois níveis acima do caminho real de ~/.agents/skills/understand-dashboard (fallback auto-relativo)
   • Dois níveis acima do caminho real de ~/.copilot/skills/understand-dashboard (fallback de habilidades pessoais do Copilot)
   • Raízes comuns de instalação baseadas em clone:
     • ~/.codex/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/.opencode/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/.pi/understand-anything/understand-anything-plugin/packages/dashboard/
     • ~/understand-anything/understand-anything-plugin/packages/dashboard/

   Use a ferramenta Bash para resolver:

   SKILL_REAL=$(realpath ~/.agents/skills/understand-dashboard 2>/dev/null || readlink -f ~/.agents/skills/understand-dashboard 2>/dev/null || echo "")
   SELF_RELATIVE=$([ -n "$SKILL_REAL" ] && cd "$SKILL_REAL/../.." 2>/dev/null && pwd || echo "")
   COPILOT_SKILL_REAL=$(realpath ~/.copilot/skills/understand-dashboard 2>/dev/null || readlink -f ~/.copilot/skills/understand-dashboard 2>/dev/null || echo "")
   COPILOT_SELF_RELATIVE=$([ -n "$COPILOT_SKILL_REAL" ] && cd "$COPILOT_SKILL_REAL/../.." 2>/dev/null && pwd || echo "")
   
   PLUGIN_ROOT=""
   for candidate in \
     "${CLAUDE_PLUGIN_ROOT}" \
     "$HOME/.understand-anything-plugin" \
     "$SELF_RELATIVE" \
     "$COPILOT_SELF_RELATIVE" \
     "$HOME/.codex/understand-anything/understand-anything-plugin" \
     "$HOME/.opencode/understand-anything/understand-anything-plugin" \
     "$HOME/.pi/understand-anything/understand-anything-plugin" \
     "$HOME/understand-anything/understand-anything-plugin"; do
     if [ -n "$candidate" ] && [ -d "$candidate/packages/dashboard" ]; then
       PLUGIN_ROOT="$candidate"; break
     fi
   done
   
   if [ -z "$PLUGIN_ROOT" ]; then
     echo "Error: Cannot find the understand-anything plugin root."
     echo "Checked:"
     echo "  - ${CLAUDE_PLUGIN_ROOT:-<unset CLAUDE_PLUGIN_ROOT>}"
     echo "  - $HOME/.understand-anything-plugin"
     echo "  - ${SELF_RELATIVE:-<unresolved path derived from ~/.agents/skills/understand-dashboard>}"
     echo "  - ${COPILOT_SELF_RELATIVE:-<unresolved path derived from ~/.copilot/skills/understand-dashboard>}"
     echo "  - $HOME/.codex/understand-anything/understand-anything-plugin"
     echo "  - $HOME/.opencode/understand-anything/understand-anything-plugin"
     echo "  - $HOME/.pi/understand-anything/understand-anything-plugin"
     echo "  - $HOME/understand-anything/understand-anything-plugin"
     echo "Make sure you followed the installation instructions for your platform."
     exit 1
   fi
   
   DASHBOARD_DIR="$PLUGIN_ROOT/packages/dashboard"
   

4. Caminho rápido — tente o visualizador pré-compilado primeiro (sem instalação, sem compilação). Cada versão envia um tarball de visualizador autônomo; execute-o fixado na versão do plugin instalada:

…