技能 debug-connection
🔌

debug-connection

安全

Déboguer les problèmes de connexion WebSocket

也可从以下获取: 7nohe

Les connexions WebSocket entre CLI et le plugin FigJam échouent souvent silencieusement. Cette compétence fournit des procédures de diagnostic étape par étape pour identifier et résoudre rapidement les problèmes de connexion.

支持: Claude Codex Code(CC)
⚠️ 67 差
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“debug-connection”。 Déboguer pourquoi mon plugin FigJam affiche 'Connexion...' indéfiniment

预期结果:

  • Connexion refusée signifie généralement que CLI serve n'est pas en cours d'exécution. Suivez ces étapes :
  • 1. Vérifiez si figram serve est en cours d'exécution : ps aux | grep 'figram serve'
  • 2. Vérifiez la disponibilité du port 3456 : lsof -i :3456
  • 3. Démarrez CLI avec : bun run packages/cli/src/index.ts serve diagram.yaml
  • 4. Testez WebSocket manuellement : wscat -c ws://localhost:3456
  • 5. Consultez la console du plugin UI pour les événements de fermeture WebSocket

安全审计

安全
v3 • 1/10/2026

This skill contains only documentation - a markdown file providing debugging guidance for WebSocket connection issues. No executable code, no file system access, no network operations, and no code execution capabilities. Pure informational content.

1
已扫描文件
193
分析行数
0
发现项
3
审计总数
未发现安全问题
审计者: claude 查看审计历史 →

质量评分

38
架构
100
可维护性
83
内容
21
社区
100
安全
78
规范符合性

你能构建什么

Déboguer les problèmes de synchronisation en direct

Lorsque les modifications YAML n'apparaissent pas sur le canvas FigJam, diagnostiquer les ruptures de communication WebSocket

Investiguer les pertes de connexion

Tracer pourquoi les connexions WebSocket se ferment de manière inattendue pendant les sessions de développement

Vérifier les problèmes de configuration

Vérifier la disponibilité du port, les discordances de secret et les problèmes d'authentification dans les configurations déployées

试试这些提示

Vérifier l'état de la connexion 
Déboguer pourquoi mon plugin FigJam affiche 'Connexion...' indéfiniment. Comment vérifier si CLI serve est en cours d'exécution et si le port 3456 est disponible ?
Diagnostiquer les échecs de synchronisation 
Le WebSocket se connecte mais mes diagrammes ne se synchronisent pas. Quelles étapes de diagnostic dois-je suivre pour identifier pourquoi les patches ne sont pas appliqués ?
Vérifier l'authentification 
Ma connexion s'établit mais se ferme immédiatement. Comment vérifier s'il y a une discordance de secret entre CLI et le plugin ?
Inspecter les trames du protocole 
Montre-moi les formats de messages du protocole WebSocket incluant HelloMessage, FullMessage, PatchMessage, et comment les opérations de patch sont structurées.

最佳实践

  • Démarrez CLI serve avec DEBUG=* pour une sortie détaillée des trames WebSocket
  • Utilisez les outils de développement du navigateur pour inspecter l'onglet Network pour les trames WS
  • Gardez les valeurs de secret CLI et plugin synchronisées lors de l'utilisation de l'authentification

避免

  • Ignorer les erreurs de validation YAML qui bloquent les mises à jour incrémentales
  • Sauter l'inspection des logs de console lorsque les connexions se perdent
  • Supposer que les échecs de connexion sont toujours des problèmes au niveau réseau

常见问题

Cette compétence fonctionne-t-elle avec Claude Code sur tous les systèmes d'exploitation ?
Oui, les procédures de débogage utilisent des commandes standard comme ps, lsof et bun qui sont disponibles sur macOS et Linux. Les utilisateurs Windows peuvent avoir besoin de WSL.
Quelles sont les limites de timeout de connexion ?
Il n'y a pas de limites de timeout strictes définies. La connexion WebSocket persiste jusqu'à ce que le processus CLI se termine ou qu'une interruption réseau se produise.
Puis-je intégrer cela avec des pipelines de tests automatisés ?
Cette compétence fournit uniquement des conseils de diagnostic. Pour les tests automatisés, vous devrez implémenter des vérifications de santé WebSocket dans votre pipeline CI.
Mon contenu YAML est-il envoyé à des serveurs externes pendant le débogage ?
Non. Tout le débogage est local. La connexion WebSocket est uniquement localhost (ws://localhost:3456) et ne transmet pas de données à l'extérieur.
Que faire si wscat n'est pas installé pour les tests manuels ?
Vous pouvez utiliser n'importe quel outil client WebSocket. Les alternatives incluent websocat, les outils de développement du navigateur, ou de simples scripts de test WebSocket en Node.js.
Comment cela se compare-t-il aux outils de débogage réseau génériques ?
Cette compétence est spécialisée pour le protocole WebSocket de Figram, incluant les types de messages, le suivi des révisions et les opérations de patch que les outils génériques ne peuvent pas interpréter.

开发者详情

作者

7nohe

许可证

MIT

仓库

https://github.com/7nohe/figram/tree/main/.claude/skills/debug-connection

引用

main

文件结构

📄 SKILL.md