sweaConnector

Инструмент для подключения вашего учебного репозитория по алгоритмам к Claude и сборки его в автономное Android-приложение для чтения.

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

   ┌──────────────┐   MCP    ┌──────────────┐  빌드 시 주입  ┌──────────────┐
   │  당신의 학습   │ ───────► │    Claude    │              │  안드로이드    │
   │  저장소        │ ◄─────── │              │              │  뷰어 (APK)   │
   │  (private)    │  기록     └──────────────┘              └──────────────┘
   └──────────────┘                                                ▲
          └─────────────────────────────────────────────────────────┘

Чего нет в этом репозитории

Здесь нет ни текстов задач, ни их номеров, ни кода решений. Всё это находится только в вашем приватном репозитории.

Многие платформы для изучения алгоритмов запрещают публикацию и распространение задач и решений своими условиями. Поэтому sweaConnector — намеренно пустой сосуд: он содержит только инструменты, соглашения и объяснения общих концепций CS, а содержимое внедряется из вашего репозитория при сборке. Все примеры задач в fixtures/ вымышлены.

Структура

Начало работы

git clone https://github.com/rleaderjoon/sweaConnector
cd sweaConnector
npm install
npm test                              # 13개 자체 검증 (MCP 핸드셰이크 포함)

# 1. 내 저장소가 규약에 맞는지 확인
node pipeline/extract.mjs --repo /path/to/my-study-repo --out content.json

# 2. 일정 설정 — 내 학습 저장소 루트에 .sweaconnector.json
echo '{"startDate":"2026-08-15","examDate":"2026-09-19"}' > /path/to/my-study-repo/.sweaconnector.json

# 3. Claude 에 붙이기
claude mcp add swea -- node ./mcp/index.mjs --repo /path/to/my-study-repo

# 4. 내 APK 굽기 — 콘텐츠 추출부터 서명까지 한 번에
bash pipeline/build-apk.sh /path/to/my-study-repo release

APK появляется в app/reader/build/outputs/apk/release/. Если хотите поручить сборку GitHub Actions, запустите .github/workflows/apk.yml вручную (так как репозиторий публичный, сборка выполняется с демо-контентом).

Установка на телефон

1. Загрузите APK в Release своего приватного репозитория — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. Откройте этот Release в браузере телефона и скачайте APK (нужно быть авторизованным в GitHub)

3. Один раз разрешите браузеру установку «из неизвестных источников»

Не выкладывайте свой APK в публичный репозиторий — внутри APK находятся задачи и решения.

Экраны

При складывании и раскладывании позиция чтения сохраняется (активити не пересоздаётся благодаря configChanges).

Инструменты MCP

schedule_status — это не инструмент для чтения плана, а инструмент, который исправляет план, исходя из предпосылки, что он уже нарушен. Сначала посмотрите slackDays — это количество запасных дней до даты экзамена; если оно отрицательное, нужно ускорить темп.

Требования

• Node 20+

• JDK 17+ · Android SDK (platform 35) — только для локальной сборки. При сборке через Actions не требуется.

Принципы проектирования

• Вьюер только для чтения. Приложение не редактирует. Запись происходит в репозиторий через Claude (MCP).

• Нет сети в рантайме. Контент запекается в APK на этапе сборки. При нажатии нечего парсить — всё открывается мгновенно.

• Складные устройства в приоритете. В сложенном виде — одна страница, в разложенном — разворот. И вертикально, и горизонтально.

• Схемы — вектор. Алгоритмические схемы — это нарисованные от руки SVG → VectorDrawable. ИИ-сгенерированные изображения выглядят правдоподобно, но ошибаются.

Лицензия

MIT (только для инструментов и объяснений концепций). Соблюдение прав и условий для содержимого, которое вы внедряете, — ваша ответственность.