TauriTavern/docs/CurrentState/WindowsDistribution.md

Windows 分发现状

TauriTavern 的 Windows Stable Release 以 GitHub Release 为唯一安装包来源。WinGet 只发布指向该 Release 的元数据，不重新构建或托管二份安装包。

WinGet 契约

• Package ID：TauriTavern.TauriTavern
• 安装包：TauriTavern-<version>-windows-x64-setup.exe
• 类型：NSIS（WinGet manifest 中为 nullsoft）
• 架构与范围：x64、user
• 静默参数：/S；带进度的无人值守参数：/P
• 升级行为：install
• 仅发布 Stable；Canary、MSI 和 portable zip 不进入这个 Package ID

用户目录安装与当前 NSIS 默认行为一致。Portable 版本依赖 Scoop 的 persist 语义，不能把它等价映射为 WinGet portable package。

发布链路

.github/workflows/stable-release.yml 在全部 Release 资产上传成功后调用 .github/workflows/winget-release.yml。后者：

1. 校验 tag、仓库版本与已发布的非 prerelease Release 一致；
2. 精确选择一个 x64 NSIS setup 资产；
3. 若目标版本已合入或已有开放 PR，则幂等成功；
4. 下载固定版本的 WingetCreate 并校验 SHA256；
5. 从官方仓库中的上一版 manifest 生成更新，先上传为 Actions artifact，再提交 PR。

工作流可以按 release_tag 手动运行，因此 WinGet 失败时只重试 manifest 发布， 不需要重新构建 Stable Release。Stable 的资产上传仍保留 --clobber；发布契约是 每个 Stable tag 只构建、上传一次，WinGet 始终读取上传完成后的最终资产。

一次性启用

自动更新依赖官方 microsoft/winget-pkgs 仓库中已有 Package ID。首次启用需要：

1. 以一个已经发布的 Stable 版本提交并合入 TauriTavern.TauriTavern multi-file seed manifest；
2. 确认 seed manifest 满足上面的 installer 契约，并在真实 Windows 用户环境验证 install、silent install、upgrade 与 uninstall；
3. 使用完成 Microsoft CLA 的专用 GitHub 账号创建 classic PAT，仅授予 public_repo，保存为仓库 secret WINGET_CREATE_GITHUB_TOKEN；
4. 手动运行 WinGet Release 验证更新 PR，再让后续 Stable 自动调用。

seed manifest 合入并同步到 WinGet source 后，安装命令为：

winget install --id TauriTavern.TauriTavern --exact

在官方 source 尚未可查询前，不应把该命令加入面向用户的 README。