		
									# Grafon

						**Анализатор кода 1С (BSL и XML) на базе графа знаний**

								Версия 0.9.25 · Windows (64-бит)

 Grafon превращает папку с кодом в наглядный **граф знаний**: вы задаёте вопросы на обычном языке, а Grafon отвечает, опираясь на связи между процедурами,
   модулями и объектами — вместо того чтобы вручную искать по файлам.


	## Содержание

 1. [Что такое Grafon](#1-что-такое-grafon)
 2. [Установка](#2-установка)
 3. [Первый запуск и пробный период](#3-первый-запуск-и-пробный-период)
 4. [Режим 1 — через AI-ассистента (Claude Code, Cursor)](#4-режим-1--через-ai-ассистента-claude-code-cursor)
 5. [Режим 2 — напрямую из консоли](#5-режим-2--напрямую-из-консоли)
 6. [Командная лицензия (Team)](#6-командная-лицензия-team)
 7. [Если что-то не работает](#7-если-что-то-не-работает)
 8. [Частые вопросы](#8-частые-вопросы)

 ---

	## 1. Что такое Grafon

 Grafon — это программа, которая **читает ваш код и строит по нему карту связей** (граф знаний). На этой карте:

 - **Узлы** — это процедуры, функции, модули, классы, объекты и документы.
 - **Связи** — «кто кого вызывает», «кто кого использует», «откуда импортируется» и т. д.

 Получив такую карту, вы можете:

 - **Задавать вопросы** на обычном языке — *«как устроена авторизация?»*, *«что вызывает процедуру ЗаписатьДокумент?»* — и получать точный ответ со ссылками на конкретные файлы и строки.
 - **Проследить путь** между двумя элементами — *«как связаны модуль А и модуль Б?»*.
 - **Увидеть ключевые узлы** — самые «нагруженные» процедуры, через которые проходит почти всё.
 - **Открыть визуализацию** в браузере — интерактивную карту, где узлы можно раскрывать, фильтровать и искать.

 Код анализируется **локально, на вашем компьютере**, без отправки куда-либо и без оплаты за каждый запрос.

 > Grafon ориентирован на код **1С: BSL** (`.bsl`) и **XML** (`.xml`, `.epf`, `.erf`, конфигурации), но умеет работать и с другими языками.

 ---

	## 2. Установка

 Установка — это один файл **`grafon_setup.exe`**. Никакого Python, никаких зависимостей и прав администратора не требуется.

 1. **Скачайте** `grafon_setup.exe` (например, с сайта продукта или из папки `Output/`).
 2. **Запустите** его двойным щелчком.
 3. **Следуйте мастеру**:
   - Папка установки по умолчанию — `C:\Grafon` (можно изменить).
   - Ярлыки в меню «Пуск» — на ваше усмотрение.
   - Нажимайте **«Далее»** → **«Установить»** → **«Готово»**.
 4. **Готово.** Программа сама добавит себя в переменную `PATH`, поэтому команда `grafon` будет доступна в любом новом окне консоли.

	### Проверка установки

 Откройте **новое** окно PowerShell или «Командной строки» и введите:

 ```powershell
 grafon --version
 ```

 Если в ответ вы видите `grafon 0.9.25` — всё установлено правильно.

	### Удаление

 - Через **«Пуск» → Grafon → Удалить Grafon**, или
 - Через **«Параметры» → «Приложения» → Grafon → Удалить**.

 При удалении Grafon **сам убирает себя из `PATH`** и не трогает остальные ваши настройки.

 > 💡 Установку и удаление можно выполнять и «молча» (для ИТ-отделов):
 > ```powershell
 > # тихая установка
 > grafon_setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /DIR=C:\Grafon
 > # тихое удаление
 > "C:\Grafon\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
 > ```

 ---

	## 3. Первый запуск и пробный период

	### Пробный период — 10 дней, автоматически

 При первом запуске любой команды Grafon **автоматически включает пробный период на 10 дней**. Никакая регистрация вручную не нужна.
 Пробный период привязан к этому компьютеру (по аппаратному отпечатку устройства).

 Узнать, сколько дней осталось:

 ```powershell
 grafon license-status
 ```

 Пример вывода:

 ```text
 grafon статус лицензии: пробный период
 Осталось дней: 7
 Устройство: 6e21e9f1ad63213c
 Оформить/продлить: https://api.grafonbase.ru/pay?device=6e21e9f1ad63213c
 ```

	### Предупреждения и окончание

 - За **3 дня** до конца пробного периода Grafon начнёт показывать мягкое предупреждение со ссылкой на оплату.
 - Когда пробный период **закончился**, команды работы с данными (построение и анализ графа) **приостанавливаются**, а в браузере открывается страница оплаты: `https://api.grafonbase.ru/pay`.
 - **После оплаты доступ восстанавливается автоматически** при следующем запуске Grafon — ничего дополнительно вводить не нужно.

 > ℹ️ Команды `grafon --version`, `grafon --help` и `grafon license-status` работают **всегда**, даже с истёкшей лицензией.

 ---

	## 4. Режим 1 — через AI-ассистента (Claude Code, Cursor)

 Это **самый простой способ**: вы разговариваете с Grafon на обычном языке прямо в вашем редакторе кода, а он сам строит граф, ищет по нему и отвечает.

	### Шаг 1. Свяжите Grafon с вашим ассистентом

 Откройте консоль **в папке вашего проекта** 1С и выполните одну команду — в зависимости от редактора:

 | Редактор / ассистент | Команда (установка в текущий проект) |
 |---|---|
 | **Claude Code** | `grafon claude install --project` |
 | **Cursor** | `grafon cursor install` |
 | Codex | `grafon codex install` |
 | Gemini CLI | `grafon gemini install` |
 | OpenCode | `grafon opencode install` |
 | Универсальная (Claude Code + автоопределение Windows) | `grafon install --project` |

 > Флаг `--project` устанавливает навык Grafon **в текущую папку проекта** (его можно передать коллегам через git). Без `--project` навык ставится глобально для всех ваших проектов.
 >
 > Полный список поддерживаемых ассистентов (20+) — в `grafon --help` (раздел `install`).

	### Шаг 2. Просто говорите обычными словами

 После установки не нужно вспоминать команды. Откройте проект в Claude Code или Cursor и напишите **обычной фразой** — ассистент сам поймёт, что нужно построить или открыть граф, и сделает это:

 | Вы говорите… | Что произойдёт |
 |---|---|
 | «**просканируй эту папку**» / «разберись в коде» / «изучи структуру» | Grafon построит граф проекта и ответит на ваш вопрос |
 | «**покажи граф**» / «открой граф» / «визуализируй проект» | Откроется интерактивная карта в браузере |
 | «как работает процедура ЗаписатьДокумент?» | Grafon найдёт ответ по графу со ссылками на файлы |
 | «**работаем в команде над графом**» | Настроится автообновление графа при коммитах (см. раздел 6) |

 Либо можно явно вызвать команду-навык:

 ```
 /grafon .
 ```

	### Что получится после построения графа

 Grafon создаст папку **`grafon-out/`** с тремя файлами:

 | Файл | Что это |
 |---|---|
 | `graph.html` | Интерактивная карта графа — открывается в любом браузере, узлы кликабельны |
 | `GRAPH_REPORT.md` | Краткий текстовый отчёт: ключевые узлы, неожиданные связи, предлагаемые вопросы |
 | `graph.json` | Полный граф в формате JSON — по нему Grafon отвечает на вопросы без повторного чтения файлов |

 ---

	## 5. Режим 2 — напрямую из консоли

 Если вы не пользуетесь AI-ассистентом, всё можно делать прямо в PowerShell / «Командной строке».

	### Построить граф

 ```powershell
 # построить граф по коду текущей папки (локально, без API-ключа)
 grafon extract . --code-only --force

 # полный граф: код + документы/файлы (для документов нужен API-ключ LLM)
 grafon extract .

 # обновить только изменённые файлы (быстро, без LLM)
 grafon update .
 ```

 > `--code-only` строит граф **только по коду** (BSL/XML) — это работает полностью офлайн и не требует никаких ключей.
 Для анализа документов и изображений нужен один из API-ключей (см. раздел 8).

	### Задать вопросы по графу

 | Команда | Что делает |
 |---|---|
 | `grafon query "как устроена авторизация?"` | Отвечает на вопрос по графу, выдавая релевантный фрагмент |
 | `grafon path "МодульА" "МодульБ"` | Показывает кратчайший путь между двумя элементами |
 | `grafon explain "ЗаписатьДокумент"` | Подробно объясняет выбранный элемент и его соседей |
 | `grafon god-nodes` | Выводит ключевые «хабовые» узлы (самые связанные) |
 | `grafon affected "ОбщийМодульА"` | Показывает, на что повлияет изменение указанного элемента |

	### Посмотреть результат

 | Команда | Что делает |
 |---|---|
 | `grafon open` | Открывает `grafon-out/graph.html` в браузере |
 | `grafon tree` | Строит интерактивное дерево графа (`GRAPH_TREE.html`) |

	### Лицензия

 | Команда | Что делает |
 |---|---|
 | `grafon license-status` | Показывает статус лицензии и оставшиеся дни (не блокирует) |
 | `grafon license link <КЛЮЧ>` | Подключает **командную** лицензию (см. раздел 6) |
 | `grafon license unlink` | Отключает это устройство от командной лицензии (освобождает место) |

	### Командная работа и обновление графа

 | Команда | Что делает |
 |---|---|
 | `grafon hook install` | Автоматически перестраивает граф после каждого коммита и переключения веток |
 | `grafon hook status` | Проверяет, включено ли автообновление |
 | `grafon hook uninstall` | Отключает автообновление |
 | `grafon merge-graphs a.json b.json` | Объединяет два графа (например, из разных репозиториев) |

 > Полный список команд — `grafon --help`.

 ---

	## 6. Командная лицензия (Team)

 Если над проектом работает **несколько человек**, удобнее оформить **командную лицензию (Team)** — это **5 мест** на одну лицензию. Каждое «место» — это одно устройство.

	### Как подключить команду

 1. **Администратор** оформляет командную лицензию на странице оплаты: `https://api.grafonbase.ru/pay`. После покупки он получает **лицензионный ключ** (КЛЮЧ).
 2. **Каждый участник** на своём компьютере один раз выполняет:

   ```powershell
   grafon license link ВАШ-КЛЮЧ
   ```

     Эта команда полностью заменяет индивидуальный пробный период/лицензию на командную — ничего дополнительно настраивать не нужно.

 3. Проверить, что лицензия подключена:

   ```powershell
   grafon license-status
   # должно быть: статус лицензии: активна (оплачена)
   #               План: Team (5 мест)
   ```

	### Освободить место

 Если сотрудник ушёл или устройство больше не используется, **освободите место** до истечения лимита:

 ```powershell
 grafon license unlink
 ```

 После этого устройство возвращается к свежему пробному периоду, а его место в команде освобождается для нового участника.

	### Командная работа над графом

 Чтобы у всей команды всегда был актуальный граф:

 - Один человек строит граф (`grafon extract . --code-only --force`) и сохраняет папку `grafon-out/` в общий репозиторий/архив.
 - `grafon hook install` на каждом компьютере **автоматически перестраивает граф после коммитов** и аккуратно объединяет графы,
 если двое коммитят одновременно (без конфликтов в `graph.json`).

 ---

	## 7. Если что-то не работает

 ### «grafon» не распознаётся как команда

 - **Откройте новое окно** консоли — старые окна «не видят» обновлённый `PATH`.
 - Проверьте, что Grafon установлен: откройте **«Параметры» → «Приложения»** и найдите Grafon.
 - При необходимости запустите Grafon по полному пути: `"C:\Grafon\grafon.exe" --version`.
 - Раньше приходилось править `PATH` вручную — **с установщиком `grafon_setup.exe` это больше не нужно**: он сам добавляет и убирает путь.

	### Антивирус или SmartScreen блокирует `grafon.exe`

 Это типичная реакция защитников Windows на программы, собранные через PyInstaller (такие программы «упакованы» в один запуск). Действия:

 - В SmartScreen выберите **«Подробнее» → «Выполнить в любом случае»**.
 - В антивирусе добавьте папку `C:\Grafon` в **исключения**.
 - Файл `grafon.exe` — это локальный анализатор кода; он **не отправляет ваш код в интернет** (при анализе только кода, `--code-only`).

	### Ошибки про DLL, «точка входа не найдена» или «не удаётся загрузить DLL»

 Grafon включает собственные системные библиотеки, но на некоторых системах дополнительно требуется **Microsoft Visual C++ Redistributable**:

 - Скачайте и установите **«VC++ Redistributable для Visual Studio 2015–2022 (x64)»** с сайта Microsoft.
 - Перезагрузите компьютер и попробуйте снова.

	### Ошибка «graph.json слишком большой» или `GRAPHIFY_MAX_GRAPH_BYTES`

 По умолчанию Grafon ограничивает размер файла графа **512 МБ**. Для очень крупных конфигураций 1С лимит можно поднять:

 ```powershell
 # PowerShell: задаём лимит в 2 ГБ для текущей сессии
 $env:GRAPHIFY_MAX_GRAPH_BYTES = "2GB"
 grafon extract . --code-only --force
 ```

	### Передача графа коллеге (через `.zip`)

 Папку `grafon-out/` можно заархивировать и переслать — внутри лежат только данные графа (без вашего закрытого ключа лицензии).
 Лицензионное состояние хранится отдельно, в `%APPDATA%\grafon\`, и **не входит** в архив.

 ```powershell
 Compress-Archive -Path .\grafon-out -DestinationPath grafon-out.zip
 ```

	### Не строится граф по документам/изображениям

 Анализ **кода** (`--code-only`) работает офлайн. Анализ документов (`.docx`, `.pdf`), таблиц и изображений требует одного из API-ключей LLM (например, Anthropic/OpenAI/Gemini). 
Для чистого анализа кода 1С никаких ключей не нужно — используйте `--code-only`.

 ---

	## 8. Частые вопросы

 **Нужно ли устанавливать Python?**
 Нет. `grafon.exe` — это полностью самодостаточная программа, внутри уже всё необходимое (включая интерпретатор Python). Python отдельно ставить **не нужно**.

 **Работает ли Grafon без интернета?**
 Частично. Построение графа по **коду** (`--code-only`) и ответы на вопросы по уже построенному графу работают **полностью офлайн**. Анализ документов, PDF и изображений,
 а также автоматическое именование сообществ требуют интернет-соединения и API-ключа LLM.
 Первая регистрация пробного периода также требует интернета (если интернета нет при первом запуске, Grafon включает локальный пробный период и зарегистрирует его позже автоматически).

 **Мой код куда-нибудь отправляется?**
 Нет. Код анализируется **локально** на вашем компьютере. При анализе только кода (`--code-only`) ничего не покидает вашу машину.
 Документы и изображения отправляются в LLM только если вы явно запускаете полный режим `extract` без `--code-only` и указали API-ключ.

 **Можно ли использовать Grafon бесплатно?**
 Да — пробный период **10 дней** бесплатный и включается автоматически. Чтобы продолжить работу после его окончания, оформите подписку на странице оплаты.
 Командная лицензия (Team) рассчитана на 5 устройств.

 **Сколько места занимает Grafon?**
 Сама установка — около 430 МБ. Файлы графа (`grafon-out/`) зависят от размера вашего проекта: для среднего проекта это единицы-десятки мегабайт.

 **На каких системах работает?**
 Windows 10/11 (64 бита). Установка и удаление не требуют прав администратора.

 **Как обновить Grafon до новой версии?**
 Скачайте новый `grafon_setup.exe` и установите поверх старого — настройки и лицензия сохранятся.

 ---


 **Grafon Labs** · [grafonbase.ru](https://grafonbase.ru) · поддержка по тому же адресу

 