Source Code Mapper AI

English | Русский | Deutsch

Android-приложение: открывает локальный репозиторий или клонирует его с GitHub, строит «полную картину» кода и формирует интерактивный HTML-отчёт из 4 столбцов со сворачиваемыми блоками.

Что делает

1. Открыть локальный репозиторий — системный выбор папки (SAF, доступ только на чтение).
2. Клонировать с GitHub — owner/repo или полный URL; по умолчанию git clone (JGit), при ошибке — автоматический откат на скачивание ZIP (codeload.github.com).
3. Построить отчёт — гибридный конвейер:
   • на устройстве: обход файлов → статический разбор (файлы, классы, функции, методы, свойства, UI-элементы, триггеры, ресурсы манифеста, маршруты) → эвристики безопасности;
   • через AI: столбец 2 (описание) и столбец 4 (оценка), плюс обзор архитектуры;
   • генерация HTML и показ в WebView с экспортом/шерингом.
4. Express-отчёт — прогон одного и того же кода по всем настроенным моделям по очереди, затем сравнение результатов в супер-отчёт (согласие/расхождения моделей, мнения по каждому элементу, AI-разбор разногласий).
5. AI-провайдеры — добавление, редактирование и удаление OpenAI-совместимых провайдеров, возврат к набору по умолчанию.

Правила анализа

• README, *.md, *.txt, лицензии, changelog и прочая документация не анализируются — учитывается только реальный исполняемый код.
• Комментарии в коде игнорируются: элементы строятся только по значимым строкам, комментарии и пустые строки в отчёт не попадают; при этом каждая строка кода находит место.
• Если AI не уверен в назначении участка, он обязан пометить строку уровнем уверенности (Подтверждено / Вероятно / Не подтверждено) и указать краткое обоснование или причину, по которой подтвердить не удалось (столбец 4).

Отчёт: 4 столбца

Всё свёрнуто по умолчанию: группа файла → строка элемента → 4-колоночная сетка. Любой текст, не вмещающийся в четверть ширины экрана (ячейка ~25%), получает кнопку ▸ / ▾. Есть поиск, фильтр по оценке, «Развернуть всё / Свернуть всё».

Языки интерфейса и отчёта

Английский — основной язык и язык по умолчанию. Русский и немецкий поддерживаются полностью: интерфейс, HTML-отчёт (заголовки, столбцы, уровни, супер-отчёт), статические описания элементов, сообщения и названия провайдеров. Выбор языка влияет и на язык ответов модели. Технический журнал анализа остаётся на английском (отладочная информация).

Провайдеры ИИ (Настройки)

Кнопка «Проверить соединение» дергает /models. Ollama OAuth: приложение открывает ollama.com/connect?... и опрашивает API до появления ключа.

Сборка

$env:JAVA_HOME="C:\Program Files\Microsoft\jdk-17.0.15.6-hotspot"
$env:ANDROID_HOME="C:\Android\Sdk"
.\gradlew.bat :app:assembleDebug

APK: app/build/outputs/apk/debug/app-debug.apk

Установка на эмулятор:

adb -s emulator-5554 install -r -t app/build/outputs/apk/debug/app-debug.apk

Стек

Kotlin (встроенный в AGP 9.1.1), Jetpack Compose (BOM 2024.09.00, Material3), coroutines, kotlinx-serialization-json, OkHttp, JGit, DocumentFile, Gradle 9.3.1, compileSdk 36 / minSdk 26.

Структура исходников

app/src/main/java/online/devhorizon/sourcecodemapper/
  MainActivity.kt, MainViewModel.kt
  model/Models.kt
  i18n/Strings.kt                 # EN / RU / DE
  data/Settings.kt                # провайдеры, настройки, кэш
  data/RepoAccess.kt              # SAF + JGit + ZIP-фолбэк
  analysis/Language.kt
  analysis/Comments.kt            # фильтр комментариев и пустых строк
  analysis/StaticIndexer.kt       # извлечение элементов + покрытие строк
  analysis/SecurityRules.kt       # правила столбца 4
  analysis/Enricher.kt            # AI для столбцов 2 и 4
  analysis/ExpressMerger.kt       # супер-отчёт по нескольким моделям
  ai/AiClient.kt                  # 4 провайдера + Ollama OAuth
  report/HtmlReport.kt            # HTML: 4 колонки, сворачивание, поиск
  ui/                             # Compose-экраны

Ограничения

• Лимиты по умолчанию: 2000 файлов, 320 КБ на файл, 25 МБ текста (настраиваются).
• Скорость AI зависит от выбранной модели; результаты кэшируются по хэшу файла.
• Для приватных репозиториев нужен GitHub-токен.

CI

GitHub Actions собирает debug-APK при каждом пуше в main и в pull request (.github/workflows/android.yml). Пуш тега v* прикрепляет APK к GitHub Release.

Скриншоты

• Главный экран — источник репозитория: локальная папка через SAF, клон с GitHub (owner/repo, ветка, токен) либо встроенный пример; тут же выбор языка отчёта.
  
• Клонированный репозиторий — после клона: 38 файлов, 4756 строк, 203,7 КБ, разбивка по языкам (Kotlin 24 файла / 4200 строк, Text, BAT, XML, YAML, GITIGNORE, Properties, PRO) и кнопки «Build 4-column report» и «Express report (all models)».
  
• Настройки и провайдеры ИИ — язык отчёта (RU / DE / EN) и список OpenAI-совместимых провайдеров: DevHorizon (primary) без API-ключа, добавление и редактирование своих.

Скачать APK

app-debug.apk — 12,4 МБ, debug-сборка версии 1.0 (Android 8.0+, minSdk 26).

Страница релиза: v1.0-debug · исходники: github.com/sashok53011/SourceCodeMapperAI.