sweaConnector

Ein Werkzeug, das dein persönliches Algorithmus-Lern-Repository mit Claude verbindet und als schreibgeschützten Android-Viewer brennt.

Claude liest und schreibt direkt in deinem Lern-Repository — wählt als Nächstes zu lösende Aufgaben aus, passt den Zeitplan an, und notiert Lösungsnotizen. Das Ergebnis kannst du jederzeit in einer auf Foldables abgestimmten E-Book-App aufrufen.

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

Was in diesem Repository nicht enthalten ist

Weder Problemtexte, Problemnummern noch Lösungscode sind hier enthalten. All das liegt ausschließlich in deinem privaten Repository.

Viele Algorithmus-Lernplattformen verbieten die Veröffentlichung und Weitergabe von Aufgaben und Lösungen in ihren Nutzungsbedingungen. Deshalb ist sweaConnector absichtlich ein leeres Gefäß — es enthält nur Werkzeuge, Konventionen und allgemeine CS-Konzeptbeschreibungen, der Inhalt wird beim Build aus deinem Repository eingespeist. Die Beispielaufgaben in fixtures/ sind alle fiktiv.

Aufbau

Erste Schritte

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

Die APK liegt unter app/reader/build/outputs/apk/release/. Wenn du das GitHub Actions überlassen möchtest, führe .github/workflows/apk.yml manuell aus (da es ein öffentliches Repository ist, wird mit Demoinhalt gebaut).

Auf dem Telefon installieren

1. Lade die APK in ein Release deines privaten Repositorys hoch — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. Öffne dieses Release im Browser des Telefons und lade die APK herunter (du musst bei GitHub angemeldet sein)

3. Erlaube dem Browser einmalig die Installation von „Unbekannte Quellen“

Veröffentliche deine APK nicht in einem öffentlichen Repository — die APK enthält Aufgaben und Lösungen.

Bildschirm

Beim Zusammen- und Aufklappen bleibt die Leseposition erhalten (dank configChanges wird die Aktivität nicht neu erstellt).

MCP-Tools

schedule_status ist kein Werkzeug, das den Plan abliest, sondern eines, das ihn unter der Annahme korrigiert, dass der Plan bereits verfehlt wurde. Sieh dir zuerst slackDays an — das sind die verbleibenden Puffertage bis zum Prüfungstermin; bei einem negativen Wert musst du das Tempo erhöhen.

Anforderungen

• Node 20+

• JDK 17+ · Android SDK (platform 35) — nur für lokale Builds. Mit Actions-Builds nicht erforderlich.

Entwurfsprinzipien

• Schreibgeschützter Viewer. Die App editiert nicht; Schreibvorgänge gehen über Claude (MCP) ins Repository.

• Kein Netzwerk zur Laufzeit. Der Inhalt wird beim Build in die APK gebrannt. Es gibt beim Antippen nichts zu parsen, daher erscheint er sofort.

• Foldables zuerst. Zusammengeklappt eine Seite, aufgeklappt eine Doppelseite — in Hoch- und Querformat.

• Diagramme als Vektoren. Algorithmus-Diagramme sind handgeschriebene SVG → VectorDrawable. KI-generierte Bilder sehen plausibel aus, sind aber falsch.

Lizenz

MIT (nur für Werkzeuge und Konzeptbeschreibungen). Die Rechte an den von dir eingespeisten Inhalten und die Einhaltung der jeweiligen Nutzungsbedingungen liegen in deiner Verantwortung.