🏠 Главная › user guide › research gitnexus explorer

{/ Эта страница автоматически создается на основе файла SKILL.md навыка с помощью сайта site/scripts/generate-skill-docs.py. Редактируйте исходный код SKILL.md, а не эту страницу. /}

Гитнексус Эксплорер

Индексируйте базу кода с помощью GitNexus и предоставляйте интерактивный граф знаний через веб-интерфейс + туннель Cloudflare.

Метаданные навыков
Источник Необязательно — установите с помощью hermesskills installofficial/research/gitnexus-explorer
Путь optional-skills/research/gitnexus-explorer
Версия 1.0.0
Автор Гермес Агент + Текниум
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги gitnexus, код-разведка, график знаний, визуализация
Сопутствующие навыки native-mcp, codebase-inspection

Ссылка: полная версия SKILL.md:::информация

Ниже приведено полное определение навыка, которое Гермес загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навык активен.

GitNexus Explorer

Индексируйте любую базу кода в граф знаний и предоставляйте интерактивный веб-интерфейс для изучения. символы, цепочки вызовов, кластеры и потоки выполнения. Туннелируется через Cloudflare для удаленного доступа.

Когда использовать

Предварительные условия

Предупреждение о размере

Веб-интерфейс отображает все узлы в браузере. Репозитории до ~5000 файлов работают хорошо. Большой репозитории (более 30 тыс. узлов) будут работать медленно или вызывать сбой вкладки браузера. Инструменты CLI/MCP работают в любом масштабе — такой предел есть только у веб-визуализации.

Шаги

1. Клонирование и сборка GitNexus (однократная установка)

GITNEXUS_DIR="${GITNEXUS_DIR:-$HOME/.local/share/gitnexus}"

if [! -d "$GITNEXUS_DIR/gitnexus-web/dist" ]; then
  git clone https://github.com/abhigyanpatwari/GitNexus.git "$GITNEXUS_DIR"
  cd "$GITNEXUS_DIR/gitnexus-shared" && npm install && npm run build
  cd "$GITNEXUS_DIR/gitnexus-web" && npm install
fi

2. Исправление веб-интерфейса для удаленного доступа

По умолчанию веб-интерфейс использует локальный хост: 4747 для вызовов API. Исправьте его, чтобы использовать одно и то же происхождение. поэтому он работает через туннель/прокси:

Файл: $GITNEXUS_DIR/gitnexus-web/src/config/ui-constants.ts Изменение:

export const DEFAULT_BACKEND_URL = 'http://localhost:4747';

К:

export const DEFAULT_BACKEND_URL = typeof window!== 'undefined' && window.location.hostname!== 'localhost'? window.location.origin: 'http://localhost:4747';

Файл: $GITNEXUS_DIR/gitnexus-web/vite.config.ts Добавьте allowedHosts: true внутри блока server: { } (необходимо только при запуске dev режим вместо производственной сборки):

server: {
    allowedHosts: true,
    //... existing config
},

Затем создайте производственный пакет:

cd "$GITNEXUS_DIR/gitnexus-web" && npx vite build

3. Индексируйте целевой репозиторий

cd /path/to/target-repo
npx gitnexus analyze --skip-agents-md
rm -rf.claude/    # remove Claude Code-specific artifacts

Добавьте --embeddings для семантического поиска (медленнее — минуты вместо секунд).

Индекс находится в .gitnexus/ внутри репозитория (автоматически игнорируется).

4. Создайте прокси-скрипт

Запишите это в файл (например, $GITNEXUS_DIR/proxy.mjs). Он обслуживает производство веб-интерфейс и прокси /api/* для серверной части GitNexus — тот же источник, никаких проблем с CORS, ни sudo, ни nginx.

import http from 'node:http';
import fs from 'node:fs';
import path from 'node:path';

const API_PORT = parseInt(process.env.API_PORT || '4747');
const DIST_DIR = process.argv[2] || './dist';
const PORT = parseInt(process.argv[3] || '8888');

const MIME = {
  '.html': 'text/html', '.js': 'application/javascript', '.css': 'text/css',
  '.json': 'application/json', '.png': 'image/png', '.svg': 'image/svg+xml',
  '.ico': 'image/x-icon', '.woff2': 'font/woff2', '.woff': 'font/woff',
  '.wasm': 'application/wasm',
};

function proxyToApi(req, res) {
  const opts = {
    hostname: '127.0.0.1', port: API_PORT,
    path: req.url, method: req.method, headers: req.headers,
  };
  const proxy = http.request(opts, (upstream) => {
    res.writeHead(upstream.statusCode, upstream.headers);
    upstream.pipe(res, { end: true });
  });
  proxy.on('error', () => { res.writeHead(502); res.end('Backend unavailable'); });
  req.pipe(proxy, { end: true });
}

function serveStatic(req, res) {
  let filePath = path.join(DIST_DIR, req.url === '/'? 'index.html': req.url.split('?')[0]);
  if (!fs.existsSync(filePath)) filePath = path.join(DIST_DIR, 'index.html');
  const ext = path.extname(filePath);
  const mime = MIME[ext] || 'application/octet-stream';
  try {
    const data = fs.readFileSync(filePath);
    res.writeHead(200, { 'Content-Type': mime, 'Cache-Control': 'public, max-age=3600' });
    res.end(data);
  } catch { res.writeHead(404); res.end('Not found'); }
}

http.createServer((req, res) => {
  if (req.url.startsWith('/api')) proxyToApi(req, res);
  else serveStatic(req, res);
}).listen(PORT, () => console.log(`GitNexus proxy on http://localhost:${PORT}`));

5. Start the Services

# Terminal 1: GitNexus backend API
npx gitnexus serve &

# Terminal 2: Proxy (web UI + API on one port)
node "$GITNEXUS_DIR/proxy.mjs" "$GITNEXUS_DIR/gitnexus-web/dist" 8888 &

Проверьте: curl -s http://localhost:8888/api/repos должен возвращать индексированные репозитории.

6. Туннель с Cloudflare (опционально — для удаленного доступа)

# Install cloudflared if needed (no sudo)
if! command -v cloudflared &>/dev/null; then
  mkdir -p ~/.local/bin
  curl -sL https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 \
    -o ~/.local/bin/cloudflared
  chmod +x ~/.local/bin/cloudflared
  export PATH="$HOME/.local/bin:$PATH"
fi

# Start tunnel (--config /dev/null avoids conflicts with existing named tunnels)
cloudflared tunnel --config /dev/null --url http://localhost:8888 --no-autoupdate --protocol http2

URL-адрес туннеля (например, https://random-words.trycloudflare.com) выводится в stderr. Поделитесь — любой, у кого есть ссылка, сможет изучить график.

7. Очистка

# Stop services
pkill -f "gitnexus serve"
pkill -f "proxy.mjs"
pkill -f cloudflared

# Remove index from the target repo
cd /path/to/target-repo
npx gitnexus clean
rm -rf.claude/

Подводные камни