Création d'un module complémentaire Phi Silice

Ce guide vous montre comment créer un module complémentaire natif C# qui appelle l’API IA Phi Silicon dans votre application Electron. Phi Silicon est un petit modèle de langage qui s’exécute localement sur des appareils Windows 11 avec des processeurs réseau (unités de traitement neuronal).

Prerequisites

Avant de commencer ce guide, vérifiez que vous avez :

• Fin de la configuration de l’environnement de développement
• Copilot+ PC - Phi Silicon nécessite un appareil avec un NPU (Unité de traitement neuronal)

Étape 1 : Créer un complément natif C#

Maintenant pour la partie excitante , nous allons créer un module complémentaire natif qui appelle Windows API ! Nous allons utiliser un modèle C# qui tire parti de node-api-dotnet pour ponter JavaScript et C#.

npx winapp node create-addon --template cs

Cela crée un csAddon/ dossier avec :

• addon.cs - Votre code C# qui appelle les API Windows
• csAddon.csproj - fichier Project avec des références au Kit de développement logiciel (SDK) Windows et SDK d'application Windows
• README.md - Documentation sur l’utilisation du module complémentaire

La commande ajoute également un build-csAddon script à votre package.json pour générer le module complémentaire et un clean-csAddon script pour le nettoyage des artefacts de build :

{
  "scripts": {
    "build-csAddon": "dotnet publish ./csAddon/csAddon.csproj -c Release",
    "clean-csAddon": "dotnet clean ./csAddon/csAddon.csproj"
  }
}

Le modèle inclut automatiquement des références aux deux kits SDK, ce qui vous permet de commencer immédiatement à appeler Windows API !

Vérifions que tout est configuré correctement en créant le module complémentaire :

# Build the C# addon
npm run build-csAddon

Étape 2 : Ajouter des fonctionnalités d’IA avec Phi Silicon

Ajoutons une API SDK d'application Windows réelle . Nous allons utiliser le modèle IA Phi Silicon pour synthétiser du texte directement sur appareil.

Ouvrez csAddon/addon.cs et ajoutez ce code :

using System;
using System.Threading.Tasks;
using Microsoft.JavaScript.NodeApi;
using Microsoft.Windows.AI;
using Microsoft.Windows.AI.Text;

namespace csAddon
{
    [JSExport]
    public class Addon
    {
        /// <summary>
        /// Summarizes the provided text using the Phi Silica AI model.
        /// </summary>
        /// <param name="text">The text to summarize</param>
        /// <returns>A summary of the input text</returns>
        [JSExport]
        public static async Task<string> SummarizeText(string text)
        {
            try
            {
                var readyState = LanguageModel.GetReadyState();
                if (readyState is AIFeatureReadyState.Ready or AIFeatureReadyState.NotReady)
                {
                    if (readyState == AIFeatureReadyState.NotReady)
                    {
                        await LanguageModel.EnsureReadyAsync();
                    }

                    using LanguageModel languageModel = await LanguageModel.CreateAsync();
                    TextSummarizer textSummarizer = new TextSummarizer(languageModel);

                    var result = await textSummarizer.SummarizeParagraphAsync(text);

                    return result.Text;
                }

                return "Model is not available";
            }
            catch (Exception ex)
            {
                return $"Error calling Phi Silica API: {ex.Message}";
            }
        }
    }
}

Étape 3 : Générer le module complémentaire C#

Maintenant, générez à nouveau le module complémentaire :

npm run build-csAddon

Cela compile votre code C# à l’aide d’AOT natif (compilation anticipée), qui :

• Crée un .node fichier binaire (format de complément natif)
• Supprime le code inutilisé pour une taille d’offre groupée plus petite
• Ne nécessite aucun runtime .NET sur les machines cibles
• Fournit la performance native

Le module complémentaire compilé sera dans csAddon/dist/csAddon.node.

Étape 4 : Tester l’API Windows

Maintenant, vérifions que le module complémentaire fonctionne en l’appelant à partir du processus principal. Ouvrez src/main.js et procédez comme suit :

4.1. Charger le module complémentaire C#

Ajoutez-le avec vos autres require instructions en haut du fichier :

const csAddon = require('../csAddon/dist/csAddon.node');

4.2. Créer une fonction de test

Ajoutez cette fonction quelque part dans votre fichier (après les instructions require) :

const callPhiSilica = async () => {
  console.log('Summarizing with Phi Silica: ')
  const result = await csAddon.Addon.summarizeText("The Windows App Development CLI is a powerful tool that bridges cross-platform development with Windows-native capabilities.");
  console.log('Summary:', result);
};

4.3. Appeler la fonction

Ajoutez cette ligne à la fin de la createWindow() fonction pour tester l’API au démarrage de l’application :

callPhiSilica();

Lorsque vous exécutez l’application, le résumé est imprimé dans la console. À partir de là, vous pouvez intégrer le module complémentaire dans votre application comme vous le souhaitez, qu’il s’agisse de l’exposer via un script de préchargement au processus de rendu, de l’appeler depuis les gestionnaires IPC, ou de l’utiliser directement dans le processus principal.

Étape 5 : Ajouter une fonctionnalité requise

Avant de pouvoir utiliser l’API Phi Silicon, vous devez déclarer la fonctionnalité requise dans votre manifeste d’application. Ouvrez Package.appxmanifest et ajoutez la systemAIModels fonctionnalité dans la <Capabilities> section :

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
  <rescap:Capability Name="systemAIModels" />
</Capabilities>

Étape 6 : Mettre à jour l’identité de débogage

Chaque fois que vous modifiez Package.appxmanifest ou modifiez des ressources référencées dans le manifeste (comme les icônes d’application), vous devez mettre à jour l’identité de débogage de votre application. Run:

npx winapp node add-electron-debug-identity

Cette commande :

1. Lit Package.appxmanifest afin d'obtenir les détails et les fonctionnalités de l'application
2. electron.exe est enregistré dans votre node_modules avec une identité temporaire
3. Vous permet de tester les API nécessitant une identité sans la nécessité d'un empaquetage MSIX complet

Exécutez maintenant votre application :

npm start

Vérifiez la sortie de la console : vous devriez voir le résumé de Phi Silica imprimé !

Prochaines étapes

Félicitations! Vous avez créé avec succès un module complémentaire natif faisant appel aux API d'IA de Windows ! 🎉

Vous êtes maintenant prêt à :

• Empaqueter votre application pour la distribution - Créer un package MSIX que vous pouvez distribuer

Ou explorez d’autres guides :

• Creating a WinML Addon - Découvrez comment utiliser Windows Machine Learning
• Vue d’ensemble de la prise en main - Revenir au guide principal

Ressources additionnelles

• Documentation de l’interface CLI winapp - Informations de référence sur l’interface CLI complète
• Exemple d’application Electron - Exemple de travail complet
• Windows addon AI pour Electron - Le module complémentaire IA Windows pour Electron est un module complémentaire natif Node.js qui permet d’accéder aux API IA Windows directement à partir de JavaScript.
• Ai Dev Gallery - Exemple de galerie de toutes les API IA
• Exemples SDK d'application Windows - Collection d’exemples de SDK d'application Windows
• node-api-dotnet - Bibliothèque d’interopérabilité JavaScript C# ↔