用途：面向在 Windows 上开发或调试脚本与自动化任务的场景，尤其是涉及文件路径、字符编码或标准 CLI 工具时，帮助避免命令执行失败或输出不可读。
主要能力：
- 编码与重定向：说明不同 PowerShell 版本重定向行为的差异。PowerShell 7.4+ 重定向 stdout 时保留字节流，应优先使用原生重定向；仅在旧版 Windows PowerShell 产生不可读日志时，才使用显式 UTF-8 转换。示例：dotnet > log.txt；npm run ... 2>&1。
- 路径与空格：Windows 路径常含空格，必须加引号，如 dotnet build "src/my project/file.fsproj"。在 PowerShell 中，若可执行文件路径以引号开头，必须使用调用运算符 &，如 & "C:\Program Files\dotnet\dotnet.exe" build ...。
- 常见命令陷阱：删除用 Remove-Item -Force，复制用 Copy-Item，移动用 Move-Item，建目录用 New-Item -ItemType Directory -Path。脚本中建议使用完整 cmdlet 而非别名。
- dotnet CLI：快速迭代用 dotnet build --no-restore；干净构建用 dotnet build --no-incremental；后台运行可用 Start-Process dotnet -ArgumentList 'run' -RedirectStandardOutput output.txt -RedirectStandardError error.txt。
- 环境变量：PowerShell 用 $env:VARIABLE_NAME，CMD 用 %VARIABLE_NAME%。
- 长路径：默认 260 字符限制，可用扩展前缀 \?\C:\Very\Long\Path...。
- 排错：命令未识别通常是 PATH 问题；访问被拒多为文件占用或权限不足；编码不匹配多因旧版 shell 重写输出。
限制：仅适用于任务明确匹配上述范围时；输出不能替代针对具体环境的验证、测试或专家审查；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。