GalaxyBookEnabler一行命令安装与TestMode演练模式:新手零风险安装完整攻略
GalaxyBookEnabler一行命令安装与TestMode演练模式:新手零风险安装完整攻略
GalaxyBookEnabler 是一款开源工具,能让你在任何一台 Windows 电脑上解锁三星 Galaxy Book 专属功能:Quick Share 跨设备传文件、Multi Control 一键盘鼠控多台设备、Samsung Notes 和 Galaxy Buds 无缝切换等,且不需要三星硬件。本文面向新手,手把手教你用一行命令完成 GalaxyBookEnabler 安装,并先用 TestMode 演练模式做零风险预演——不碰注册表、不装任何应用,确认一切正常后再正式安装。
GalaxyBookEnabler 能做什么?
GalaxyBookEnabler 通过"设备伪装"(Registry Spoof)让 Windows 系统识别为一台三星 Galaxy Book,从而解锁微软商店中的三星生态应用。核心能力包括:
- 21 款 Galaxy Book 机型档案:从 Book5 Pro 到 Book2,每款都带有真实硬件的 BIOS/DMI 值
- 智能安装器:自动检测 Wi-Fi 网卡兼容性、自动请求管理员权限、差量安装(已装的应用自动跳过)
- 自动开机任务:每次启动自动生效,无需手动操作
- 一键卸载:单条命令完全清理
- 诊断日志:安装过程自动生成日志到
%TEMP%,出问题方便排查
💡 提示:三星现已通过 Galaxy Connect 官方支持部分功能(Multi Control、Second Screen、Storage Share 等)在任意 Windows 11 电脑上使用,无需此工具。但 Quick Share、Camera Share、Samsung Notes、Samsung Settings 等仍需要 GalaxyBookEnabler。详见 README.md。
安装前检查:3 个系统要求
在开始之前,先确认你的电脑满足以下要求(完整要求见 Explainer.md):
| 要求 | 说明 |
|---|---|
| Windows 10/11 64 位 | ARM 架构未测试 |
| PowerShell 7.0 或更高 | ⚠️ 系统自带的 PowerShell 5.1 不兼容,这是新手最常见的坑 |
| 管理员权限 + 联网 | 脚本会自动请求 UAC 提权,无需手动"以管理员运行" |
一次性安装 PowerShell 7:
winget install Microsoft.PowerShell
📌 如果你第一次用
winget,先执行一次winget list接受源协议,否则命令可能卡住。安装完成后,用pwsh(PowerShell 7)代替powershell(5.1)来运行脚本。
一键安装步骤:5 步完成 GalaxyBookEnabler 配置
官方最佳实践是先把脚本下载到本地运行,比直接管道执行更可预测、也方便重复运行。
第 1 步:获取安装脚本
克隆仓库(仓库只读,仅供使用):
git clone https://gitcode.com/gh_mirrors/ga/GalaxyBookEnabler
cd GalaxyBookEnabler
主安装脚本是 Install-GalaxyBookEnabler.ps1,约 9500 行,包含全部安装、卸载、修复逻辑。
第 2 步:打开 PowerShell 7
以管理员身份打开 pwsh(PowerShell 7)终端。
第 3 步:一行命令启动安装器
.\Install-GalaxyBookEnabler.ps1
就这么简单。脚本会自动处理 UAC 提权,并进入彩色分区的交互式向导。
第 4 步:按向导完成选择
向导流程依次为:
- 系统兼容性检测:自动识别你的 Wi-Fi 网卡,提示 Quick Share 是否可用(需要 Intel Wi-Fi AX + Intel 蓝牙,兼容矩阵见 PACKAGES.md)
- 选择 Galaxy Book 机型:21 款机型按代次分组(Book5 → Book4 → Book3 → Book2),选一款你"最想拥有"的即可
- 选择包配置:Core / Recommended / Full / Everything / 自定义(下文详解)
- 自动完成:创建开机计划任务、应用注册表伪装、安装所选应用、配置快捷方式
第 5 步:重启并登录
重启电脑后,登录你的 Samsung 账号,各应用即可正常使用。
TestMode 演练模式:零风险预演安装全过程
🎯 新手强烈建议:正式安装前先跑一遍 TestMode。它能完整模拟整个安装流程,但不修改注册表、不创建计划任务、不安装任何应用——真正做到了零风险。
TestMode 演练命令
.\Install-GalaxyBookEnabler.ps1 -TestMode
运行后,安装器会完整走一遍交互流程,让你在真实界面上预览:
- 系统会检测到什么硬件、给出什么兼容性提示
- 各机型档案下会写入哪些注册表值
- 所选包配置里到底包含哪些应用
看完输出后直接退出即可,系统不会有任何改动。
进阶:非交互式干跑(Autonomous Dry Run)
如果你打算用全参数方式安装(CI / 自动化场景),可以配合 -FullyAutonomous 做干跑,验证参数是否正确:
.\Install-GalaxyBookEnabler.ps1 -TestMode -FullyAutonomous -AutonomousModel Book4Pro -AutonomousPackageProfile Skip -AutonomousInstallSsse:$false
📖 全部参数(机型代码、包配置、区域代码、日志路径等)都有详细说明,参考官方命令参考文档 Explainer.md。
彩蛋:config.plist 生成测试
GalaxyBookEnabler 还支持生成 OpenCore 可用的 SMBIOS 配置值。仓库自带测试用的 tests/fixtures/config.plist,可以先复制到临时目录做零风险演练(写入前会自动生成时间戳备份):
Copy-Item .\tests\fixtures\config.plist $env:TEMP\gbe-config-test.plist -Force; .\Install-GalaxyBookEnabler.ps1 -ConfigurationOnly -FullyAutonomous -AutonomousModel Book4Pro -AutonomousCountryCode US -IncludeFullBiosVersion -ConfigurationPath "$env:TEMP\gbe-config-test.plist"
安装包怎么选?Core / Recommended / Full 对比
安装向导中的包配置决定了最终装多少三星应用,新手按下面的表选就不会错:
| 配置 | 包含内容 | 适合人群 |
|---|---|---|
| Core | Samsung Account、Samsung Settings、Galaxy Connect 等 9 个核心包 | 想最小化安装、先试试效果 |
| Recommended ⭐ | Core + Quick Share、Samsung Notes、Multi Control、Samsung Gallery、AI Select 等全部已验证可用的应用 | 新手首选 |
| Full Experience | Recommended + Samsung Phone、Samsung Find、Quick Search(后者需额外配置) | 想要全套体验 |
| Everything | 全部应用,含 Samsung Recovery / Samsung Update(在非三星硬件上无法工作) | 不推荐 |
| Custom | 按类别手动勾选,含详细说明和警告 | 进阶用户 |
完整的包列表、商店 ID 和硬件要求见 PACKAGES.md。
⚠️ 注意:Quick Share 和 Camera Share 必须搭配 Intel Wi-Fi AX + Intel 蓝牙才能工作;Realtek / MediaTek / Qualcomm 网卡用户可以考虑用 Google Nearby Share 替代。
装完之后:验证、卸载与修复
验证安装
- 应用商店里应能看到 Galaxy Book Experience 等三星应用
- 安装日志自动保存在
%TEMP%\GalaxyBookEnabler_*.log(Win+R 输入%TEMP%按时间找最新的即可),排错时带上它
一键卸载
想完全移除时,一条命令即可:
.\Install-GalaxyBookEnabler.ps1 -Uninstall
它会删除计划任务(GalaxyBookEnabler、GalaxyBookEnabler-MultiControlInit)和安装目录 %USERPROFILE%\.galaxy-book-enabler。已安装的三星应用可以像普通应用一样在"设置 → 应用"里单独卸载,也可以加 Nuke Mode 一并清除全部三星数据。
修复工具
应用出现异常时,主菜单里的 "Reset/Repair Samsung Apps" 提供软重置、硬重置、清除认证、修复权限、重新注册应用、恢复出厂设置等 7 种修复手段,通常能解决大部分"应用不出现 / 无法启动"问题。
新手常见问题 FAQ
Q:这个工具安全吗?会影响保修吗?
A:它只修改重启后会自动重置的易失性注册表键,不改动硬件和固件,不影响保修。而且所有操作都可完整卸载。想先确认行为?跑一遍上文提到的 -TestMode 就行。
Q:为什么提示 PowerShell 版本不对?
A:脚本要求 PowerShell 7.0+,Windows 自带的 5.1 不兼容。执行 winget install Microsoft.PowerShell 后改用 pwsh 启动即可。
Q:安装失败怎么办?
A:优先检查三点——是否以管理员运行、winget 是否可用(winget upgrade --all 更新)、杀毒软件是否拦截。然后带上 %TEMP% 下最新的日志文件去项目 Issues 提问。
Q:能装在真正的三星 Galaxy Book 上吗? A:没必要,这些功能在真机上本来就能用。
Q:Quick Share 为什么用不了? A:这是三星的设计限制——Quick Share 依赖 Intel 的 Wi-Fi Direct 实现,需要 Intel Wi-Fi(AX 及以上为佳)+ Intel 蓝牙,USB 蓝牙小圆棒不行。
📚 延伸阅读:版本更新记录见 CHANGELOG.md;贡献开发流程见 CONTRIBUTING.md;配置生成测试用例见 tests/Install-Configuration.Tests.ps1。
总结一句话:先 -TestMode 演练,再一行命令正式安装,出问题 -Uninstall 一键回滚——这就是新手零风险玩转 GalaxyBookEnabler 的全部心法。