Communitygithub.com

ComeOnOliver/skillshub

Système de compactage mémoire pour l'interface OpenClaw Control UI — exécution en arrière-plan avec notifications toast, déclenchement automatique à des seuils de tokens configurables, paragraphe de résumé de conversation dans la sortie compactée, onglet de paramètres dédié avec sélecteur de modèle et historique des résultats.

Qu'est-ce que skillshub ?

Compaction UI v2.1.0 est un système de compactage mémoire conçu pour l'interface OpenClaw Control UI. Il permet de réduire la consommation de tokens des conversations en arrière-plan, sans bloquer l'interface utilisateur, grâce à des notifications toast. Le déclenchement automatique s'active après chaque réponse de chat lorsque l'utilisation des tokens dépasse un seuil configurable (par défaut 60%), avec un délai de 5 minutes entre les déclenchements. Le système injecte un paragraphe de résumé narratif en langage naturel avant la sortie structurée, améliorant ainsi le contexte des compactions. Il inclut un onglet de paramètres dédié avec un sélecteur de modèle, une gestion de l'authentification via OAuth / clé API / fallback, un stockage des résultats avec visualisation et des filtres d'historique de chat. Il est compatible avec les agents OpenClaw et s'intègre via l'architecture Plugin UI.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compaction UI v2.1.0

Système de compactage mémoire pour l'interface OpenClaw Control UI — exécution en arrière-plan avec notifications toast, déclenchement automatique à des seuils de tokens configurables, paragraphe de résumé de conversation dans la sortie compactée, onglet de paramètres dédié avec sélecteur de modèle et historique des résultats.

Statut : ✅ Actif

ComposantStatut
Bouton Jauge de Contexte✅ Fonctionnel
Compactage en Arrière-plan (toast)✅ Fonctionnel
Déclenchement Automatique✅ Fonctionnel
Paragraphe de Résumé de Conversation✅ Fonctionnel
Onglet Paramètres (enregistré via plugin)✅ Fonctionnel
Sélecteur de Modèle✅ Fonctionnel
Stockage et Visualisation du Dernier Résultat✅ Fonctionnel
Persistance et Rechargement des Paramètres✅ Fonctionnel
Hiérarchie d'Authentification (OAuth > API > Fallback)✅ Fonctionnel
Filtres d'Historique de Chat✅ Fonctionnel
Isolation Complète en Arrière-plan (sans interférence avec le chat)✅ Fonctionnel

Fonctionnalités

1. Bouton Jauge de Contexte (app-render.helpers.ts)

Un anneau de progression SVG circulaire dans la barre d'outils du chat qui sert également de déclencheur manuel de compactage.

  • Emplacement : Après le menu déroulant de sélection de session dans renderChatControls()
  • Source de données : sessionsResult.sessions[].totalTokens et contextTokens des lignes de session
  • Couleurs : Vert (<60%), Jaune (60-85%), Rouge (≥85%)
  • Désactivé : Lorsque l'utilisation est <20% ou pendant un compactage actif
  • Info-bulle : Affiche "Contexte : XK / YK tokens (Z%)"

2. Compactage en Arrière-plan (Toast)

Au clic (ou déclenchement automatique), le compactage s'exécute en arrière-plan en utilisant le système de toast standard en bas à droite — aucune modale bloquante. L'interface utilisateur reste entièrement interactive.

  • Toast d'exécution : Affiche "Compactage mémoire" avec un spinner
  • Toast de fin : Affiche "Compacté : XK → YK" avec une coche (se ferme automatiquement après 5s)
  • Toast d'erreur : Affiche un message d'échec (se ferme automatiquement après 5s)
  • Utilise le système backgroundJobToasts cohérent avec tous les autres processus en arrière-plan (cron, extraction de connaissances, etc.)

3. Compactage Automatique

Après chaque réponse de chat (événement final), l'interface vérifie l'utilisation des tokens par rapport au seuil configuré. Si dépassé :

  • Le compactage en arrière-plan se déclenche automatiquement
  • Un toast affiche "Auto-compactage (X%)" avec l'utilisation actuelle
  • Un délai de 5 minutes empêche les déclenchements répétés
  • Le chat se rafraîchit automatiquement après un compactage réussi
  • Suppression silencieuse du toast si rien n'a été compacté

4. Paragraphe de Résumé de Conversation

Chaque sortie de compactage commence désormais par une section ## Résumé de la Conversation avant la section structurée ## Objectif. Il s'agit d'un paragraphe de 3 à 6 phrases en langage naturel qui :

  • Décrit le(s) sujet(s) général(aux) de la conversation
  • Explique le déroulement de la discussion et les transitions clés
  • Résume comment la conversation a progressé
  • Rédigé au passé comme un aperçu narratif

Implémentation : Des instructions personnalisées sont injectées dans l'appel LLM de compactage en amont via compact.ts. L'instruction est ajoutée avant toutes instructions personnalisées fournies par l'utilisateur (via /compact [instructions]), afin que les deux coexistent.

Exemple de sortie :

## Résumé de la Conversation
La conversation a commencé avec l'utilisateur demandant des améliorations du système
 de compactage, en particulier le passage d'une modale bloquante à des toasts en arrière-plan.
La discussion s'est ensuite orientée vers l'ajout d'un onglet de paramètres avec des
 commandes de compactage automatique. Après avoir implémenté et testé ces fonctionnalités,
 l'utilisateur a remarqué que les paramètres ne persistaient pas lors des navigations entre
 les onglets, ce qui a conduit à une correction du cache d'état au niveau du module.
 Enfin, l'utilisateur a demandé l'ajout d'un paragraphe de résumé narratif à la sortie
 du compactage pour un meilleur contexte.

## Objectif
...

5. Onglet Paramètres (Enregistré via Plugin)

Un onglet Compaction dédié sous le groupe de navigation Agent, enregistré via l'architecture Plugin UI.

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

Cartes :

Carte d'Auto-compactage

  • Interrupteur : Activer/désactiver le compactage automatique
  • Curseur de seuil : 10% à 95% (par défaut : 60%)
  • Codage couleur : Vert (<60%), Jaune (60-85%), Rouge (≥85%)

Carte du Modèle

  • Menu déroulant : Sélectionner un modèle spécifique pour le compactage ou utiliser le modèle par défaut de la session
  • Regroupé par fournisseur avec affichage de la taille de la fenêtre de contexte
  • Avertissement lorsqu'un modèle personnalisé est sélectionné (rappel de la clé API)
  • Repli : Si le modèle personnalisé échoue, retombe automatiquement sur le modèle par défaut de la session

Carte de Stockage des Résultats

  • Interrupteur : Option pour enregistrer le texte du résumé compacté pour révision

Carte du Dernier Compactage

  • Avant/Après : Grands compteurs de tokens stylisés dans une grille à 2 colonnes
  • Statistiques : Tokens sauvegardés, pourcentage de réduction, type de déclencheur, horodatage, clé de session
  • Voir les Résultats : Visualiseur de résumé extensible (lorsque le stockage est activé)
  • Effacer : Réinitialiser le résultat stocké
  • Astuce : Affiche le message "Activer le stockage des résultats" lorsque le stockage est désactivé

Gestion d'État :

  • L'état au niveau du module persiste entre les rendus au sein d'une session
  • Les paramètres sont rechargés depuis le backend à chaque visite de l'onglet (seuil d'obsolescence de 2 secondes)
  • resetCompactionSettingsState() est exportée pour les tests et les changements d'onglet

6. Hiérarchie d'Authentification

Le compactage utilise resolveApiKeyForProvider via getApiKeyForModel — la même chaîne d'authentification que le chat :

OAuth → Clé API → Repli

Aucune configuration distincte nécessaire. Si OAuth (Claude Max) est configuré comme profil d'authentification principal, le compactage l'utilise automatiquement. La sélection de modèle personnalisé utilise cette même chaîne d'authentification de manière indépendante.

7. Stockage des Résultats

Lorsqu'il est activé, le résultat de compactage le plus récent est persistant dans {agentDir}/compaction-config.json :

{
  "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": "## Résumé de la Conversation\nLa conversation a porté sur...\n\n## Objectif\n..."
  }
}

Lorsque le stockage est désactivé, les métadonnées (horodatages, compteurs de tokens) sont toujours sauvegardées mais le texte du résumé est omis.

8. Filtres d'Historique de Chat

  • Filtrage NO_REPLY/HEARTBEAT_OK : Ignore les messages d'assistant contenant exactement ces textes
  • Séparateur de compactage : Affiche une ligne de séparation étiquetée pour les messages __openclaw.kind === "compaction"

Architecture

RPCs Backend

MéthodeDescription
sessions.compactExécute le compactage (enregistre le résultat après la fin)
compaction.getSettingsLit les paramètres depuis le fichier de configuration
compaction.saveSettingsMet à jour les paramètres (seuil automatiquement limité à 10-95%)
compaction.getLastResultRécupère le dernier résultat de compactage stocké
compaction.clearLastResultEfface le résultat stocké

Fichiers Modifiés

FichierObjectif
src/gateway/server-methods/compaction.tsRPCs de paramètres, E/S de configuration, enregistrement des résultats
src/gateway/server-methods/sessions.tssessions.compact RPC (enregistre le résultat après compactage)
src/gateway/server-methods/plugins-ui.tsEnregistrement de la vue du plugin
src/gateway/server-methods.tsCâblage des gestionnaires
src/gateway/server-methods-list.tsEnregistrement des méthodes
src/gateway/method-scopes.tsEnregistrement des portées
src/agents/pi-embedded-runner/compact.tsInjection d'instructions de résumé de chat
ui/src/ui/app-render.helpers.tsJauge de contexte + déclencheur de toast en arrière-plan
ui/src/ui/app-gateway.tsVérification d'auto-compactage après l'événement final
ui/src/ui/views/compaction-settings.tsVue de l'onglet paramètres
ui/src/ui/app-render.tsCâblage des vues + import
ui/src/ui/views/chat.tsFiltres d'historique de chat

Fichier de Configuration

{agentDir}/compaction-config.json — par agent, créé lors de la première sauvegarde des paramètres.

Enregistrement du Plugin

L'onglet de compactage est enregistré comme une vue de plugin intégrée dans plugins-ui.ts :

{
  id: "compaction",
  label: "Compactage",
  subtitle: "Gestion de la mémoire",
  icon: "archive",
  group: "agent",
  position: 7,
  pluginId: "compaction-ui",
}

Problèmes Connus

  • Les paramètres ne persistent pas lors des visites d'onglets : Corrigé dans la v2.1.0. Le drapeau _state.loaded au niveau du module empêchait les rechargements. Maintenant, les paramètres sont rechargés toutes les 2 secondes lors de la réentrée dans l'onglet.
  • Le sélecteur de modèle nécessite des clés API : Si vous sélectionnez un modèle personnalisé, assurez-vous que la clé API du fournisseur est configurée. L'interface affiche un avertissement.
  • Format du modèle de compactage : Doit être au format "fournisseur/modèle" (par exemple "anthropic/claude-sonnet-4-6"). Les formats invalides sont ignorés silencieusement et reviennent au modèle par défaut de la session.
  • La propagation du skip-set parentId doit être limitée aux messages : Lors du filtrage des messages de vidage mémoire de readSessionMessages, le skip-set doit UNIQUEMENT se propager à travers les entrées avec un champ message. Les entrées de protocole non-message (type:"custom") font le pont entre les tours logiques — si leurs ID entrent dans le skip-set, la conversation restante entière devient cachée. La correction : vérifier uniquement les entrées parsed?.message dans le skip-set, et n'ajouter leurs ID que si nécessaire.
  • Aucune modale bloquante — jamais : Le bouton de jauge dans app-render.helpers.ts ne doit JAMAIS afficher une superposition modale plein écran. Le compactage est un processus en arrière-plan ; tout statut est communiqué via le système de toast en bas à droite. Supprimez toute superposition conditionnée par position:fixed; inset:0 sur compactState.phase. Le bouton peut afficher une icône de spinner pendant l'exécution, mais ne doit pas bloquer l'interface.

Journal des Modifications

v2.1.0

  • Paragraphe de résumé de conversation : La sortie de compactage commence désormais par un paragraphe narratif ## Résumé de la Conversation avant les sections structurées
  • Sélecteur de modèle : Choisir un modèle spécifique pour le compactage ou utiliser le modèle par défaut de la session, avec un menu déroulant regroupé par fournisseur
  • Correction du rechargement des paramètres : L'onglet recharge désormais les paramètres depuis le backend toutes les 2 secondes au lieu de les mettre en cache indéfiniment
  • Fichiers de référence mis à jour : references/ synchronisé avec la source actuelle

v2.0.0

  • Compactage en arrière-plan : Remplacement de la modale bloquante plein écran par un toast de tâche en arrière-plan
  • Auto-compactage : Déclenchement après une réponse de chat lorsque l'utilisation des tokens dépasse le seuil (configurable, par défaut 60%, délai de 5 minutes)
  • Onglet paramètres : Onglet Compactage enregistré via plugin sous le groupe de navigation Agent
  • Enregistrement des résultats : sessions.compact enregistre les compteurs de tokens avant/après et un résumé optionnel
  • Hiérarchie d'authentification : Même chaîne OAuth → API → Repli que pour le chat
  • RPCs de paramètres : compaction.getSettings, compaction.saveSettings, compaction.getLastResult, compaction.clearLastResult

v1.0.0

  • Première version : Bouton jauge de contexte, modale bloquante avec phases animées, sessions.compact RPC avec résumé LLM, filtrage d'historique de chat NO_REPLY/HEARTBEAT_OK, lignes de séparation de compactage

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

Skills associés