脚本功能使用指南

✨ 功能概述

McStartUP 的脚本功能让您可以快速执行各种自动化任务。无论是系统清理、文件备份、网络诊断，还是开发环境配置，都可以通过简单的脚本实现一键执行。

支持批处理 (.bat)、PowerShell (.ps1)、AutoHotkey (.ahk) 三种脚本语言
两种输入方式：选择脚本文件或直接输入脚本内容
灵活的执行选项：显示/隐藏窗口、管理员权限、自定义工作目录
通过 Win+R 快捷启动，无需打开软件

📝 如何添加脚本

方式一：选择脚本文件

如果您已经有编写好的脚本文件：

点击"添加新项目"按钮
选择"脚本"类型
在输入模式中选择"📁 文件路径"
点击浏览按钮，选择您的脚本文件（.cmd/.bat/.ps1/.ahk）
设置别名（用于 Win+R 快速启动）
配置执行选项（显示窗口、管理员权限等）
点击"添加项目"完成

方式二：直接输入脚本内容 ⭐

无需创建文件，直接在界面中编写脚本：

点击"添加新项目"按钮
选择"脚本"类型
在输入模式中选择"✏️ 直接输入"
选择脚本语言（批处理/PowerShell/AutoHotkey）
在文本框中输入脚本内容
设置别名和执行选项
点击"添加项目"完成

💡 提示： 直接输入模式下，脚本内容会保存在配置文件中，执行时自动创建临时文件。这样可以方便地管理和分享脚本。

📚 脚本示例

🗂️ 系统清理脚本

类型：PowerShell 别名：cleanup 管理员：是

一键清理系统临时文件，释放磁盘空间：

# 清理临时文件
Write-Host "开始清理临时文件..." -ForegroundColor Green

$tempPaths = @(
    $env:TEMP,
    "C:\Windows\Temp"
)

$totalSize = 0
foreach ($path in $tempPaths) {
    if (Test-Path $path) {
        $files = Get-ChildItem $path -Recurse -Force -ErrorAction SilentlyContinue
        $size = ($files | Measure-Object -Property Length -Sum).Sum / 1MB
        $totalSize += $size
        Write-Host "清理 $path (约 $([math]::Round($size, 2)) MB)"
        Remove-Item "$path\*" -Recurse -Force -ErrorAction SilentlyContinue
    }
}

Write-Host "清理完成！释放约 $([math]::Round($totalSize, 2)) MB 空间" -ForegroundColor Green
pause

📊 系统信息查看

类型：批处理别名：sysinfo 管理员：否

快速查看系统基本信息：

@echo off
chcp 65001 >nul
echo ========================================
echo 系统信息
echo ========================================
echo.
echo 计算机名: %COMPUTERNAME%
echo 用户名: %USERNAME%
echo 系统: %OS%
echo 当前时间: %date% %time%
echo.
systeminfo | findstr /C:"OS 名称" /C:"OS 版本" /C:"系统类型" /C:"物理内存总量"
echo.
pause

🌐 网络诊断工具

类型：批处理别名：netcheck 管理员：否

检测网络连接状态和 DNS 解析：

@echo off
chcp 65001 >nul
echo ========================================
echo 网络诊断工具
echo ========================================
echo.
echo 正在检测网络连接...
echo.

echo [1] 本地网络配置：
ipconfig | findstr /C:"IPv4" /C:"子网掩码" /C:"默认网关"
echo.

echo [2] DNS 解析测试：
nslookup www.baidu.com
echo.

echo [3] 网络连通性测试：
ping -n 4 www.baidu.com
echo.

echo 诊断完成！
pause

📁 快速打开文件夹

类型：批处理别名：folders 管理员：否

交互式选择并打开常用文件夹：

@echo off
echo 选择要打开的文件夹：
echo.
echo 1. 下载文件夹
echo 2. 文档文件夹
echo 3. 桌面
echo 4. 图片文件夹
echo 5. 退出
echo.
set /p choice=请输入选项 (1-5): 

if "%choice%"=="1" start "" "%USERPROFILE%\Downloads"
if "%choice%"=="2" start "" "%USERPROFILE%\Documents"
if "%choice%"=="3" start "" "%USERPROFILE%\Desktop"
if "%choice%"=="4" start "" "%USERPROFILE%\Pictures"

⚙️ 执行选项说明

显示执行窗口

勾选：脚本执行时会显示命令行窗口，可以看到输出信息和执行进度。适合需要查看输出或交互的脚本。
不勾选：脚本在后台静默执行，不显示窗口。适合不需要交互的自动化任务。

以管理员身份运行

某些操作需要管理员权限（如清理系统文件、修改注册表等）。勾选此选项后，脚本会以管理员权限执行，系统会弹出 UAC 提示。

脚本参数

可以为脚本传递命令行参数。例如，如果脚本需要接收文件路径作为参数，可以在此输入。

工作目录

设置脚本执行时的当前工作目录。如果不设置，默认使用脚本所在目录（文件模式）或临时目录（直接输入模式）。

⚠️ 注意事项

安全提示：

请确保脚本内容来自可信来源
不要执行不明来源的脚本
使用管理员权限时要特别小心

PowerShell 执行策略

McStartUP 会自动使用 -ExecutionPolicy Bypass 参数执行 PowerShell 脚本，无需手动修改系统执行策略。

AutoHotkey 支持

执行 .ahk 脚本需要系统已安装 AutoHotkey。软件会自动查找以下位置：

C:\Program Files\AutoHotkey\AutoHotkey.exe
C:\Program Files\AutoHotkey\v2\AutoHotkey.exe
C:\Program Files (x86)\AutoHotkey\AutoHotkey.exe
注册表中的安装路径

如果未找到 AutoHotkey，执行时会提示安装。下载地址：https://www.autohotkey.com

临时文件管理

使用"直接输入"模式时，脚本会保存到 %TEMP%\McStartUP\ 目录。临时文件在脚本执行期间不会被删除，确保脚本正常运行。系统会在清理临时目录时自动删除这些文件。

🚀 高级技巧

1. 组合使用多个脚本

可以创建一个主脚本，通过 Win+R 调用其他脚本，实现复杂的自动化流程。

2. 使用环境变量

在脚本中使用环境变量（如 %USERPROFILE%、%TEMP%）可以让脚本在不同电脑上通用。

3. 错误处理

在脚本中添加错误处理逻辑，确保脚本执行失败时能给出明确提示。

4. 日志记录

对于重要的自动化任务，建议在脚本中添加日志记录功能，方便排查问题。

📜 脚本功能使用指南