Ein Matrix-Bot, der aus einer Chat-Nachricht ein GitHub-Issue macht. Passt zu Diddy: Antworten kommen als Diddy-Karten, die Befehle erscheinen beim Tippen als Vorschlag, und Diddy zeigt den Bot als Bot an. In Element & Co. kommt normaler Text.
!issue Login geht nicht | Nach dem Update sehe ich nur einen weißen Bildschirm.
→ ✅ Issue #42 in Lndr2501/diddy angelegt: Login geht nicht + Link
| Befehl | Wirkung |
|---|---|
!issue Titel | Beschreibung |
Issue anlegen |
!issue Titel ⇧↵ Beschreibung |
Titel in Zeile 1, Beschreibung darunter (Shift+Enter) |
!issue "Titel" Beschreibung |
Titel in Anführungszeichen (auch „…“) |
!issue Kurzer Text |
bis 80 Zeichen: alles ist der Titel |
!issue Langer Text. Mehr … |
erster Satz = Titel, Rest = Beschreibung |
!bug … · !idee … |
wie !issue, zusätzlich Label bug bzw. enhancement |
!issue musik: Titel | … |
anderes Repo per Kurzname (siehe ISSUE_REPOS) |
!issue · !issuebot |
Hilfe |
Aliase: !ticket, !problem, !fehler, !feature, !wunsch, !idea.
!help beantwortet der Bot absichtlich nicht (das macht schon der Musikbot).
- Matrix-Account für den Bot anlegen, z. B.
@issuebot:dein.server. - GitHub: Fine-grained Token nur für die Ziel-Repos, Berechtigung Issues: Read and write.
- Starten:
cp .env.example .env # Zugang, Token, ISSUE_REPOS eintragen docker compose up -d --build - Bot in den Raum einladen. Für die Befehlsvorschläge in Diddy braucht er Moderator (Stufe 50); ohne geht alles andere trotzdem.
Mit AI_BASE_URL und AI_MODEL (jede OpenAI-kompatible API: Ollama, vLLM, LM Studio, OpenAI …)
bereitet der Bot jedes neue Issue im Hintergrund auf. Die Chat-Antwort kommt trotzdem sofort.
- Die KI liest das Issue und nennt Suchbegriffe (Funktionsnamen, UI-Texte, Dateinamen).
- Der Bot lädt den aktuellen Stand des Repos (Tarball, im Speicher, ~3 s für Diddy) und sucht.
- Die KI bekommt die Fundstellen mit Zeilennummern und schreibt: präziser Titel, Zusammenfassung, Schritte/Erwartet/Tatsächlich, relevante Codestellen, Hinweise für die Umsetzung, offene Fragen.
- Der Bot prüft jede Codestelle gegen den echten Code (erfundene fliegen raus) und schreibt alles ins Issue. Codestellen sind Permalinks auf den Commit, GitHub zeigt sie als Code-Ausschnitt. Die Originalmeldung bleibt aufklappbar darunter.
Kein Tool-Calling nötig: zwei Chat-Anfragen über /chat/completions mit stream: true.
Normale JSON-Antworten werden ebenfalls akzeptiert. Bei unbrauchbarem JSON gibt es genau einen
zweiten Versuch ohne JSON-Zwang; HTTP-/Verbindungsfehler werden nicht blind wiederholt.
AI_REASONING: leer = keinreasoning_effortsenden; sonstnone,low,medium,high(weitere Stufen je nach Anbieter). Suchbegriffe nutzenlow, die Aufbereitung die eingestellte Stufe.nonelässt das Denken für beide Schritte ausgeschaltet.AI_MAX_TOKENS=12000: Ausgabe inklusive Denk-Tokens.AI_CONTEXT_CHARS=24000begrenzt den gesendeten Code, nicht das Kontextfenster des Modells.- Die KI bekommt zusätzlich Projektbeschreibung und README-Anfang. Knappe Wünsche sollen nicht zu erfundenen Fehlern werden; bei unklarer Einordnung bleibt der Originaltitel erhalten.
- Code-Verweise werden auf tatsächlich gezeigte Zeilen geprüft. Wird das Issue während der Recherche bearbeitet, verwirft der Bot das Ergebnis statt die Bearbeitung zu überschreiben.
Es läuft immer nur eine Recherche gleichzeitig. Fehler landen nur im Log; das angelegte Issue bleibt dann unverändert. Recherchen sind Hintergrundaufgaben im Speicher: nach einem Neustart werden unterbrochene Aufgaben nicht automatisch nachgeholt.
Datenschutz: Issue-Text, Repository-Beschreibung, README-Auszug und Code-Ausschnitte gehen an den konfigurierten KI-Anbieter. Die Matrix-Melderzeile wird vor dem Senden entfernt.
- Einladungen nimmt der Bot nur von Leuten auf seinem eigenen Server an (
INVITE_SERVERSerweitert das,ALLOWED_USERSschränkt alles auf bestimmte Personen ein). - Höchstens 5 Issues pro Person in 10 Minuten (
RATE_LIMIT). - Nachrichten von vor dem Start werden nie ausgeführt, jede Nachricht höchstens einmal
(gemerkt in
/data), auch nach Neustart. - Im Issue steht unten „Gemeldet über Matrix von Name (
@id)“. Bei öffentlichen Repos ist das öffentlich:REPORTER_IN_ISSUE=idoderoff. Raumnamen landen nie im Issue. - Anzeigenamen werden entschärft (keine Links/Bilder/@-Erwähnungen über den Namen).
- Verschlüsselte Räume gehen (E2EE über matrix-nio/vodozemac). Das Gerät des Bots liegt im
Docker-Volume;
docker compose down -vmacht ihn zu einem neuen Gerät.
python3 -m venv .venv && .venv/bin/pip install -e '.[dev]'
.venv/bin/python -m pytest -qAufbau: parse.py (Titel/Beschreibung trennen), bot.py (Logik), github.py (REST),
cards.py (Diddy-Karten, Protokoll: docs/bot-cards.md im Diddy-Repo), matrix.py (nio),
research.py + codesearch.py (KI-Recherche),
store.py (SQLite).