用途:在 Windows 平台上用 PowerShell 7.x 进行系统管理,并依据用户配置文件中的偏好(包管理器、路径、Python/Node 管理器等)执行操作。
主要能力:环境校验脚本 scripts/Verify-ShellEnvironment.ps1;加载配置文件 . $HOME.admin\scripts\Load-Profile.ps1 后调用 Load-AdminProfile -Export 与 Show-AdminSummary;按偏好选择 scoop、winget 或 chocolatey 安装包;按偏好选择 uv、pip、conda、poetry 处理 Python,选择 npm、pnpm、yarn、bun 处理 Node;提供 Bash 到 PowerShell 的命令对照;PATH 与环境变量的永久设置;.wslconfig 编辑与 wsl --shutdown;安装前后检查与更新工具状态。
使用方式:先运行环境校验脚本,再加载配置文件;安装包前读取 $AdminProfile.preferences.packages.manager 并据此选择命令;安装后更新 $AdminProfile.tools 并保存为 JSON。执行策略可用 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 设置。
适用场景:Windows 本机开发环境搭建与日常维护、包管理器统一、PATH 与环境变量管理、WSL 资源配置。
限制:仅适用于 Windows 与 PowerShell 7.x;WSL 操作、MCP 服务器、服务器置备分别交由 admin-wsl、admin-mcp、admin-devops 处理;已知问题与排错见 references/OPERATIONS.md。