cpa-usage-keeper : analyse pratique de Willxup/cpa-usage-keeper
Suivi d'utilisation autonome de CliProxyAPI avec persistance SQLite et tableau de bord intégré.
En bref
- De quoi s’agit-il ?
- Standalone CliProxyAPI usage tracker with SQLite persistence and built-in dashboard. Cette analyse s'en tient aux usages et limites décrits par le dépôt.
- À qui s’adresse-t-il ?
- Pour vérifier cpa-usage-keeper, partez du README de Willxup/cpa-usage-keeper et reprenez exactement la commande d'installation ou l'exemple qu'il donne. Utilisez une entrée de test contrôlée, notez la sortie, le code de retour et les fichiers touchés, puis répétez le cas après redémarrage.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 1 jour.
- En quel langage est-il écrit ?
- Principalement Go, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un tableau de bord qui persiste l'utilisation de CLIProxyAPI
CPA Usage Keeper est une application Go autonome qui se connecte à une instance CLIProxyAPI (CPA) et stocke les données d'utilisation dans SQLite. Il récupère la configuration et les identifiants de CPA, puis expose un tableau de bord Web pour l'utilisation, les coûts, la santé des requêtes, les quotas et les statistiques de modèles/API. Le dépôt comprend un frontend React et TypeScript sous web/ et un backend Go sous cmd/server et internal/. Le README décrit le projet avec le slogan « Every flow leaves a trace », ce qui correspond à son rôle d'enregistrement persistant de l'activité CPA.
Ce que le tableau de bord suit et affiche
Selon le README, le suivi enregistre les requêtes, les jetons, les coûts, l'utilisation du cache, le taux de réussite, RPM/TPM et la latence, avec des filtres pour la plage de temps, le modèle, la clé API, la source et le résultat. Il prend également en charge l'inspection et l'exportation d'événements au niveau des requêtes avec des colonnes de tableau configurables. Les vues d'analyse couvrent les tendances d'utilisation, la composition des coûts, le mélange modèles/clés API/ fournisseurs d'IA, les cartes thermiques horaires et les diagnostics de latence. Il existe une section de surveillance pour Auth Files et AI Providers, incluant l'inspection de santé et l'actualisation des quotas. En option, les utilisateurs peuvent participer à des classements communautaires par score, jetons, requêtes, taux de cache, TTFT/latence moyenne ou TPM/RPM maximal.
Options de déploiement et chemin recommandé
Docker Compose est la méthode de déploiement recommandée. Le dépôt fournit des modèles pour une pile complète exécutant CPA et Keeper ensemble, et une pile Keeper uniquement lorsque CPA existe déjà. Les deux prennent en charge linux/amd64 et linux/arm64. Pour les déploiements CPA existants préférant Docker CLI, un exemple docker run est donné. Sur macOS, Homebrew est recommandé avec un tap et un service. Les binaires Linux pour amd64 et arm64 sont disponibles dans Releases, et un modèle de service systemd est inclus. Les binaires Windows pour amd64 et arm64 sont également fournis. La protection de connexion est activée par défaut, donc LOGIN_PASSWORD doit être défini avant le démarrage.
Variables de configuration clés
Deux variables sont requises : CPA_BASE_URL, l'adresse CPA côté serveur, et CPA_MANAGEMENT_KEY, utilisée pour lire les API de gestion CPA. Pour l'accès Web, APP_HOST et APP_PORT contrôlent l'adresse d'écoute et le port (défaut 8080), et APP_BASE_PATH permet un préfixe de sous-chemin. CPA_PUBLIC_URL définit l'URL CPA publique pour le lien de retour et la confiance du cadre CPAMC. La protection de connexion utilise AUTH_ENABLED (défaut true), LOGIN_PASSWORD et AUTH_SESSION_TTL. Le fuseau horaire et le comportement des requêtes sont définis avec TZ, REQUEST_TIMEOUT et TLS_SKIP_VERIFY. Les paramètres de stockage et de sauvegarde incluent WORK_DIR, LOG_LEVEL, BACKUP_ENABLED, BACKUP_INTERVAL et BACKUP_RETENTION_DAYS. Le README indique que la plupart des autres paramètres peuvent conserver leurs valeurs par défaut.
Notes sur la sécurité et le traitement des données
Le README note que les API du navigateur masquent les champs de type clé, mais la base de données SQLite et ses sauvegardes non chiffrées contiennent les données originales. L'authentification est activée par défaut ; si elle est explicitement désactivée, l'accès doit être restreint à la limite de déploiement, et le HTTPS public doit être terminé à un proxy inverse. Les hachages de session de connexion persistent dans SQLite jusqu'à la déconnexion ou l'expiration du TTL. Pour l'intégration CPAMC, une session d'intégration séparée est utilisée. Les messages de boîte de réception Redis sont conservés jusqu'au jour courant après succès ou pendant 7 jours après échec. Pendant la maintenance quotidienne, les usage_events bruts de plus de 90 jours calendaires locaux sont déplacés vers la table froide usage_events_archive conservée en permanence.
Licence · willxup cpa usage keeper
Le projet est sous licence MIT, avec les droits d'auteur attribués à Will (2026). La licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, à condition d'inclure l'avis de droit d'auteur et l'avis de permission. Le logiciel est fourni « tel quel », sans garantie d'aucune sorte, expresse ou implicite. Le README ne contient aucune garantie supplémentaire ni engagement de support.
Essai concret avec cpa-usage-keeper
Pour vérifier cpa-usage-keeper, partez du README de Willxup/cpa-usage-keeper et reprenez exactement la commande d'installation ou l'exemple qu'il donne. Utilisez une entrée de test contrôlée, notez la sortie, le code de retour et les fichiers touchés, puis répétez le cas après redémarrage. Cette trace permet de distinguer une capacité documentée d'une hypothèse. Le matériau ne précise pas les comportements que le README ne décrit pas, notamment la couverture complète, les performances sur de gros volumes et la compatibilité avec toutes les versions. Ces points doivent rester ouverts avant une intégration dans un produit. Pour une équipe, examinez aussi la licence MIT et les fichiers de configuration réellement présents dans Willxup/cpa-usage-keeper.
Conclusion éditoriale
Pour vérifier cpa-usage-keeper, partez du README de Willxup/cpa-usage-keeper et reprenez exactement la commande d'installation ou l'exemple qu'il donne. Utilisez une entrée de test contrôlée, notez la sortie, le code de retour et les fichiers touchés, puis répétez le cas après redémarrage. Cette trace permet de distinguer une capacité documentée d'une hypothèse. Le matériau ne précise pas les comportements que le README ne décrit pas, notamment la couverture complète, les performances sur de gros volumes et la compatibilité avec toutes les versions. Ces points doivent rester ouverts avant une intégration dans un produit. Pour une équipe, examinez aussi la licence MIT et les fichiers de configuration réellement présents dans Willxup/cpa-usage-keeper. cpa-usage-keeper s'adresse aux lecteurs dont le besoin correspond à ce périmètre et qui peuvent effectuer cet essai sur leur environnement. Il ne convient pas à une décision fondée sur des garanties que le README ne formule pas.
Notes de la communauté