---
tags: [note, OpenCode]
projects: [VPS-IA, [[03_PROJETS/VPS-IA]]]
date: 2026-11-02
description: "Compaction repositionnée à ~700k tokens (buffer 30 %, keep 20 000) au lieu de 890k."
nature: documentation
type: note
---

# Compaction OpenCode — réglage contexte

## Constat

- Aucun bloc `compaction` configuré → défauts V2 actifs : `auto: true`, `keep.tokens: 15000`, `buffer: "15%"`.
- Modèles utilisés (OpenRouter) : fenêtres ~1M tokens (`deepseek/deepseek-v4-flash-0731` = 1 048 576 ; `xiaomi/mimo-v2.6-flash` = 1 050 000).
- Avec `buffer: 15%`, la compaction ne se déclenche qu'à ~890k tokens → historique long, coût par tour plus élevé, risque de rejet (budget d'entrée utilisable < fenêtre annoncée).
- Contexte rarement au-delà de 500k tokens (constat de GRK).

## Décision

Réglage global posé dans `~/.config/opencode/opencode.json` (HOME `/var/lib/opencode`) :

```jsonc
"compaction": {
  "auto": true,
  "buffer": "30%",
  "keep": { "tokens": 20000 }
}
```

- `buffer: 30%` → compaction à ~700k tokens (au lieu de ~890k) : historique plus court, coût par tour réduit, moins de confusion du modèle.
- `keep.tokens: 20000` → queue récente conservée à côté du résumé (défaut 15000) pour garder les détails exacts (sorties de commandes, éléments de mémoire).
- JSON validé ; rechargement automatique par le service OpenCode (pas de redémarrage).

## Non retenu pour l'instant

- `experimental.background_compaction` (écrit le résumé en arrière-plan, expérimental).
- `memory-vps-admin.md` laissé tel quel (87 % de son budget) — consolidation différée à la demande de GRK.

## Référence

Doc V2 : https://opencode.ai/v2/docs/compaction