cherry-electron-dev

Par cherryhq · cherry-studio

Développez, corrigez et profilez Cherry Studio dans une instance Electron tracée. À utiliser pour l'implémentation au quotidien, le travail sur l'UI et les interactions, la correction de bugs, le débogage à l'exécution, l'inspection via DevTools, l'analyse des lenteurs ou saccades, la surveillance CPU et mémoire, la détection de fuites et l'analyse des performances au démarrage ; réutilisez une instance de workspace vérifiée d'une instruction à l'autre, et lancez-en ou remplacez-en une uniquement si nécessaire.

npx skills add https://github.com/cherryhq/cherry-studio --skill cherry-electron-dev

Développement Cherry Studio

Utilisez cette skill pour le travail en cours dans la checkout actuelle. Ne l'utilisez pas pour vérifier ou rapporter sur les PRs ; utilisez cherry-pr-test pour ce workflow.

Workflow runtime requis

Avant de lire ou contrôler l'interface Electron, lisez Electron Instance Management et utilisez sa politique persistent.

Cette référence est la seule autorité pour la découverte d'instances, instance.json, la sélection de cible CDP, le lancement, le remplacement, l'arrêt et le dépannage. Ne reproduisez pas ces procédures ici et ne substituez pas le contrôle générique d'app Electron.

Boucle de développement

  1. Énoncez le comportement demandé et les preuves qui le démontreront.
  2. Lisez le code pertinent et les fichiers README à proximité.
  3. Vérifiez et réutilisez l'instance tracée via la référence runtime.
  4. Reproduisez ou inspectez le comportement actuel avant la modification quand c'est pratique.
  5. Capturez la plus petite preuve utile : état de l'interface, DOM, sortie console/réseau, logs du processus principal, état persisté, ou métriques de performance.
  6. Tracez le chemin de code responsable et ne faites que la modification demandée.
  7. Gardez Electron en exécution. Utilisez HMR pour les modifications renderer et vérifiez dans la même fenêtre.
  8. Répétez le même scénario et comparez les preuves avant/après.

Inspectez la vraie fenêtre à la taille et au thème pertinents pour le travail d'interface. Vérifiez les preuves renderer et processus principal pour les défaillances renderer.

Redémarrez uniquement pour une couche non rechargeable, un crash, un état runtime instable, ou un profiling de démarrage. Utilisez la procédure de remplacement d'instance exacte de la référence, actualisez instance.json, et gardez le remplacement en exécution.

Exécutez la validation pertinente la plus étroite et suivez les instructions actuelles de l'utilisateur et du repository pour le lint, le formatage et les tests.

Performance et DevTools

Pour les ralentissements, saccades, CPU élevé, croissance mémoire, fuites, démarrage lent, ou utilisation explicite de DevTools, lisez Performance Debugging.

Stockez les logs temporaires, captures d'écran et profiles sous .context/cherry-electron-dev/. Comparez une baseline calme avec le même scénario borné avant et après une correction. Détachez les sessions de profiling après ; ne fermez pas le browser CDP, la page ou le processus Electron.

Passation

Laissez les instances réutilisées appartenant à l'utilisateur et lancées par l'agent en bon état s'exécuter après l'instruction. Arrêtez-en une seulement quand l'utilisateur le demande, qu'un redémarrage requis fait partie de la tâche, ou que l'instance est défaillante et bloque la progression.

Rapportez le PID vérifié, si elle reste en exécution, le port CDP, le fichier de tracking, les chemins de preuves, la reproduction et la vérification.

Skills similaires