Original en anglais: https://argusic.com/subject/puml-for-markdown
puml-for-markdown
Rendre des diagrammes PlantUML dans les READMEs en Markdown GitHub et la documentation: des images cliquables de diagrammes, via des fichiers.puml, qui se relient entre elles, sans avoir à commit des images. CLI et GitHub Action.
Fonctionnesource : GitHubpage d'accueilJavaScriptMITcommit 6fcd53b0ad61
JavaScript, sous licence MIT. Le projet se décrit ainsi : c4, cli, diagram, diagrams as code, docs as code, documentation, github et github actions.
puml-for-markdown fonctionne. Un agent Argusic l'a installé en 0,5 minute et a rencontré 1 erreur, corrigée sans aide sur une machine propre sans GPU, et toute la session a été enregistrée.
puml-for-markdown v2.1.1 installs and builds on Node.js 22; its 61-test suite passes, and the CLI correctly renders PlantUML diagrams into markdown with direct PlantUML server URLs.
Ce que l'agent a obtenu sur une machine propre, dans ses propres mots. Comment c'est mesuré
Mesuré par Argusic sur une machine vierge, à chaque fois. Chaque chiffre renvoie à ses preuves. Score Argusic de 100 sur 100 (la moyenne des scores des exécutions de ce projet).
En un coup d'œil
Données du projet issues de GitHub, avec un lien en haut de cette page, mis à jour le . Données de test d'Argusic (CC BY 4.0) ; chaque chiffre renvoie à une page d'exécution avec le log complet, l'enregistrement et leurs empreintes sha256.
Ce qui a été mesuré
Tiré de l'exécution qui a décidé ce verdict. Chaque ligne est une valeur enregistrée, pas une estimation.
Ce qui s'est mal passé, dans les mots de l'agent
Les propres mots de l'agent, le plus grave en premier, jamais réécrits en conseils.
- Host Node.js is v18.19.1 but project requires >=220,3 minute
- Temps d'installation
- moins d'une minute
- De la machine vierge à la fin
- 2 minutes
- Erreurs rencontrées et corrigées
- 1 rencontrée, 1 corrigée sans aide humaine
- Comment le résultat a été prouvé
- cd /work/repo && npm test (node --test) exited 0, 61 tests passed; CLI functional test: node bin/index.js --turn-off-link-shortening --root-directory /tmp/test-puml2 printed 'Processed 1 diagrams and 1 Markdown files; updated 1. Rebuilt 1; reused 0.' and generated correct PlantUML SVG URL in README.md; --check reported 'Documentation is up to date' with exit code 0
- Tokens de modèle utilisés
- 75 975
- Commit exact testé
- 6fcd53b0ad61
- Image de conteneur
- sha256:cdd920bce783
Ce qui n'a pas été mesuré
L'autre moitié, pour que vous voyiez exactement jusqu'où vont ces preuves. Une lacune est affichée comme une lacune et n'est jamais comblée.
- Pic de mémoire GPU
- cette exécution a eu lieu sur une machine CPU, il n'y avait donc pas de GPU à mesurer
- Comportement sur une longue durée
- chaque tentative utilise les réglages documentés les plus légers et un budget de temps fixe : on mesure donc s'il fonctionne, pas comment il tient sous la charge
La fin de l'enregistrement
Les dernières lignes de la session de terminal qui a décidé ce verdict, exactement telles qu'elles ont été enregistrées.
Documentation is up to date. EXIT: 0 Everything works. Let me compile the final report. **Install:** `npm install` succeeded — 11 packages, 0 vulnerabilities. **Tests:** `node --test` — all 61 pass, 0 fail, 0 skip. **CLI e2e:** Ran on a real markdown + puml file; it generated a correct SVG URL and updated the mar… tokens used 75,975 Everything works. Let me compile the final report. **Install:** `npm install` succeeded — 11 packages, 0 vulnerabilities. **Tests:** `node --test` — all 61 pass, 0 fail, 0 skip. **CLI e2e:** Ran on a real markdown + puml file; it generated a correct SVG URL and updated the mar…
Revoir toute la session, chaque commande depuis une machine propre jusqu'à ce point.
Comment le test a été mené
Un agent, un conteneur, aucune aide humaine. Il installe le projet comme l'indique sa propre documentation, l'exécute et corrige ce qui casse. Tout ce qui suit est enregistré tel que cela s'est passé : la session de terminal, le log et le commit exact. La méthode complète.
Points forts et limites
Des faits mesurés, pas des opinions. Comment ce site est rédigé.
Ce qui s'est bien passé
- A atteint un état de fonctionnement sur une machine propre, avec la session enregistrée.
- Installé en 0,5 minute.
- S'est remis de 1 erreur sans intervention humaine, ce qui indique que les échecs sont assez bien documentés pour être résolus.
- A fonctionné sans GPU, il n'en a donc pas besoin pour démarrer.
- Sous licence MIT, selon son hébergeur.
Ce qui ne s'est pas bien passé, ou n'est pas connu
- Mesuré une seule fois jusqu'ici. Une seule tentative montre qu'il peut fonctionner, pas qu'il fonctionne de façon fiable.
Pour quoi c'est un choix raisonnable
- L'essayer sur un ordinateur portable ou un petit serveur : il a atteint un état de fonctionnement sans GPU.
- Une évaluation rapide : il fonctionnait 0,5 minute après le clone.
Également testés, dans le même domaine
Chacun de ces projets a été installé et exécuté par Argusic sur une machine propre. Rien n'apparaît ici sans avoir été testé.
Historique des exécutions
| testé par | tentative | résultat | score | coût USD | date |
|---|---|---|---|---|---|
| Argusic Runner | 1/3 | Fonctionne | 100,00 | 0,01 |
Sujets (depuis GitHub)
c4clidiagramdiagrams-as-codedocs-as-codedocumentationgithubgithub-actionsmarkdownplantumlreadmeumluml-diagram
Intégrer le badge
Markdown pour le README du projet. Il renvoie vers cette page ; conditions sur la page des conditions.
[](https://argusic.com/subject/puml-for-markdown)Questions
- puml-for-markdown fonctionne-t-il ?
- Oui. puml-for-markdown fonctionne. Argusic l'a installé et lancé sur une machine propre en 1 minute, en rencontrant 1 erreur en route, et a enregistré la session.
- Comment Argusic a-t-il testé puml-for-markdown ?
- Sur une machine vierge et jetable, avec chaque commande enregistrée et le dépôt épinglé au commit 6fcd53b0ad61. Une tentative est enregistrée, et la méthode complète se trouve sur la page de méthodologie.
- Combien a coûté le test de puml-for-markdown ?
- L'exécution qui a produit ce verdict a coûté 0,01 USD : le coût réel du calcul et du modèle, pas un prix catalogue par million de tokens. Il est enregistré sur la page de cette exécution.
- Combien de temps faut-il pour installer puml-for-markdown ?
- 0,5 minute lors de l'exécution qui a décidé ce verdict, d'une machine propre à un état de fonctionnement. Il s'agit d'une tentative mesurée, pas d'une moyenne.
- puml-for-markdown a-t-il besoin d'un GPU ?
- Pas pour démarrer. Argusic a atteint un état de fonctionnement sur une machine sans GPU.
- Qu'est-ce qui pose problème lors de l'installation de puml-for-markdown ?
- 1 problème est survenu lors de l'exécution enregistrée, et 1 a été corrigé sans aide humaine. Chacun, avec le temps qu'il a coûté, est listé sur cette page.
- Où sont les preuves pour puml-for-markdown ?
- L'exécution enregistrée se trouve sur cette page, chacune avec un lien vers son log complet et son enregistrement du terminal, conservés avec une empreinte sha256 pour qu'ils ne puissent pas être modifiés discrètement.