撰寫 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 和驗證記錄保留在暫存證據樹中。只在任務中報告決定、未解決的診斷和證據路徑。