SpecterShell/Dumplings

Auteur de manifestes WinGet

Runtime

Exécutez les commandes du module Dumplings et les scripts de compétence côté hôte avec PowerShell 7.4 ou version ultérieure (pwsh). Windows PowerShell 5.1 n'est pas pris en charge, sauf indication contraire d'un collecteur invité autonome spécifique.

Flux de travail

Lisez les références nécessaires à l'étape en cours.

• Sélection du paquet : Identité, recherche de doublon dans l'index source, découverte de la source officielle, sélection de l'artéfact et preuve de la date de sortie.
• Construction du manifeste : Modèle et fichiers, champs de l'installateur, dépendances, valeurs par défaut et codes de retour, Apps et fonctionnalités, et formatage et validation.
• Localisation : Modèle de locale, identité de la locale, et contenu de la locale et notes de version.
• Achèvement : Soumission et journaux de validation des vérifications PR.
• API d'assistance partagées : utilisez $use-dumplings-functions pour la récupération de sources, les redirections, le décodage de réponses, les fichiers temporaires, le traitement HTML ou Markdown, YAML et les preuves de navigateur.
• Guide des familles d'installateurs : commencez par la table de routage des familles d'installateurs de l'analyseur, puis ouvrez le flux de travail de la famille sélectionnée pour les commandes d'analyse statique, les commutateurs, la propriété ARP et les exceptions de machine virtuelle.
• Grands enregistrements de travail : Preuves transitoires.

Utilisez $analyze-winget-installer pour les preuves de l'installateur et $author-dumplings-task après que la première version du paquet soit acceptée, ou avec une référence de paquet en attente de confiance explicitement configurée en attendant la fusion de sa première PR.

Révision incrémentielle

Créez et enregistrez un manifeste multi-fichier de travail dès que l'identifiant, la version, la locale par défaut et les champs d'installateur requis sont connus. Pour un paquet existant, utilisez son modèle logique pour créer la nouvelle feuille de version. Continuez la recherche et la validation en VM sur cette ébauche.

Enregistrez le manifeste au fur et à mesure que la sélection d'artéfacts, l'analyse, la recherche de locale, les notes de version et la validation en VM établissent de nouveaux faits. Lisez le modèle logique actuel avant chaque modification et inspectez la différence. Omettez les champs facultatifs non résolus. Lorsque vous traitez un lot, conservez l'ébauche de chaque paquet tout au long de sa recherche. Formatez et validez l'ensemble complet après la sauvegarde initiale et les modifications structurelles, puis effectuez une révision finale stricte avant la soumission.

Règles non négociables

Utilisez les sources officielles de l'éditeur. N'utilisez pas d'agrégateurs de téléchargement, de miroirs, de reconditionneurs ou de sites de téléchargement par recherche. Recoupez les sites Web et les dépôts avant de faire confiance à l'un ou l'autre.

N'exécutez jamais un installateur inconnu sur l'hôte. Avant de finaliser ou de soumettre une entrée, terminez la validation en VM avec l'artéfact exact et les commutateurs créés. Arrêtez-vous si le seul lien nécessite une connexion, est envoyé par e-mail, est non officiel ou suspect, ou est lié à une session sans solution de repli stable. Rejetez les installateurs qui ne peuvent pas fonctionner sans assistance, y compris ceux bloqués par une boîte de dialogue de consentement du pilote de sécurité Windows.

Si le logiciel de sécurité de l'hôte ou de la VM signale un exécutable comme virus ou logiciel malveillant, arrêtez immédiatement le flux de travail du paquet concerné et avertissez l'utilisateur. Suivez Arrêt sur alertes de logiciels malveillants.

N'inventez pas d'identités d'éditeur, de noms légaux, d'URL, de notes de version, de versions, de métadonnées de registre ou de commutateurs. Recherchez toutes les sources faisant autorité avant d'omettre un champ facultatif applicable.

L'édition actuelle utilise le schéma 1.12.0 et les en-têtes fixes de Dumplings.

N'ajoutez pas Moniker automatiquement. N'écrivez pas UnsupportedOSArchitectures pour le moment. Omettez les commutateurs d'installateur, les modes et les codes de retour connus lorsqu'ils sont égaux aux valeurs par défaut de WinGet.

Discipline de sortie

Utilisez le modèle logique complet tout au long de l'édition. Enregistrez chaque révision fondée sur des preuves avec Save-WinGetManifest ou les API de modèle documentées, puis validez hors ligne. Réservez Format-WinGetManifest pour les documents isolés. Il ne peut pas optimiser entre les documents ni établir de preuves manquantes.

Conservez les enregistrements complets de source, d'installateur, de VM et de validation dans l'arbre de preuves transitoires. Signalez uniquement les décisions, les diagnostics non résolus et le chemin de preuve dans la tâche.