Communitygithub.com

Compaction UI v2.1.0

Speicherkomprimierungssystem für die OpenClaw Control UI – Hintergrundausführung mit Toast-Benachrichtigungen, automatischer Auslöser bei konfigurierbaren Token-Schwellenwerten, Zusammenfassungsabsätze im komprimierten Output, dedizierter Einstellungs-Tab mit Modellauswahl und Ergebnishistorie.

Was ist Compaction UI v2.1.0?

Dieses Skill implementiert ein vollständiges Speicherkomprimierungssystem für die OpenClaw Control UI. Es ermöglicht die Komprimierung des Chat-Kontextes im Hintergrund, ohne die Benutzeroberfläche zu blockieren. Die Hauptfunktionen umfassen einen kontextabhängigen Messanzeige-Button, eine automatische Komprimierung bei Überschreitung eines konfigurierbaren Token-Limits, und die Generierung einer Zusammenfassung des Gesprächs als erweitertes Komprimierungsergebnis. Der Skill bietet einen eigenen Einstellungs-Tab, über den die automatische Komprimierung aktiviert, der Schwellenwert eingestellt und ein spezifisches Modell für die Komprimierung ausgewählt werden kann. Die Authentifizierung erfolgt über die gleiche Hierarchie (OAuth > API-Key > Fallback) wie der normale Chat, und die Ergebnisse können wahlweise gespeichert und eingesehen werden. Das System wurde für Cursor entwickelt und ist für Entwickler gedacht, die die OpenClaw Steuerungsoberfläche um eine effiziente und nicht-blockierende Speicherverwaltung erweitern möchten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/LeoYeAI/openclaw-master-skills/compaction-ui-enhancements

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Compaction UI v2.1.0?

Speicherkomprimierungssystem für die OpenClaw Control UI — Hintergrundausführung mit Toast-Benachrichtigungen, automatischer Auslöser bei konfigurierbaren Token-Schwellenwerten, Zusammenfassungsabsätze im komprimierten Output, dedizierter Einstellungs-Tab mit Modellauswahl und Ergebnishistorie.

Status: ✅ Aktiv

KomponenteStatus
Kontext-Messanzeige-Button✅ Funktionsfähig
Hintergrundkomprimierung (Toast)✅ Funktionsfähig
Automatischer Komprimierungsauslöser✅ Funktionsfähig
Gesprächszusammenfassungsabsatz✅ Funktionsfähig
Einstellungs-Tab (Plugin-registriert)✅ Funktionsfähig
Modellauswahl✅ Funktionsfähig
Letzte Ergebnis-Speicherung & -Anzeige✅ Funktionsfähig
Einstellungs-Persistenz & -Wiederherstellung✅ Funktionsfähig
Auth-Hierarchie (OAuth > API > Fallback)✅ Funktionsfähig
Chatverlaufsfilter✅ Funktionsfähig
Vollständige Hintergrundisolation (keine Chat-Interferenz)✅ Funktionsfähig

Funktionen

1. Kontext-Messanzeige-Button (app-render.helpers.ts)

Ein kreisförmiger SVG-Fortschrittsring in der Chat-Symbolleiste, der gleichzeitig als manueller Komprimierungsauslöser dient.

  • Platzierung: Nach dem Session-Auswahl-Dropdown in renderChatControls()
  • Datenquelle: sessionsResult.sessions[].totalTokens und contextTokens aus Session-Zeilen
  • Farben: Grün (<60%), Gelb (60-85%), Rot (≥85%)
  • Deaktiviert: Wenn die Auslastung <20% beträgt oder während einer aktiven Komprimierung
  • Tooltip: Zeigt "Kontext: XK / YK Tokens (Z%)" an

2. Hintergrundkomprimierung (Toast)

Beim Klick (oder automatischem Auslösen) läuft die Komprimierung im Hintergrund über das standardmäßige Toast-System unten rechts — kein blockierendes Modal. Die Benutzeroberfläche bleibt vollständig interaktiv.

  • Laufender Toast: Zeigt "Speicherkomprimierung" mit Spinner
  • Abschluss-Toast: Zeigt "Komprimiert: XK → YK" mit Häkchen (verschwindet automatisch nach 5s)
  • Fehler-Toast: Zeigt Fehlermeldung (verschwindet automatisch nach 5s)
  • Verwendet das backgroundJobToasts-System, das mit allen anderen Hintergrundprozessen konsistent ist (Cron, Wissensextraktion usw.)

3. Automatische Komprimierung

Nach jeder Chat-Antwort (final-Ereignis) überprüft die UI die Token-Nutzung gegen den konfigurierten Schwellenwert. Wenn überschritten:

  • Hintergrundkomprimierung wird automatisch ausgelöst
  • Toast zeigt "Automatische Komprimierung (X%)" mit der aktuellen Auslastung
  • 5-Minuten-Entprellung verhindert wiederholte Auslöser
  • Chat wird nach erfolgreicher Komprimierung automatisch aktualisiert
  • Stiller Toast-Entfernung, wenn nichts komprimiert wurde

4. Gesprächszusammenfassungsabsatz

Jeder Komprimierungsoutput beginnt jetzt mit einem Abschnitt ## Gesprächszusammenfassung vor dem strukturierten Abschnitt ## Ziel. Dies ist ein Absatz in natürlicher Sprache mit 3-6 Sätzen, der:

  • Die allgemeinen Themen des Gesprächs beschreibt
  • Den Diskussionsverlauf und wichtige Übergänge erklärt
  • Zusammenfasst, wie sich das Gespräch entwickelt hat
  • Im Präteritum als erzählerischer Überblick verfasst ist

Implementierung: Benutzerdefinierte Anweisungen werden dem vorgelagerten Komprimierungs-LLM-Aufruf über compact.ts hinzugefügt. Die Anweisung wird allen vom Benutzer bereitgestellten benutzerdefinierten Anweisungen (von /compact [Anweisungen]) vorangestellt, sodass beide nebeneinander existieren.

Beispielausgabe:

## Gesprächszusammenfassung
Das Gespräch begann damit, dass der Benutzer Verbesserungen am Komprimierungssystem
anforderte, insbesondere den Wechsel von einem blockierenden Modal zu Hintergrund-Toasts.
Die Diskussion verlagerte sich dann auf das Hinzufügen eines Einstellungs-Tabs mit
Steuerelementen für die automatische Komprimierung. Nach der Implementierung und dem
Testen dieser Funktionen stellte der Benutzer fest, dass die Einstellungen beim
Navigieren zwischen Tabs nicht erhalten blieben, was zu einer Behebung des
Modulstatus-Caches führte. Schließlich forderte der Benutzer das Hinzufügen eines
erzählerischen Zusammenfassungsabsatzes zum Komprimierungsoutput für einen besseren
Kontext.

## Ziel
...

5. Einstellungs-Tab (Plugin-Registriert)

Ein dedizierter Komprimierungs-Tab unter der Navigationsgruppe Agent, registriert über die Plugin-UI-Architektur.

Registrierung: plugins-ui.ts → BUILTIN_UI_VIEWS mit id: "compaction", group: "agent", position: 7, icon: "archive"

Karten:

Karte: Automatische Komprimierung

  • Schalter: Automatische Komprimierung aktivieren/deaktivieren
  • Schieberegler für Schwellenwert: 10% bis 95% (Standard: 60%)
  • Farbcodiert: Grün (<60%), Gelb (60-85%), Rot (≥85%)

Karte: Modell

  • Dropdown: Ein bestimmtes Modell für die Komprimierung auswählen oder das Session-Standardmodell verwenden
  • Nach Anbieter gruppiert mit angezeigten Kontextfenstergrößen
  • Warnhinweis bei Auswahl eines benutzerdefinierten Modells (Erinnerung an API-Schlüssel)
  • Fallback: Wenn das benutzerdefinierte Modell fehlschlägt, automatischer Rückgriff auf das Session-Standardmodell

Karte: Ergebnis-Speicherung

  • Schalter: Opt-in zum Speichern des komprimierten Zusammenfassungstexts zur Überprüfung

Karte: Letzte Komprimierung

  • Vorher/Nachher: Große, gestaltete Token-Zahlen in einem 2-Spalten-Raster
  • Statistiken: Gespeicherte Tokens, prozentuale Reduzierung, Auslöser-Typ, Zeitstempel, Session-Schlüssel
  • Ergebnisse anzeigen: Erweiterbarer Zusammenfassungs-Viewer (wenn Speicherung aktiviert ist)
  • Löschen: Gespeichertes Ergebnis zurücksetzen
  • Hinweis: Zeigt Meldung "Ergebnisse speichern aktivieren" an, wenn die Speicherung deaktiviert ist

Zustandsverwaltung:

  • Der Modulstatus bleibt über Neudarstellungen innerhalb einer Session hinweg erhalten
  • Einstellungen werden bei jedem Besuch des Tabs vom Backend neu geladen (2-Sekunden-Veraltungsgrenze)
  • resetCompactionSettingsState() wird für Tests und Tab-Wechsel exportiert

6. Auth-Hierarchie

Die Komprimierung verwendet resolveApiKeyForProvider über getApiKeyForModel — die gleiche Authentifizierungskette wie der Chat:

OAuth → API-Key → Fallback

Keine separate Konfiguration erforderlich. Wenn OAuth (Claude Max) als primäres Authentifizierungsprofil konfiguriert ist, verwendet die Komprimierung es automatisch. Die benutzerdefinierte Modellauswahl verwendet diese gleiche Authentifizierungskette unabhängig.

7. Ergebnis-Speicherung

Wenn aktiviert, wird das letzte Komprimierungsergebnis in {agentDir}/compaction-config.json gespeichert:

{
  "settings": {
    "autoEnabled": true,
    "autoThresholdPercent": 60,
    "storeLastResult": true,
    "compactionModel": "anthropic/claude-sonnet-4-6"
  },
  "lastResult": {
    "timestamp": 1709283600000,
    "trigger": "manual",
    "tokensBefore": 50614,
    "tokensAfter": 4766,
    "tokensSaved": 45848,
    "percentReduction": 91,
    "sessionKey": "agent:main:main",
    "summary": "## Gesprächszusammenfassung\nDas Gespräch konzentrierte sich auf...\n\n## Ziel\n..."
  }
}

Wenn die Speicherung deaktiviert ist, werden Metadaten (Zeitstempel, Token-Anzahlen) weiterhin gespeichert, der Zusammenfassungstext jedoch weggelassen.

8. Chatverlaufsfilter

  • NO_REPLY/HEARTBEAT_OK-Filterung: Überspringt Assistentennachrichten mit genau diesen Texten
  • Komprimierungs-Trennzeichen: Zeigt beschriftete Trennlinie für __openclaw.kind === "compaction" Nachrichten an

Architektur

Backend-RPCs

MethodeBeschreibung
sessions.compactKomprimierung ausführen (zeichnet Ergebnis nach Abschluss auf)
compaction.getSettingsEinstellungen aus Konfigurationsdatei lesen
compaction.saveSettingsEinstellungen aktualisieren (Schwellenwert automatisch auf 10-95% begrenzt)
compaction.getLastResultGespeichertes letztes Komprimierungsergebnis abrufen
compaction.clearLastResultGespeichertes Ergebnis löschen

Geänderte Dateien

DateiZweck
src/gateway/server-methods/compaction.tsEinstellungs-RPCs, Konfigurations-I/O, Ergebnisaufzeichnung
src/gateway/server-methods/sessions.tssessions.compact RPC (zeichnet Ergebnis nach Komprimierung auf)
src/gateway/server-methods/plugins-ui.tsPlugin-Ansichtsregistrierung
src/gateway/server-methods.tsHandler-Verkabelung
src/gateway/server-methods-list.tsMethodenregistrierung
src/gateway/method-scopes.tsBereichsregistrierung
src/agents/pi-embedded-runner/compact.tsChat-Zusammenfassungsanweisungseinfügung
ui/src/ui/app-render.helpers.tsKontext-Messanzeige + Hintergrund-Toast-Auslöser
ui/src/ui/app-gateway.tsAutomatische Komprimierungsprüfung nach finalem Ereignis
ui/src/ui/views/compaction-settings.tsEinstellungs-Tab-Ansicht
ui/src/ui/app-render.tsAnsichtsverkabelung + Import
ui/src/ui/views/chat.tsChatverlaufsfilter

Konfigurationsdatei

{agentDir}/compaction-config.json — pro Agent, wird beim ersten Speichern der Einstellungen erstellt.

Plugin-Registrierung

Der Komprimierungs-Tab wird als integrierte Plugin-Ansicht in plugins-ui.ts registriert:

{
  id: "compaction",
  label: "Komprimierung",
  subtitle: "Speicherverwaltung",
  icon: "archive",
  group: "agent",
  position: 7,
  pluginId: "compaction-ui",
}

Bekannte Fallstricke

  • Einstellungen bleiben beim Tab-Wechsel nicht erhalten: Behoben in v2.1.0. Das modulweite _state.loaded-Flag verhinderte das Neuladen. Jetzt erfolgt ein Neuladen alle 2 Sekunden beim erneuten Betreten des Tabs.
  • Modellauswahl erfordert API-Schlüssel: Wenn Sie ein benutzerdefiniertes Modell auswählen, stellen Sie sicher, dass der API-Schlüssel des Anbieters konfiguriert ist. Die UI zeigt einen Warnhinweis an.
  • Komprimierungsmodellformat: Muss das Format "Anbieter/Modell" sein (z.B. "anthropic/claude-sonnet-4-6"). Ungültige Formate werden stillschweigend ignoriert und fallen auf das Session-Standardmodell zurück.
  • parentId-Skipset-Weitergabe muss nachrichtenbasiert sein: Beim Filtern von Speicherlöschungsnachrichten aus readSessionMessages darf das Skipset NUR über Einträge mit einem message-Feld weitergegeben werden. Nicht-Nachrichten-Protokolleinträge (type:"custom") überbrücken logische Gesprächswechsel – wenn ihre IDs in das Skipset gelangen, wird der gesamte restliche Gesprächsverlauf ausgeblendet. Die Lösung: Nur parsed?.message-Einträge gegen das Skipset prüfen und nur deren IDs hinzufügen.
  • Kein blockierendes Modal – nie: Der Messanzeige-Button in app-render.helpers.ts darf NIEMALS ein Vollbild-Overlay-Modal rendern. Die Komprimierung ist ein Hintergrundprozess; der gesamte Status wird über das Toast-System unten rechts kommuniziert. Entfernen Sie jegliches position:fixed; inset:0 Overlay, das von compactState.phase abhängt. Der Button kann während der Ausführung ein Spinner-Symbol anzeigen, darf aber die UI nicht blockieren.

Änderungsprotokoll

v2.1.0

  • Gesprächszusammenfassungsabsatz: Der Komprimierungsoutput beginnt jetzt mit einem erzählerischen Absatz ## Gesprächszusammenfassung vor den strukturierten Abschnitten
  • Modellauswahl: Wählen Sie ein bestimmtes Modell für die Komprimierung oder verwenden Sie das Session-Standardmodell, mit nach Anbieter gruppiertem Dropdown
  • Einstellungs-Neuladefix: Der Tab lädt jetzt alle 2 Sekunden Einstellungen vom Backend neu, anstatt sie dauerhaft zu cachen
  • Referenzdateien aktualisiert: references/ mit aktueller Quelle synchronisiert

v2.0.0

  • Hintergrundkomprimierung: Blockierendes Vollbild-Modal durch Hintergrund-Job-Toast ersetzt
  • Automatische Komprimierung: Wird nach Chat-Antwort ausgelöst, wenn die Token-Nutzung den Schwellenwert überschreitet (konfigurierbar, Standard 60%, 5-Minuten-Entprellung)
  • Einstellungs-Tab: Plugin-registrierter Komprimierungs-Tab unter der Agent-Navigationsgruppe
  • Ergebnisaufzeichnung: sessions.compact zeichnet Token-Anzahlen vorher/nachher und optionale Zusammenfassung auf
  • Auth-Hierarchie: Gleiche OAuth → API → Fallback-Kette wie der Chat
  • Einstellungs-RPCs: compaction.getSettings, compaction.saveSettings, compaction.getLastResult, compaction.clearLastResult

v1.0.0

  • Erstveröffentlichung: Kontext-Messanzeige-Button, blockierendes Modal mit animierten Phasen, sessions.compact RPC mit LLM-Zusammenfassung, Chatverlaufsfilterung NO_REPLY/HEARTBEAT_OK, Komprimierungs-Trennlinien

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Verwandte Skills