GalaxyBookEnabler一行命令安装与TestMode演练模式:新手零风险安装完整攻略

原创2026-10-28 23:36:161,627 阅读

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 步:按向导完成选择

向导流程依次为:

  1. 系统兼容性检测:自动识别你的 Wi-Fi 网卡,提示 Quick Share 是否可用(需要 Intel Wi-Fi AX + Intel 蓝牙,兼容矩阵见 PACKAGES.md)
  2. 选择 Galaxy Book 机型:21 款机型按代次分组(Book5 → Book4 → Book3 → Book2),选一款你"最想拥有"的即可
  3. 选择包配置:Core / Recommended / Full / Everything / 自定义(下文详解)
  4. 自动完成:创建开机计划任务、应用注册表伪装、安装所选应用、配置快捷方式

第 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 的全部心法。

登录后查看全文
GalaxyBookEnabler