SWHelper

For use only in non-China regions and exclusively within an internal network environment.

It is strictly prohibited to use on devices connected to the public network.

DISCLAIMER

你可以在 Releases 中下载预编译的二进制文件.

直接安装

你需要先解锁“冰点还原”才能安装本工具，否则只能在首次解锁后手动打开其他磁盘中的主程序（手动运行时需要 右键->以管理员身份运行）

SWHelper 需要在系统启动时自动加载，且需要管理员权限（因为需要创建远程线程）

请按照以下步骤来安装：

1. 放置主程序

从Releases下载 swhelper.exe 并移动到 C 盘根目录下

• 目标路径: C:\swhelper.exe

注意：如果你不想放在 C 盘根目录，请务必修改 wrapper.bat 中的路径配置

2. 配置启动脚本（仅在通过shell:startup自启动时提权需要）

确保你拥有 wrapper.bat 文件，需要将它放入系统的启动文件夹中：

1. 按下 Win + R ，打开“运行”窗口
2. 输入 shell:common startup 并回车
3. 资源管理器将会打开自启动文件夹，将 wrapper.bat 复制进去

3. 关闭 UAC

为了避免wrapper.bat在自启动提权管理员权限时出现弹窗拦截，需要关闭 UAC

1. 以 管理员身份 打开cmd。
2. 复制并执行以下命令：

   reg ADD HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v EnableLUA /t REG_DWORD /d 0 /f
   

3. 执行完毕后，重启生效

自己编译

依赖: nodejs 22.x & npm,terser(npm),make,gcc/mingw,windres

# frontend: 安装依赖及编译
npm install # 安装依赖
node build.js # (可选) 手动编译frontend

# Makefile: 编译 (此处提供交叉编译示例)
# 使用默认参数编译, 将会自动编译 frontend
make CC=x86_64-w64-mingw32-gcc WINDRES=x86_64-w64-mingw32-windres
# 指定允许的机器码(MUUID)编译
make CC=x86_64-w64-mingw32-gcc WINDRES=x86_64-w64-mingw32-windres FLAGS="-DMUUID='\"此处替换为目标机器码,uuid格式\"'"
# 不带图标的编译 (体积更小)
make CC=x86_64-w64-mingw32-gcc WINDRES=x86_64-w64-mingw32-windres FLAGS="-DNOICON"
# 注: 参数可叠加使用，例如 "-Darg1 -Darg2"

# 脚本: 快速交叉编译脚本
bash ./build.sh # MinGW交叉编译脚本 (不是msys2)
# 生成最小构建:
bash ./minbuild.sh # upx+MinGW交叉编译脚本 (不是msys2)

# Makefile: 清理
make clean # 清理全部二进制和编译临时文件
make clean_ctmp # 清理Native编译临时文件
make clean_frontendtmp # 清理Frontend编译临时文件
make cleanall_tmp # 清理全部编译临时文件

修改配置

首次成功运行后，SWHelper会在当前用户目录下生成配置文件

你可以通过修改该文件来更换壁纸或加载插件：

• 配置文件路径: C:\Users\用户名\.swhelper.config

配置文件示例 (.swhelper.config)：

{
  "disableHelper": false,
  "backgroundImage": "file:///C:/Users/Public/Pictures/my_wallpaper.jpg", 
  "plugins": [
    {
      "url": "file:///C:/Users/seewo/my_plugin.js",
      "loadType": "loadOnce"
    }
  ]
}

• disableHelper: 禁用修改工具前端UI，背景替换和插件加载仍生效
• backgroundImage: 设置自定义锁屏背景，将在SWHelper运行时自动替换原有背景，支持本地路径 (file:///...) 或网络图片 (http://...)（不推荐使用网络图片）
• plugins: 插件列表，可注入自定义 JS 代码以自定义功能，loadType等参数解释见"插件开发指南"

插件开发指南

License: MIT