Dépannage et sécurité
| Problème | Solution |
|---|---|
Les commandes /umd:... n'apparaissent pas | Redémarre Claude Code ou tape /reload-plugins. Regarde /plugin → Installed et l'onglet Errors. |
node: command not found | Installe Node.js 18+ et vérifie que node est dans ton PATH. |
| L'ajout de la marketplace échoue | Vérifie que git est installé. Sans clé SSH GitHub, définis CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 et réessaie. |
ffmpeg not found | Lance /umd:doctor. Après une installation par winget ou Homebrew, ouvre un nouveau terminal pour que le PATH soit relu. Tu peux aussi indiquer le chemin des binaires avec UMD_FFMPEG et UMD_FFPROBE. |
Playwright not found ou Chromium is not installed | /umd:doctor fix installe les deux dans ~/.umd/runtime. |
Unknown duration au rendu | Définis window.umdDuration (en secondes) dans la page, ou duration_s dans .motion/project.json. |
| Le rendu n'est pas reproductible (REN-01) | Une source de hasard échappe au temps virtuel : données réseau, horodatage serveur, WebGPU, police chargée en ligne. Le guide du moteur (references/engines/) liste les règles. Pilote la scène par window.umdRender(t). |
| La 3D est lente ou vide dans le rendu | Chromium sans interface utilise un rendu logiciel. Itère avec /umd:render draft et vérifie d'abord une image avec umd still. |
| Une installation est bloquée par le garde-fou | Prends l'alternative proposée (references/licenses.md). Si tu acceptes le risque, ajoute le nom à license_policy.allow : c'est ta décision, Claude ne le fait pas à ta place. |
/umd:deliver refuse de livrer | Un point bloquant est ouvert, ou le rendu a changé depuis l'audit : /umd:fix, puis /umd:render et /umd:audit. |
umd sync dit « no hit within 250 ms » | Le son prévu n'est pas là, ou trop faible sous la musique : place l'effet sur le temps du repère (umd mix --sfx fichier.wav@6.5) et vérifie qu'il dépasse la musique. |
/umd:tokens est vide | Les transcriptions apparaissent après la première session Claude Code dans ce dossier. Si tu as déplacé ta configuration, définis CLAUDE_CONFIG_DIR. |
Confidentialité et sécurité
Le plugin n'envoie aucune télémétrie.
- Ce qu'il contacte :
- Pendant un rendu, il sert tes fichiers sur
127.0.0.1et ne contacte que les URL que ta page charge elle-même. /umd:doctor fixtélécharge Playwright depuis npm, Chromium depuis les serveurs de Playwright, et FFmpeg par winget ou Homebrew.umd styles gettélécharge le prompt choisi depuis GitHub ;umd commonsinterroge Wikimedia Commons. Aucune donnée de ton projet n'est envoyée.
- Pendant un rendu, il sert tes fichiers sur
- Ce qu'il lit :
/umd:tokenslit les transcriptions de Claude Code sur ta machine et n'en envoie rien. - Hooks : ils tournent en local et sont assez courts pour être relus : garde-fou de licences, rappel de session.
- Signaler une faille : voir SECURITY.md.
Le plugin aide à repérer les pièges de licence ; il ne remplace pas l'avis d'un juriste.