kitorz/token-step-tracker

Alertes de tokens – Pas pour les Vierges

Suivez l'utilisation approximative des tokens sans interrompre la tâche ni prétendre à une précision de facturation.

Commencer le suivi

1. Découpez la tâche en étapes significatives basées sur des résultats. Conservez le plan existant s'il y en a un.
2. Indiquez une fois que les chiffres des tokens sont des estimations et excluent les frais cachés du système, du raisonnement et de la plateforme.
3. Lisez un intervalle d'alerte entier positif depuis la demande de l'utilisateur, par exemple 5000 dans « alerte tous les 5000 tokens ». Utilisez 10000 lorsque l'utilisateur demande des alertes sans préciser d'intervalle. Indiquez l'intervalle actif une fois.
4. Définissez le seuil d'alerte suivant à un intervalle et avancez-le d'un intervalle après chaque alerte.
5. N'effectuez pas d'appels d'outils supplémentaires, ne relisez pas de fichiers et ne générez pas de contenu supplémentaire uniquement pour améliorer une estimation.

Signaler chaque étape terminée

Ajoutez ce point de contrôle compact après avoir rapporté le résultat utile de l'étape :

Point de contrôle Token · Étape {n} : {nom}
Cette étape : ≈{bas}–{haut} tokens | Cumul : ≈{bas}–{haut}
Principal moteur : {plus grande source observable}
Économie suivante : {une suggestion actionnable ou « Aucun changement pertinent — conservez l'approche actuelle. »}

Comptez une étape uniquement lorsqu'elle produit un résultat significatif. Ne créez pas de points de contrôle pour les messages de statut, les approbations, les attentes ou les actions internes triviales.

Afficher les alertes de seuil

Après chaque point de contrôle, comparez le milieu de la plage cumulée avec le seuil d'alerte suivant. Lorsqu'il atteint ou dépasse le seuil, ajoutez :

> :red_circle: ALERTE TOKEN | **{seuil} tokens estimés utilisés**

Utilisez un cercle rouge plus des chiffres en gras comme solution de repli portable. Si l'hôte prend en charge les couleurs HTML sécurisées en ligne, affichez la valeur sous la forme <span style="color:#d00"><strong>{seuil}</strong></span> ; n'émettez jamais de codes d'échappement de terminal bruts. Une compétence pure ne peut pas créer une notification système ni garantir la couleur du texte, appelez donc cela une alerte, pas une popup système.

Si une étape franchit plusieurs seuils, émettez une alerte pour le seuil le plus élevé franchi et avancez le seuil suivant au-delà du milieu cumulé. Ne répétez jamais un seuil déjà émis.

Estimer de manière cohérente

Estimez à partir du contenu observable traité ou produit pendant l'étape :

• Prose anglaise : environ 1 token pour 4 caractères.
• Prose chinoise : environ 1 token pour 1,5–2 caractères.
• Code et données structurées : environ 1 token pour 3 caractères.
• Incluez le texte d'invite pertinent, la sortie d'outil nouvellement lue, le contenu généré et le contexte visiblement réutilisé pour l'étape.
• Évitez de compter deux fois le même artefact au sein d'une étape.
• Utilisez une plage d'au moins ±25 % ; élargissez-la lorsque la réutilisation du contexte est floue.
• Arrondissez les bornes à des valeurs raisonnables. Préférez ≈800–1 200, pas ≈917–1 143.
• Ajoutez les plages des étapes pour maintenir la plage cumulée.

N'inférez jamais les tokens de raisonnement cachés, les instructions de la plateforme, le comportement du cache, la facturation ou le coût monétaire. Si l'exécution fournit explicitement l'utilisation, rapportez-la séparément comme utilisation exacte de l'exécution plutôt que de la mélanger à l'estimation.

Recommander des économies

Donnez au maximum une recommandation par point de contrôle. Ciblez le coût évitable observable le plus important :

• Grandes lectures de fichiers : recherchez d'abord, puis lisez uniquement les sections correspondantes.
• Lectures ou recherches répétées : réutilisez le résultat déjà obtenu.
• Sortie d'outil large : réduisez les chemins, champs, plages de dates ou nombres de résultats.
• Contexte surdimensionné : résumez les résultats stables avant de continuer.
• Long résultat généré : demandez ou produisez un format plus concis lorsque les détails ne sont pas nécessaires.
• Échecs répétés : inspectez l'erreur et changez d'approche avant de réessayer.
• Exemples excessifs : conservez un exemple représentatif à moins qu'une comparaison ne soit nécessaire.

Ne recommandez pas de sauter la validation, les contrôles de sécurité, les preuves requises ou les détails demandés par l'utilisateur uniquement pour réduire les tokens. Si aucune économie significative n'existe, dites-le au lieu d'inventer un conseil.

Terminer le suivi

Incluez un court résumé après le résultat final de la tâche :

Résumé de l'estimation des tokens
Étapes : {nombre} | Total : ≈{bas}–{haut} tokens
Plus grande étape : {nom de l'étape} (≈{bas}–{haut})
Intervalle d'alerte : {intervalle} tokens | Alertes émises : {nombre}
Meilleure économie pour la prochaine exécution : {suggestion au plus fort impact}
Précision : Estimation uniquement ; exclut les frais cachés du système, du raisonnement, du cache et de la plateforme.

Gardez les points de contrôle et le résumé secondaires par rapport à la tâche réelle de l'utilisateur.