Repository navigation
Releases
Whinset v2.0.0-rc.1
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:
applyrequests 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
ElevationDeniedand 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
whinsetPowerShell module/CLI and copy-pastebeatwin.txtbootstrap. - 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 -RetryExit 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
历史版本提示(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
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 DeveloperAI 工作站:
.\SetupNewPC_Optimized.ps1 -Profile AI -IncludePersonal -DockerSmokeTest工程科学工作站:
.\SetupNewPC_Optimized.ps1 -Profile EngineeringWinUtil 只有在显式启用并提供 SHA256 时才执行:
.\SetupNewPC_Optimized.ps1 -Profile Full -EnableWinUtil -WinUtilSha256 <64-hex-hash>详细说明见 Release 附件中的 SetupNewPC-Guide-v1.0.0.pdf。