Autorização de manifests do WinGet
Runtime
Execute comandos do módulo Dumplings e scripts de skill do lado do host com PowerShell 7.4 ou posterior (pwsh). O Windows PowerShell 5.1 não é suportado, a menos que um coletor convidado autocontido específico diga o contrário.
Fluxo de trabalho
Leia as referências necessárias para o estágio atual.
- Seleção de pacote: Identidade, busca de duplicatas no índice de origem, descoberta de fontes oficiais, seleção de artefato e evidência de data de lançamento.
- Construção do manifest: Modelo e arquivos, campos do instalador, dependências, padrões e códigos de retorno, Apps e Recursos e formatação e validação.
- Localização: Modelo de localidade, identidade da localidade e conteúdo da localidade e notas de lançamento.
- Conclusão: Submissão e logs de validação das verificações de PR.
- APIs auxiliares compartilhadas: use
$use-dumplings-functionspara recuperação de fontes, redirecionamentos, decodificação de respostas, arquivos temporários, processamento de HTML ou Markdown, YAML e evidências de navegador. - Guia para famílias de instaladores: comece com a tabela de rota da família do instalador do analisador, depois abra o fluxo de trabalho da família selecionado para comandos do analisador estático, chaves, propriedade ARP e exceções de VM.
- Grandes registros de trabalho: Evidências transitórias.
Use $analyze-winget-installer para evidências do instalador e $author-dumplings-task após a primeira versão do pacote ser aceita, ou com uma referência de pacote pendente confiável explicitamente configurada enquanto seu primeiro PR aguarda merge.
Autoria incremental
Crie e salve um manifest multi-arquivo de trabalho assim que o identificador, a versão, a localidade padrão e os campos obrigatórios do instalador forem conhecidos. Para um pacote existente, use seu modelo lógico para criar a nova folha de versão. Continue a pesquisa e a validação em VM com base neste rascunho.
Salve o manifest conforme a seleção de artefato, análise, pesquisa de localidade, notas de lançamento e validação em VM estabelecem novos fatos. Leia o modelo lógico atual antes de cada edição e inspecione o diff. Omita campos opcionais não resolvidos. Ao lidar com um lote, mantenha o rascunho de cada pacote durante toda a sua pesquisa. Formate e valide o conjunto completo após o salvamento inicial e alterações estruturais, depois realize uma revisão final rigorosa antes da submissão.
Regras não negociáveis
Use fontes oficiais do editor. Não use agregadores de download, espelhos, reempacotadores ou sites de download com resultados de pesquisa. Verifique sites e repositórios antes de confiar em qualquer um deles.
Nunca execute um instalador desconhecido no host. Antes de finalizar ou enviar uma entrada, conclua a validação em VM com o artefato exato e as chaves criadas. Pare se o único link exigir login, for entregue por e-mail, for não oficial ou suspeito, ou for vinculado à sessão sem uma alternativa estável. Rejeite instaladores que não possam ser executados sem supervisão, incluindo aqueles bloqueados por uma caixa de diálogo de consentimento do editor de driver do Windows Security.
Se o software de segurança do host ou da VM sinalizar um executável como vírus ou malware, pare imediatamente o fluxo de trabalho do pacote afetado e avise o usuário. Siga Parar em alertas de malware.
Não invente identidades do editor, nomes legais, URLs, notas de lançamento, versões, metadados do registro ou chaves. Pesquise todas as fontes confiáveis prováveis antes de omitir um campo opcional aplicável.
A autoria atual usa o esquema 1.12.0 e os cabeçalhos fixos do Dumplings.
Não adicione Moniker automaticamente. Não crie UnsupportedOSArchitectures no momento. Omita chaves, modos e códigos de retorno conhecidos do instalador quando forem iguais aos padrões do WinGet.
Disciplina de saída
Use o modelo lógico completo durante toda a autoria. Salve cada revisão baseada em evidências com Save-WinGetManifest ou as APIs de modelo documentadas, depois valide offline. Reserve Format-WinGetManifest para documentos isolados. Ele não pode otimizar entre documentos ou estabelecer evidências ausentes.
Preserve registros completos de origem, instalador, VM e validação na árvore de evidências transitórias. Relate apenas as decisões, diagnósticos não resolvidos e o caminho da evidência na tarefa.