v0.9.5 is live! — Read the latest technical documentation and migration guides.

docmd-assistant v0.1.17 macht die Assistant-Engine vollständig universell und seitenunabhängig, führt gezielte Versions- und Teilprojekt-Suchfilter ein, integriert eine Token-sparende Inhaltsbegrenzung für umfangreiche Dokumentationsseiten, stärkt die Grenzen des Kontextfensters und verbessert die Netzwerkfehlertoleranz.

Hauptfunktionen & Verbesserungen

Universeller & seitenunabhängiger System-Prompt

  • Authentische Wissensfindung: Ersetzt fest codierte Konfigurationsannahmen durch einen universellen, seitenunabhängigen Prompt. Anstatt vorgegebene Konfigurationsschemata vorauszusetzen, ermittelt und begründet der Assistent seine Antworten dynamisch über die verfügbaren Tools (search_documentation, read_documentation_page). Dies gewährleistet ein natürliches Zusammenspiel mit jeder Dokumentationsseite, jedem Entwickler-Blog oder technischen Leitfaden.
  • Konsistente Identität: Bewahrt die Kernidentität des „docmd assistant“ als professioneller KI-Guide, der Fragen präzise anhand des dokumentierten Inhalts beantwortet.

Versions- & Projekt-gefilterte Dokumentationssuche

  • Gezielte Versionsfilterung: Die Parameterstruktur von search_documentation wurde um optionale Filter für version (z. B. "0.9.0", "0.8.0", "latest") und project erweitert, sodass Dokumentationen mit mehreren Versionen oder Teilprojekten gezielt durchsucht werden können.
  • Weitergabe an benutzerdefinierte Suchfunktionen: An createStandardTools übergebene benutzerdefinierte Such-Handler erhalten nun die Argumente (query, project, version) zur feingliedrigen Indexabfrage.

Intelligente Inhaltsbegrenzung & Kontextfenster-Absicherung

  • DOM-Leser Token-Ökonomie: In read_documentation_page wurde eine Obergrenze von 8.000 Zeichen mit einem klaren Fortsetzungshinweis (...[content capped for token economy]) eingeführt. Dies schützt das Token-Budget vor übergroßen API-Spezifikationen, während relevanter Erklärungstext und Codebeispiele erhalten bleiben.
  • Kontextfenster-Mindestgrenze: Eine Mindestgrenze von 1.000 Zeichen für die Option contextWindow verhindert, dass fehlerhafte oder zu kleine Werte versehentlich den abgerufenen Dokumentationskontext leeren.

Fehlertolerante Netzwerkverarbeitung

  • Verständliche Netzwerk-Fehlermeldungen: Fängt Browser-Verbindungsfehler auf niedriger Ebene (Failed to fetch, Load failed) sowohl im Streaming- als auch im Standardmodus ab und liefert klare, handlungsorientierte Diagnosen.
  • Saubere Abbruchbehandlung: Verarbeitet abgebrochene Anfragen und AbortError sauber, ohne Protokolle mit unnötigen Fehlern zu überfluten.

Behobene Probleme

  • Universeller Abruf: Behebt ein Problem, bei dem starre Konfigurationsvorgaben im Standard-Prompt dazu führten, dass der Assistent von docmd.config.json-Strukturen ausging, anstatt die tatsächliche Konfiguration der jeweiligen Seite abzurufen.
  • Präzision bei Versionsanfragen: Behebt ein Problem, durch das versionierte Abfragen (z. B. nach historischen Release Notes) den Suchbereich nicht gezielt auf eine bestimmte Version einschränken konnten.

Upgrade

npm
pnpm
npm install docmd-assistant@0.1.17
pnpm add docmd-assistant@0.1.17