Autoría de manifiestos WinGet
Entorno de ejecución
Ejecutar comandos del módulo Dumplings y scripts de habilidad del host con PowerShell 7.4 o posterior (pwsh). Windows PowerShell 5.1 no es compatible a menos que un recolector invitado autónomo específico indique lo contrario.
Flujo de trabajo
Leer las referencias necesarias para la etapa actual.
- Selección del paquete: Identidad, búsqueda de duplicados en el índice de fuentes, descubrimiento de fuentes oficiales, selección de artefactos y evidencia de fecha de lanzamiento.
- Construcción del manifiesto: Modelo y archivos, campos del instalador, dependencias, valores predeterminados y códigos de retorno, Aplicaciones y características y formateo y validación.
- Localización: Modelo de configuración regional, identidad de configuración regional y contenido de configuración regional y notas de la versión.
- Finalización: Envío y registros de validación de las comprobaciones de PR.
- API auxiliares compartidas: usar
$use-dumplings-functionspara recuperación de fuentes, redirecciones, decodificación de respuestas, archivos temporales, procesamiento de HTML o Markdown, YAML y evidencia del navegador. - Guía de familia de instaladores: comenzar con la tabla de rutas de familia de instaladores del analizador, luego abrir el flujo de trabajo de la familia seleccionada para comandos estáticos del analizador, conmutadores, propiedad de ARP y excepciones de VM.
- Registros de trabajo grandes: Evidencia transitoria.
Usar $analyze-winget-installer para la evidencia del instalador y $author-dumplings-task después de que se acepte la primera versión del paquete, o con una referencia de paquete pendiente confiable configurada explícitamente mientras se espera la fusión de su primer PR.
Autoría incremental
Crear y guardar un manifiesto multiarchivo de trabajo una vez que se conozcan el identificador, la versión, la configuración regional predeterminada y los campos obligatorios del instalador. Para un paquete existente, usar su modelo lógico para crear la nueva hoja de versión. Continuar la investigación y la validación en VM contra este borrador.
Guardar el manifiesto a medida que la selección de artefactos, el análisis, la investigación de configuración regional, las notas de la versión y la validación en VM establezcan nuevos hechos. Leer el modelo lógico actual antes de cada edición e inspeccionar la diferencia (diff). Omitir campos opcionales no resueltos. Al manejar un lote, mantener el borrador de cada paquete durante toda su investigación. Formatear y validar el conjunto completo después del guardado inicial y los cambios estructurales, luego realizar una revisión final estricta antes del envío.
Reglas no negociables
Usar fuentes oficiales del publicador. No usar agregadores de descargas, espejos, reempaquetadores ni sitios de descarga de resultados de búsqueda. Verificar sitios web y repositorios antes de confiar en cualquiera de ellos.
Nunca ejecutar un instalador desconocido en el host. Antes de finalizar o enviar una entrada, completar la validación en VM con el artefacto exacto y los conmutadores creados. Detenerse si el único enlace requiere inicio de sesión, se entrega por correo electrónico, no es oficial o es sospechoso, o está vinculado a una sesión sin una alternativa estable. Rechazar instaladores que no puedan ejecutarse desatendidos, incluidos aquellos bloqueados por un cuadro de diálogo de consentimiento del publicador de controladores de Seguridad de Windows.
Si el software de seguridad del host o de la VM marca un ejecutable como virus o malware, detener inmediatamente el flujo de trabajo del paquete afectado y advertir al usuario. Seguir Detenerse en alertas de malware.
No inventar identidades de publicador, nombres legales, URL, notas de la versión, versiones, metadatos de registro ni conmutadores. Buscar en todas las fuentes autorizadas probables antes de omitir un campo opcional aplicable.
La autoría actual utiliza el esquema 1.12.0 y los encabezados fijos de Dumplings.
No agregar Moniker automáticamente. No autorizar UnsupportedOSArchitectures por el momento. Omitir conmutadores, modos y códigos de retorno de instaladores conocidos cuando sean iguales a los valores predeterminados de WinGet.
Disciplina de salida
Usar el modelo lógico completo durante toda la autoría. Guardar cada revisión respaldada por evidencia con Save-WinGetManifest o las API de modelo documentadas, luego validar sin conexión. Reservar Format-WinGetManifest para documentos aislados. No puede optimizar entre documentos ni establecer evidencia faltante.
Preservar los registros completos de fuente, instalador, VM y validación en el árbol de evidencia transitorio. Informar solo las decisiones, los diagnósticos no resueltos y la ruta de evidencia en la tarea.