编写 WinGet 清单
运行时
使用 PowerShell 7.4 或更高版本(pwsh)运行 Dumplings 模块命令和主机端技能脚本。除非特定的独立来宾收集器另有说明,否则不支持 Windows PowerShell 5.1。
工作流程
阅读当前阶段所需的参考资料。
- 包选择:身份、源索引重复查找、官方源发现、工件选择 和 发布日期证据。
- 清单构建:模型和文件、安装程序字段、依赖项、默认值和返回代码、应用和功能 以及 格式化和验证。
- 本地化:区域设置模型、区域设置身份 以及 区域设置内容和发行说明。
- 完成:提交 和 来自 PR 检查的验证日志。
- 共享辅助 API:使用
$use-dumplings-functions进行源检索、重定向、响应解码、临时文件、HTML 或 Markdown 处理、YAML 以及浏览器证据。 - 安装程序族指南:从分析器的安装程序族路由表开始,然后打开选定的族工作流程,以获取静态解析器命令、开关、ARP 所有权和 VM 例外。
- 大型工作记录:临时证据。
在第一个包版本被接受后,或者在使用明确配置的可信待处理包引用且其第一个 PR 正在等待合并时,使用 $analyze-winget-installer 获取安装程序证据,并使用 $author-dumplings-task。
增量编写
一旦确定了标识符、版本、默认区域设置和必需的安装程序字段,就创建并保存一个工作用的多文件清单。对于现有包,使用其逻辑模型创建新版本的文件。针对此草稿继续研究和 VM 验证。
在工件选择、解析、区域设置研究、发行说明和 VM 验证建立新事实时,保存清单。每次编辑前阅读当前的逻辑模型,并检查差异。省略未解决的可选字段。在处理批次时,在整个研究过程中维护每个包的草稿。在初始保存和结构更改后,格式化并验证完整集合,然后在提交前执行严格的最终审查。
不可协商的规则
使用官方发布者源。不要使用下载聚合器、镜像、重新打包器或搜索结果下载站点。在信任网站和存储库之前进行交叉检查。
切勿在主机上执行未知安装程序。在最终确定或提交条目之前,使用确切的工件和编写的开关完成 VM 验证。如果唯一的链接需要登录、通过电子邮件发送、非官方或可疑、或者绑定会话且没有稳定的后备方案,则停止。拒绝无法无人值守运行的安装程序,包括被 Windows 安全驱动程序发布者同意对话框 阻止的安装程序。
如果主机或 VM 安全软件将可执行文件标记为病毒或恶意软件,请立即停止受影响的包工作流程并警告用户。遵循 在恶意软件警报时停止。
不要捏造发布者身份、法律名称、URL、发行说明、版本、注册表元数据或开关。在省略适用的可选字段之前,搜索所有可能的权威来源。
当前编写使用架构 1.12.0 和固定的 Dumplings 头部。
不要自动添加 Moniker。目前不要编写 UnsupportedOSArchitectures。当已知的安装程序开关、模式和返回代码等于 WinGet 默认值时,省略它们。
输出规范
在整个编写过程中使用完整的逻辑模型。使用 Save-WinGetManifest 或文档化的模型 API 保存每个有证据支持的修订版本,然后离线验证。保留 Format-WinGetManifest 用于单独的文档。它无法跨文档进行优化或建立缺失的证据。
在临时证据树中保留完整的源、安装程序、VM 和验证记录。在任务中仅报告决策、未解决的诊断信息和证据路径。