Aller au contenu

Soumettre un résultat

Ajoutez votre machine au classement.

Une mesure, un fichier JSON, une pull request vers la branche dev. Pendant les tests, la machine doit rester au repos.

FICHIER
1 JSON
LICENCE
CC0-1.0
VALIDATION
CI

Cinq étapes

  1. Installer la dernière version

    La validation exige un export de hwbench 0.8.1, noté contre la référence actuelle, avec des tests à leur version courante.

    pipx install hwbench        # ou : pipx upgrade hwbench
  2. Mesurer dans de bonnes conditions

    Sur secteur, profil d'énergie « performance », navigateur et autres programmes fermés, depuis la session graphique pour les tests GPU. Installez sysbench, glmark2 et vkmark si possible : le score GPU, et donc le score combiné, ne sont classés qu'avec les mêmes outils que la machine de référence.

  3. Exporter dans un clone de votre fork

    Forkez le dépôt sur GitHub, clonez votre fork, puis exportez. <nom> : minuscules, chiffres et tirets (mon-desktop, latitude-5420). Il apparaît publiquement dans l'adresse de la page de la machine : n'y mettez pas votre nom si vous ne souhaitez pas qu'il soit publié.

    hwbench export -o results/<nom>.json
  4. Vérifier avant d'envoyer

    Depuis le clone, avec hwbench installé en mode développement (pip install -e .). Vous pouvez aussi déposer le fichier ci-dessous pour un premier contrôle dans le navigateur.

    python -m hwbench.leaderboard validate results/<nom>.json
  5. Ouvrir la pull request vers dev

    Avec un message de commit conventionnel. La CI (workflow results.yml) valide le fichier : schéma d'export connu, aucun identifiant, référence actuelle et non forcée, versions des tests à jour, points cohérents avec les résultats bruts. Une fois la pull request fusionnée, la machine apparaît sur le site à la release suivante.

    git add results/<nom>.json && git commit -m "chore(results): add <nom>"

Guide de contribution complet ↗

Vérification locale

Contrôlez votre fichier avant la pull request.

Le fichier est lu dans votre navigateur : il n'est envoyé nulle part.

Le contrôle dans le navigateur demande JavaScript ; la commande de l'étape 4 fait la même vérification, et davantage.

Questions fréquentes

Quelles données sont publiées ?

Les composants sans aucun identifiant (CPU, GPU, carte mère, disques, RAM, capteurs), les résultats bruts de chaque run, les versions des outils et les conditions de mesure. Numéros de série, UUID, adresses MAC, nom d'hôte et asset tags ne sont jamais collectés dans un export, et la validation refuse tout fichier qui en contiendrait.

Sous quelle licence ?

Les fichiers de résultats sont publiés sous CC0-1.0 (domaine public). Le code de hwbench reste sous AGPL-3.0-or-later.

Mon résultat est marqué « À vérifier ».

Au moins un test a un coefficient de variation supérieur à 5 % : ses runs étaient trop dispersés. Fermez les programmes en arrière-plan, branchez le secteur et relancez la mesure.

Comment retirer mon résultat ?

Ouvrez une pull request qui supprime results/<nom>.json, ou écrivez à l'adresse indiquée dans les mentions légales. Le fichier est retiré du dépôt et du site au déploiement suivant.