Реалізація AI-пояснення коду у мобільному додатку

AI-Пояснення Коду в Мобільних Застосунках

Пояснення коду — це більш вузька задача, ніж повноцінна допомога по кодуванню. Користувачі вставляють незнайомий код або виділяють рядки, натискають «Пояснити» й отримують зрозумілі описи. Типовий контекст: навчальні платформи, інструменти для перевірки коду, мобільні IDE.

Визначення мови програмування

Перед поясненням потрібно визначити мову. Користувачі рідко вказують її явно.

На iOS NaturalLanguage не допоможе—він призначений для людських мов. Потрібна евристика або спеціалізовані бібліотеки.

func detectLanguage(_ code: String) -> ProgrammingLanguage {
    let patterns: [(ProgrammingLanguage, [String])] = [
        (.swift, ["func ", "var ", "let ", "guard ", "@IBOutlet", "import Foundation"]),
        (.kotlin, ["fun ", "val ", "var ", "data class", "viewModelScope", "suspend fun"]),
        (.python, ["def ", "import ", "elif ", "print(", "__init__", "self."]),
        (.javascript, ["const ", "let ", "=>", "async function", "require(", "module.exports"]),
        (.typescript, [": string", ": number", "interface ", "<T>", "as unknown as"]),
        (.java, ["public class", "private void", "@Override", "System.out.println"])
    ]

    let codeShort = String(code.prefix(500))
    for (language, markers) in patterns {
        let matchCount = markers.filter { codeShort.contains($0) }.count
        if matchCount >= 2 { return language }
    }
    return .unknown
}

Евристика на основі маркерів працює у 90% випадків. Для точного визначення використовуйте алгоритм github-linguist або API (недоцільно для мобільних клієнтів).

Передайте виявлену мову в запит—це значно покращує якість пояснення, особливо для мов із подібним синтаксисом (Swift проти Kotlin, JavaScript проти TypeScript).

Запити для різних рівнів пояснення

Одне пояснення не підходить всім. Новачки хочуть знати «що робить цей код», а досвідчені розробники хочуть «чому цей підхід замість lazy var?»

enum ExplainLevel {
    case beginner, intermediate, expert

    var instruction: String {
        switch self {
        case .beginner:
            return "Explain this code for someone new to programming. Avoid jargon. Use simple analogies."
        case .intermediate:
            return "Explain what this code does, why key design decisions were made, and potential edge cases."
        case .expert:
            return "Analyze this code: architecture patterns used, performance implications, thread safety, potential issues."
        }
    }
}

Визначайте рівень автоматично з поведінки користувача (як часто використовується режим для новачків, як швидко читаються відповіді) або надайте перемикач.

Пояснення рядок за рядком

Для коротких фрагментів (< 20 рядків) рядок за рядком є ефективним:

Explain this code line by line. Format:
Line N: [explanation]
(skip blank lines and closing braces unless important)

Code:
{code}

Показуйте як накладення над редактором: користувач натискає рядок, поруч з'являється спливаюче пояснення.

// Android Compose - пояснення рядка при натисканні
@Composable
fun CodeWithExplanations(
    code: String,
    explanations: Map<Int, String>  // lineNumber -> explanation
) {
    val lines = code.lines()
    LazyColumn {
        itemsIndexed(lines) { index, line ->
            Column(modifier = Modifier.clickable { /* request explanation */ }) {
                Row {
                    Text(
                        text = "${index + 1}",
                        modifier = Modifier.width(32.dp),
                        color = MaterialTheme.colorScheme.onSurfaceVariant,
                        style = MaterialTheme.typography.bodySmall.copy(fontFamily = FontFamily.Monospace)
                    )
                    Text(
                        text = line,
                        style = MaterialTheme.typography.bodySmall.copy(fontFamily = FontFamily.Monospace)
                    )
                }
                explanations[index + 1]?.let { explanation ->
                    Text(
                        text = explanation,
                        modifier = Modifier
                            .fillMaxWidth()
                            .background(MaterialTheme.colorScheme.secondaryContainer)
                            .padding(horizontal = 8.dp, vertical = 4.dp),
                        style = MaterialTheme.typography.bodySmall,
                        color = MaterialTheme.colorScheme.onSecondaryContainer
                    )
                }
            }
        }
    }
}

Пояснення складних конструкцій

Регулярні вирази, побітові операції, складні генерики—окремий клас. Додайте до запиту:

If the code contains regex patterns, explain each group separately.
If it uses bitwise operations, explain the binary logic.
If it uses generics or type constraints, explain why they're necessary.

Для regex додатково викличте API regex101.com або використовуйте вбудовану візуалізацію через NSRegularExpression з покроковим поясненням груп.

Кешування пояснень

Не пояснюйте однаковий код повторно. Кешуйте за хешем SHA256(code + language + level) з TTL 7 днів.

let cacheKey = SHA256.hash(data: Data("\(code)\(language)\(level)".utf8))
    .map { String(format: "%02x", $0) }.joined()

if let cached = explanationCache[cacheKey] {
    return cached
}

На пристрої: NSCache для сеансових даних, Core Data / Room для постійного кеша.

Орієнтири за часом

Базове пояснення вставленого коду—2–3 дні. Режим рядок за рядком + автовизначення мови + рівні складності + кешування—1,5 тижня.