Skip to content

Projektordner als KI-Kontext: Projektkarte + Nachladen durch die KI - #1

Merged
kaysiebke-cell merged 1 commit into
mainfrom
claude/projektordner-ki-anfragen-99uvsd
Aug 12, 2026
Merged

Projektordner als KI-Kontext: Projektkarte + Nachladen durch die KI#1
kaysiebke-cell merged 1 commit into
mainfrom
claude/projektordner-ki-anfragen-99uvsd

Conversation

@kaysiebke-cell

Copy link
Copy Markdown
Owner

Bisher sah die KI nur die geöffnete Datei (max. 200 Zeilen) — ein ganzes Projekt mit mehreren Ordnern ließ sich nicht mitschicken.

Variante A — Projektkarte:
Im KI-Panel unter „📌 Projekt-Kontext" lässt sich ein Projektordner wählen. Mitgeschickt wird eine Übersicht statt Quelltext: Ordnerbaum plus Klassen/Funktionen aller Python-Dateien (AST). Für dieses Repo sind das ~2900 Token für 104 Dateien; bei Ollama wird automatisch die sparsame Variante ohne Struktur-Übersicht verwendet (~750 Token).

Variante C — Nachladen:
Braucht das Modell den Inhalt einer Datei, fordert es sie mit „#DATEI: pfad" bzw. „#SUCHE: muster" an. Die Datei wird gelesen, an den Verlauf gehängt und die Anfrage läuft automatisch weiter (max. 3 Dateien je Runde, max. 2 Runden je Frage). Über Textmarken statt einer Tool-Call-API, damit es mit allen 19 Anbietern funktioniert. Dieselben Operationen stehen zusätzlich als Werkzeuge im Tools-Panel bereit.

Sicherheit: alle Pfade werden gegen den Projektordner geprüft (kein Ausbruch über „..", absolute Pfade oder Symlinks), es wird ausschließlich gelesen. Caches, .git, node_modules, venv, build/dist, Dateien über 200 KB und Nicht-Textformate werden übersprungen.

Die AST-Ergebnisse werden je Datei über mtime/Größe gepuffert — der Kartenaufbau fällt damit von 157 ms auf 2 ms je Anfrage.

24 neue Tests (Pfad-Absicherung, Karte, Lesen/Suchen, Nachlade-Ablauf, Puffer-Invalidierung), Doku in README, docs/ki-workflow.md und In-App-Hilfe nachgezogen.

Claude-Session: https://claude.ai/code/session_01SaJk9iHXDogxEwuRLiJ3ao

Bisher sah die KI nur die geöffnete Datei (max. 200 Zeilen) — ein ganzes
Projekt mit mehreren Ordnern ließ sich nicht mitschicken.

Variante A — Projektkarte:
Im KI-Panel unter „📌 Projekt-Kontext" lässt sich ein Projektordner
wählen. Mitgeschickt wird eine Übersicht statt Quelltext: Ordnerbaum plus
Klassen/Funktionen aller Python-Dateien (AST). Für dieses Repo sind das
~2900 Token für 104 Dateien; bei Ollama wird automatisch die sparsame
Variante ohne Struktur-Übersicht verwendet (~750 Token).

Variante C — Nachladen:
Braucht das Modell den Inhalt einer Datei, fordert es sie mit
„#DATEI: pfad" bzw. „#SUCHE: muster" an. Die Datei wird gelesen, an den
Verlauf gehängt und die Anfrage läuft automatisch weiter (max. 3 Dateien
je Runde, max. 2 Runden je Frage). Über Textmarken statt einer
Tool-Call-API, damit es mit allen 19 Anbietern funktioniert. Dieselben
Operationen stehen zusätzlich als Werkzeuge im Tools-Panel bereit.

Sicherheit: alle Pfade werden gegen den Projektordner geprüft (kein
Ausbruch über „..", absolute Pfade oder Symlinks), es wird ausschließlich
gelesen. Caches, .git, node_modules, venv, build/dist, Dateien über
200 KB und Nicht-Textformate werden übersprungen.

Die AST-Ergebnisse werden je Datei über mtime/Größe gepuffert — der
Kartenaufbau fällt damit von 157 ms auf 2 ms je Anfrage.

24 neue Tests (Pfad-Absicherung, Karte, Lesen/Suchen, Nachlade-Ablauf,
Puffer-Invalidierung), Doku in README, docs/ki-workflow.md und
In-App-Hilfe nachgezogen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SaJk9iHXDogxEwuRLiJ3ao
@kaysiebke-cell
kaysiebke-cell merged commit c412cee into main Aug 12, 2026
0 of 2 checks passed
kaysiebke-cell pushed a commit that referenced this pull request Aug 12, 2026
Das Feature war mit PR #1 gemergt und mit PR #3 wieder entfernt worden,
weil CI rot war. Die roten Läufe kamen jedoch von Altlasten auf main
(fehlender json-Import, undefinierte Variable, flake8-Fehlalarme) und
nicht von diesem Feature — auch der Lauf direkt nach dem Revert war noch
rot. Behoben wurden sie mit PR #2; seitdem ist main grün.

Dieser Commit stellt den ursprünglichen Stand unverändert wieder her:
Projektkarte des gewählten Ordners im Prompt, Nachladen einzelner
Dateien auf Anforderung der KI, drei Projekt-Werkzeuge und die Bedienung
im KI-Panel unter „Projekt-Kontext".

Beide CI-Schritte lokal mit Feature und Fixes zusammen geprüft:
flake8 endet mit 0, pytest meldet 84 bestandene Tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SaJk9iHXDogxEwuRLiJ3ao
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants