Skip to content

Releases

Whinset v2.0.0-rc.1

Whinset v2.0.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Nov 12:23
cbf3808

Whinset v2.0.0-rc.1

Release candidate. This is not the final v2.0.0 certification. Real clean-VM UAC, privileged installer, Windows feature and reboot-continuation acceptance remains pending.

Read before download

Whinset can install software and make machine-level changes. Review this before running beatwin.txt or applying a plan.

  • Elevated operations may: install machine-scoped packages, enable Windows optional features, install/update WSL and Ubuntu, install Docker Desktop, and set machine JAVA_HOME/PATH.
  • User operations may: configure Git LFS, uv, Conda, Go, Rust and user PATH/environment values.
  • UAC: apply requests one normal Windows UAC authorization when elevated work remains. All elevated operations are then grouped into one worker. UAC is never bypassed or disabled.
  • If UAC is denied: the elevated phase does not start; status is ElevationDenied and exit code is 4.
  • Restart: some installers/features can require a restart. Whinset exits 3010 and waits for a manual restart; it does not schedule or force one.
  • Rollback: package uninstalls can be manual but are not guaranteed to restore every vendor registry/PATH/service change. Windows features, WSL distributions and Docker state require manual review. No automatic rollback is claimed.
  • Logs: %LOCALAPPDATA%\Whinset\v2. The bootstrap's temporary download folder is removed after the command, but permanent state/logs remain.

What is new

  • New canonical whinset PowerShell module/CLI and copy-paste beatwin.txt bootstrap.
  • Schema 2 package catalog with exact Source:Id identities, vendors, architecture, scope, version policy, stage, privilege, dependencies, conflicts, expected state and recovery metadata.
  • Exact stable-key/Source:Id resolution; display names are never install selectors.
  • Deterministic dependency DAG planning with stable ordering, cycle/conflict validation and plan hashes.
  • Separate plan and apply workflows with human and JSON output.
  • One-UAC elevated worker; user-level configuration remains in the user process.
  • Trusted plan reconstruction from the installed catalog instead of arbitrary elevated code.
  • Resumable state, operation-level JSONL logs, reboot gates, package rechecks and exit 3010.
  • Read-only discovery of legacy SetupNewPC state.
  • PowerShell 7 primary support plus Windows PowerShell 5.1 regression coverage.
  • Tab completion for commands, profiles, groups, stages and package keys.
  • Deterministic release archive plus pinned SHA-256 bootstrap generation.

Commands

whinset plan -Profile Developer
whinset apply -Profile Minimal -AcceptAgreements
whinset status
whinset doctor
whinset resolve chrome
whinset recover -Retry

Exit codes

0 complete, 1 operation failure, 2 invalid input/agreement, 3 compatibility cancellation, 4 UAC denied, 5 doctor unhealthy, 3010 restart required.

Known limitations

  • Custom catalogs are plan-only in rc.1.
  • The legacy WinUtil path remains available only through the legacy script and was not moved into the new elevated worker.
  • Docker Desktop first-run setup and daemon startup can require manual action.
  • Package inventory and installer behavior still depend on WinGet sources, Store policy, network access and vendor installers.
  • Mocked tests cover orchestration, DAG ordering, UAC denial, already-elevated flow, resume and logging; they do not certify every real installer.
  • Clean Windows 11 VM acceptance must be completed before publishing final v2.0.0. Current evidence is in docs/acceptance/windows-v2.0.0-rc.1.md.

Verification

The release archive is built by scripts/Build-Release.ps1. beatwin.txt pins the v2.0.0-rc.1 archive SHA-256 and is published both as a repository file and release asset. Compare it with SHA256SUMS.txt on the release page.

SetupNewPC v1.1.0

Choose a tag to compare

@styayur styayur released this 21 Sep 11:18

历史版本提示(2026-10-16):此 Release 是 v1,默认可能下载并执行 WinUtil、自动提权并创建续跑任务,不能按当前 v2 文档使用。当前维护入口请从 仓库 README 开始;v2.0.0 仍是未发布草稿。不要默认调整执行策略或直接执行未经审查的远程脚本。下文保留历史发布说明以便识别旧行为,并非当前推荐安装方式。此 Release 没有 SHA256SUMS.txt;可使用 GitHub 资产提供的 SHA-256 digest 对照下载文件。原文件与历史地址保持不变。


SetupNewPC v1.1.0

本次重点

  • WinUtil 现在默认下载到本地并执行 Standard preset。
  • 默认跳过 WinUtil 时使用 -SkipWinUtil。
  • -WinUtilSha256 可选,用于固定校验下载内容。
  • Clash Verge 调整为第一个软件安装项。
  • 新增 Install-Applications.WithConfirmation.ps1:
    • 每个应用单独提示
    • 只有输入 Y 才安装
    • 已安装应用自动跳过
    • 支持 Profile
  • 主脚本继续默认自动请求管理员权限。
  • 重启续跑 Scheduled Task 增加最高权限、电源策略、可用时启动和 4 小时执行窗口。
  • 网站、TXT、PDF 指引已把直接执行命令放到开头。
  • PDF 和 Release 包已重新生成。

默认执行

Unblock-File .\SetupNewPC_Optimized.ps1
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
.\SetupNewPC_Optimized.ps1 -Profile Developer

逐项确认安装

Unblock-File .\Install-Applications.WithConfirmation.ps1
.\Install-Applications.WithConfirmation.ps1 -Profile Full

跳过 WinUtil

.\SetupNewPC_Optimized.ps1 -Profile Developer -SkipWinUtil

详细说明见 SetupNewPC-Guide-v1.1.0.pdf。

SetupNewPC v1.0.0

Choose a tag to compare

@styayur styayur released this 21 Sep 07:56

SetupNewPC v1.0.0

首个稳定工程化版本,面向 Windows 个人工程师与 AI 开发工作站。

主要能力

  • Windows 基础 → 重启门 → 开发环境三阶段流程
  • state.json v3 状态机与逐项安装记录
  • Complete / CompletedWithFailures / AwaitingReboot / Failed 状态
  • Profile:Minimal、Developer、AI、Engineering、Full
  • 软件分组:Core、Developer、AI、Engineering、Personal
  • Winget 已安装检测、失败重试、成功后幂等跳过
  • WSL / VMP / 虚拟化深度检测
  • Docker 安装后执行真实可用性验证
  • System Python + uv 与 Conda 科学计算环境分工
  • WinUtil 默认跳过,必须显式启用并校验 SHA256
  • 重启后续跑 Scheduled Task
  • 最终 PASS / FAIL / SKIPPED 环境报告

推荐使用

Unblock-File .\SetupNewPC_Optimized.ps1
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
.\SetupNewPC_Optimized.ps1 -Profile Developer

AI 工作站:

.\SetupNewPC_Optimized.ps1 -Profile AI -IncludePersonal -DockerSmokeTest

工程科学工作站:

.\SetupNewPC_Optimized.ps1 -Profile Engineering

WinUtil 只有在显式启用并提供 SHA256 时才执行:

.\SetupNewPC_Optimized.ps1 -Profile Full -EnableWinUtil -WinUtilSha256 <64-hex-hash>

详细说明见 Release 附件中的 SetupNewPC-Guide-v1.0.0.pdf。