Руководства по ИИGitHub без кода

Что такое GitHub? Руководство для инженеров, которые не программируют

Почти каждая бесплатная инженерная программа на EngiFree в итоге ведёт на адрес github.com. В этом руководстве GitHub объясняется на инженерном языке, а также показано, как без путаницы скачивать оттуда программы и как с его помощью хранить историю ваших расчётов, скриптов и отчётов.

8 мин чтения

01Git и GitHub: режим исправлений для целой папки

Вы знаете режим исправлений («Track changes») в Word: видно, кто, что и когда изменил, и можно вернуться назад. Git — та же идея, но для целой папки файлов, и работает он на вашем компьютере. GitHub — сайт, который хранит такие папки в облаке, как Google Drive со встроенной машиной времени и доской обсуждений для команды. Git — это инструмент, а GitHub — его дом в интернете.

02Основные термины простыми словами

репозиторий

Repository (репозиторий, repo)

Одна папка проекта со всей её историей. Например, все расчётные файлы одного проекта.

титульный лист

README

Главная страница с описанием репозитория, которая показывается автоматически. Как титульный лист проектной папки: что здесь лежит и как этим пользоваться.

снимок

Commit (коммит)

Сохранённый снимок файлов с короткой пометкой, например «Обновлены ветровые нагрузки по изменению 2». К каждому коммиту можно вернуться.

вариант

Branch (ветка)

Отдельная рабочая копия, в которой можно опробовать изменение, не трогая основную версию. Как работа над вариантом Б проекта.

проверка

Pull request

Запрос на слияние изменений из ветки в основную версию, с возможностью проверки и комментариев. Точно как передача чертежа нормоконтролёру, прежде чем он войдёт в официальный комплект.

скачивание

Release (релиз)

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

03Термины, которые встречаются в открытых проектах

сообщение

Issue

Заявка об ошибке или пожелание. Пользователи сообщают о проблемах или просят новые функции, а разработчики отвечают на той же странице.

копия

Fork (форк)

Ваша собственная копия чужого репозитория, которую можно менять, не затрагивая оригинал.

популярность

Star (звезда)

Лайк или закладка. Много звёзд обычно означает, что проект известен и им пользуются многие.

юридическое

License (лицензия)

Файл, в котором сказано, что можно делать с программой: использовать, изменять, продавать. Если лицензии нет, по умолчанию копирование не разрешено.

04Как идёт работа на GitHub: пять шагов

  1. 1RepoСоздайте репозиторий для проекта и загрузите файлы
  2. 2CommitКаждое изменение сохраняется с пометкой: что сделано и зачем
  3. 3BranchКрупное изменение пробуйте в отдельной ветке, не рискуя основной версией
  4. 4Pull requestКоллега проверяет изменение, комментирует и одобряет слияние
  5. 5ReleaseОтметьте официальную версию, которую смогут скачать другие

05Почему это важно для вас: там живут бесплатные инженерные программы

САПР

FreeCAD

Параметрическое 3D-моделирование. Код и установщики публикуются на странице FreeCAD Releases на GitHub.

конструкции

OpenSees

Расчёт конструкций и сейсмический анализ от Беркли. Исходный код ведётся в репозитории OpenSees на GitHub.

ГИС

QGIS

Бесплатная ГИС. Разработка идёт на GitHub, а обычные пользователи скачивают программу с qgis.org.

МКЭ

CalculiX

Программа для расчётов методом конечных элементов. У неё есть репозиторий на GitHub в аккаунте автора, а официальные загрузки — на calculix.de.

электрика

KiCad

Проектирование электронных схем. Основная площадка проекта — GitLab (сайт, похожий на GitHub), а на GitHub есть зеркальная копия.

06Как безопасно скачать программу с GitHub

  1. 1

    Начните с первоисточника

    Переходите в репозиторий с официального сайта программы или по ссылке EngiFree, а не через рекламу или случайную ссылку.

  2. 2

    Найдите Releases

    На странице репозитория, справа или ближе к верху, есть ссылка Releases. Версия с пометкой Latest обычно стабильная; Pre-release означает тестовую сборку.

  3. 3

    Откройте Assets и выберите файл

    Для Windows ищите .exe или .msi, для Mac — .dmg, для Linux — .AppImage. Проверьте тип процессора (x86_64 или arm64).

  4. 4

    Пропустите Source code

    Файлы Source code (zip или tar.gz) автоматически добавляются к каждому релизу. Они нужны тем, кто сам собирает программу, а не тем, кто хочет её просто установить.

  5. 5

    Проверьте признаки жизни

    Сколько звёзд, когда вышел последний релиз и есть ли файл License. К проекту, который годами не обновлялся или не имеет понятной лицензии, стоит отнестись осторожно.

  6. 6

    Проверьте файл перед установкой

    Прогоните файл через антивирус, а если проект публикует контрольную сумму, сверьте её.

07Пример: история версий расчётной таблицы и скриптов

Инженер-конструктор в небольшом бюропросит
Создаёт приватный репозиторий calc-tools, загружает в него расчётную таблицу Excel для анкеров, скрипты Python и файлы отчётов LaTeX и после каждого обновления делает коммит: «Исправлен коэффициент надёжности по замечанию проверяющего».
получает
Когда клиент спрашивает: «По какой версии считали мартовский проект?», инженер открывает историю и видит, какой именно файл действовал, кто его менял и что изменилось. А в текстовых файлах — LaTeX, Markdown и скриптах — видны даже конкретные изменённые строки.
ИнструментGitHub (приватный репозиторий) и GitHub Desktop

08Пример: сообщение об ошибке в бесплатной программе

Техник-строитель, которая работает во FreeCADпросит
Открывает новый Issue в репозитории программы: «При экспорте в DXF теряются слои с размерами. Версия 1.1, Windows 11. Прилагаю небольшой файл, на котором воспроизводится проблема, и порядок действий».
получает
Разработчики подтверждают ошибку, связывают её с исправлением, и она получает уведомление, когда исправление попадает в релиз. Прежде чем открывать Issue, поищите: возможно, кто-то уже сообщил о той же проблеме.
ИнструментGitHub Issues

09Что для чего использовать: рекомендации для типичных задач

Что вы хотите сделатьЧто использоватьПочему
Скачать бесплатную инженерную программуСтраница Releases проектаТам лежат официальные установщики и примечания к выпуску
Хранить версии расчётов и отчётовПриватный репозиторий и GitHub DesktopПолная история без ввода команд
Сообщить об ошибке в программеIssues в репозитории программыРазработчики видят сообщение и отвечают в одном месте
Работать с коллегой над одними файламиBranch и Pull requestКаждое изменение проверяется, прежде чем попасть в основную версию
Поручить ИИ-агенту улучшить скриптClaude Code, Codex или Copilot в репозиторииАгент читает файлы и предлагает изменения в виде коммита или Pull request, который вы одобряете
Простая веб-страница для проекта или инструментаGitHub PagesБесплатный статический сайт из публичного репозитория на тарифе Free
Хранить отчёты в LaTeX или MarkdownПриватный репозиторийВидно, какие именно строки изменились между версиями

10Начните за 5 минут

  1. 1

    Создайте аккаунт

    Зарегистрируйтесь на github.com с адресом электронной почты и паролем и включите двухфакторную аутентификацию.

  2. 2

    Создайте приватный репозиторий

    Нажмите New repository, задайте имя, выберите Private и отметьте опцию добавления README.

  3. 3

    Загрузите файлы из браузера

    На странице репозитория: Add file, затем Upload files; перетащите файлы и напишите пометку. При загрузке через браузер размер одного файла ограничен 25 МиБ.

  4. 4

    Установите GitHub Desktop

    Бесплатное приложение для Windows и Mac, которое синхронизирует папку на вашем компьютере с репозиторием — щелчками мыши вместо команд.

  5. 5

    Сделайте первый коммит

    Измените файл, напишите короткую пометку, нажмите Commit, а затем Push. Теперь у вас есть история.

11Типичные ошибки: что делать и чего не делать

Делайте

  • Начинайте с приватного репозитория (Private) для всего, что связано с работой
  • Пишите понятные пометки к коммитам: что и зачем
  • Проверяйте лицензию, прежде чем использовать программу или код в коммерческом проекте
  • Скачивайте только со страницы Releases официального репозитория
  • Включите двухфакторную аутентификацию

Не делайте

  • Никогда не загружайте пароли, API-ключи или данные клиентов — даже в приватный репозиторий
  • Не делайте репозиторий публичным, не проверив всю его историю
  • Не думайте, что удаление файла убирает его из истории
  • Не скачивайте Source code, если вам нужно только установить программу
  • Не загружайте огромные файлы: для файлов больше 100 МиБ нужен специальный инструмент (Git LFS)

12Частые вопросы

GitHub платный?

Есть бесплатный тариф Free с неограниченным числом публичных и приватных репозиториев, 2 000 минут GitHub Actions в месяц и 500 МБ хранилища Packages. Платные тарифы добавляют функции для команд. Актуальные условия смотрите на github.com/pricing.

Нужно ли уметь программировать?

Нет. Чтобы скачать программу, сообщить об ошибке или хранить версии файлов, достаточно браузера и GitHub Desktop. Команды полезны, но не обязательны.

Как ИИ-агенты работают с GitHub?

Такие агенты, как Claude Code, Codex и Copilot, умеют читать репозиторий, редактировать файлы, делать коммиты и открывать Pull request, который вы проверяете и одобряете. Возможности и права доступа зависят от инструмента и тарифа. Например, Copilot Free включает до 2 000 автодополнений кода в месяц и ограниченное использование чата и агента. См. также наше руководство по агентам.

Что такое GitHub Pages?

Сервис, который превращает репозиторий в бесплатный статический сайт — например, в страницу с описанием созданного вами расчётного инструмента. На тарифе Free он работает только с публичным репозиторием; платные тарифы позволяют использовать и приватные.

Приватный репозиторий действительно приватный?

Его видят только приглашённые вами люди, но это всё равно облачный сервис. Никогда не храните там секреты, например пароли и ключи, а данные клиентов размещайте только в том случае, если это допускают договор и политика вашего бюро.

Хорошо ли работают на GitHub файлы Excel и PDF?

Их можно хранить, получая историю и возможность отката, но GitHub не покажет, какие ячейки изменились. Построчное сравнение работает для текстовых файлов: CSV, Python, LaTeX и Markdown.

Ещё в этом руководстве

Набор инструментов для Claude: что добавить под каждую задачу, чтобы он работал лучшеНабор под каждую задачуЧто такое Artifact? Руководство для инженеров, которым мало ответа в чатеРезультаты, а не только ответыЧто такое ИИ-агент? Практическое руководство для инженеровИИ-агенты в работеЧто такое Skills? Как научить Claude процедурам вашего бюро: руководство для инженераПроцедуры для ИИЧто такое коннектор? Как Claude подключается к вашим приложениям (MCP)Claude и ваши инструментыЧто такое Plugin? Как инженеру установить в Claude целый рабочий процесс сразуПакеты процессов для ИИЧто такое промпт и как написать хороший промпт?Разговор с ИИProjects и память в Claude: пусть он помнит вашу работуКонтекст, который остаётсяМодели, токены и контекстное окно: что происходит за кулисамиКак думает ИИИзображения и видео в Claude: что он видит, что создаёт и как обойти ограниченияГлаз ClaudeЧто такое дизайн-система? Руководство для недизайнеровДизайн без дизайнераЧто такое сниппет? Руководство для инженера по многоразовым фрагментам кода и текстаГотовые строительные блокиДизайн изображений с ИИ: создавайте, редактируйте и улучшайте картинки бесплатно и платноИзображения с ИИСоздание ИИ-персонажа: маскот, аватар, говорящий ведущий, 3DЗадача: ИИ-персонажИнженерные расчёты с ИИ: считать, проверять и правильно оформлятьРасчёты с ИИСоздаём инженерное ПО с ИИ: от небольшого калькулятора до приложения без навыков программированияПрограммы без программированияПоиск продукции с ИИ: как найти, сравнить и проверить товары, поставщиков и технические описанияПоиск продукцииПоиск стандарта с помощью ИИ: нужный стандарт и пункт без галлюцинацийСтандарты без догадокПолное руководство по ClaudeВсё, что нужно для начала, шаг за шагом

Вернуться на страницу ИИ