Это старая версия документа!
Содержание
Архив исходников, Graphify и выбор контекста
Назначение и границы
Публичный sharix-open-tz предоставляет контекст ShariX Open: опубликованные исходники, их структурные графы и при явном выборе снимок публичной Wiki. Это инструмент на компьютере, готовящем архив. Он не устанавливает приложение и не изменяет сервер. Для чтения и анализа ShariX Open закрытые исходники Platform и внутренняя Wiki не требуются.
Не путать этот публичный загрузчик с полным внутренним TZ: набор режимов, каталог и формат inventory могут различаться. Команды ниже относятся именно к ShariX_Open/sharix-open-tz.
Как получить пакет
Из корня актуального публичного TZ сначала проверить интерфейс и состав. Команды ниже не запускают Django и не меняют БД.
./tools/download_sharix_sources.sh --help ./tools/download_sharix_sources.sh --list ./tools/download_sharix_sources.sh --with-knowledge --graphify-html --output-dir "$HOME/Downloads"
Последняя команда скачивает выбранные исходники и публичную Wiki, строит графы и сохраняет ZIP. Без –with-knowledge Wiki не включается. –graphify-html добавляет автономные HTML-представления; JSON и отчёты нужны и без HTML. –no-graphify — явный режим архива без графов; нельзя выдавать его за полный графовый анализ. Ветка выбирается каталогом или явными –branch/–branch-all; не подставлять историческую ветку без проверки задачи.
Graphify устанавливается отдельно на компьютере, формирующем архив. При отсутствии инструмента интерактивный загрузчик предлагает установку с согласием; без терминала выдаёт способ подготовки или явного отказа от графов. Актуальные зависимости и параметры — в README/–help публичного TZ. Не устанавливать Graphify в Django venv работающего сервиса и не включать его Git hooks.
Что находится в архиве
| Часть | Назначение |
|---|---|
MANIFEST.tsv, README.txt | Состав пакета и исходные сведения о получении. |
sources/ и context/ | Отдельные Git ZIP опубликованных исходников и публичного TZ, без истории .git. |
knowledge/open.zip | Снимок публичной Wiki, если выбран –with-knowledge. |
graphify/open/ | Графы кода, UI/дизайна/имён конфигурации, отчёты и сборочные представления. |
GRAPHIFY_INVENTORY.json в разделе графов | Привязка результатов к Git SHA и контрольным суммам артефактов; точное размещение сверить по README пакета. |
Исходные архивы и анализ относятся к одному выбранному временному checkout. Сохранённый в исходниках старый граф не служит заменой новой генерации. Проверка неизменности отслеживаемых файлов защищает исходный срез от побочного изменения анализатором. При ошибке анализа загрузчик не должен молча публиковать неполный графовый пакет.
Как выбирать контекст
Начать с вопроса и нужного продукта. По индексу Wiki найти owner и контракт, затем по inventory выбрать соответствующий репозиторий и commit. Граф помогает найти связанные маршруты, модели, шаблоны и consumers; после этого читают конкретные исходники и проверки.
Граф документов Wiki показывает связи знаний; Graphify показывает статические связи исходников; UI overlay добавляет обнаруженные связи интерфейса. Они дополняют друг друга и не доказывают успешное выполнение программы. Неразрешённая динамическая связь является вопросом для проверки. Наличие стрелки не подтверждает права, целостность БД, внешний callback или завершение пользовательского процесса.
Актуальность и безопасная передача
После изменения исходной версии граф того же имени может быть устаревшим. Для нового анализа заново получить нужный срез и сверить inventory, не исправлять вручную контрольную сумму ради отметки актуальности. Снимок Wiki также имеет собственную дату и может отставать от текущей страницы.
В пакет не добавляют локальные .env, credentials, рабочую БД и журналы. Публичный каталог не обращается к закрытым продуктам; недоступный публичный источник — ошибка получения, а не приглашение передать личный токен в чат. Архив помогает анализу, но не является разрешением внедрять изменения.
Для нейросети
Не читать весь пакет без разбора и не считать граф источником бизнес-истины. Обозначить выбранные версии, найти нужные контракты, проверить исходники и оставить проверяемые ссылки. Если данные не покрывают вопрос, указать конкретный пробел. Передать человеку понятный вывод и способ его применения; правила свидетельств — критерии приёмки.
Проверенная исходная база: 30.10.2026
Сверены опубликованные исходники. Это анализ кода, а не подтверждение успешной установки на конкретном сервере.