HugoAura | 安装
所以.. 启航吧
厌倦了每次重启后都被还原工整的桌面? 期待着老师下课时忘记点击 "下课锁屏" 按钮? 烦恼于自己成为了一名 "无实权" 的电教委? 抑或是......
自从众多学校开始部署希沃集控, "冰点还原"、"班主任巡视"、"屏幕锁" 等话题不绝于耳。诚然, 希沃集控给学校统一管理设备带来了巨大便利, 但也给电子白板栓上了一道 "无形的枷锁"。
无论你来这里的目的是什么... 但我相信, 我们都有一个共同的目标: 打破这道枷锁, 获得我们 "电教委的自由", 对吧?
所以... 启航吧。
Warning
在继续前, 建议您确保自己拥有以下资质或能力, 否则, 我不推荐您尝试 HugoAura:
- 基本的设备运维能力 (帮助老师解决使用问题, 设备日常维护 (e.g. 清理桌面), 处理突发情况 ...)
- 对 Windows OS 的基本了解 (下载文件, 解压文件, 移动文件, 打开命令行 ...)
- 基本的搜索与信息筛查能力 (遇到安装问题时查看 Wiki / Issues / 搜索互联网 ...)
Caution
请确认您待操作的设备符合以下条件:
- 兼容希沃管家的电子白板设备
- 运行 Windows OS 10 +
- 运行与 HugoAura 兼容的希沃管家版本
Important
请确认您具有以下操作条件:
针对手动安装:
- 至少 15 分钟的空余时间 (对于高级用户, 可能需要至少 5 分钟的空余时间)
- 基本设备访问权限 (不要操作了一半被老师逮住了 TwT)
针对一键安装:
- 大约 3 分钟的空余时间
- 基本设备访问权限
〇、选择安装方式
您可以选择使用一键安装脚本, 或完全手动安装。
Important
如无特殊需求, 建议使用一键安装。
如果担心一键安装可能存在恶意行为, 请使用手动安装。但实际上, 一键安装使用的所有资源都是:
- 开放源代码 (一键安装的具体实现)
- 公开 (使用的预 patch ASAR 包, 可自行解包)
的。
一、开始 - 下载 HugoAura 源代码
方式一: Git
Warning
不适用于网络环境较差的用户
- 从 Git 官方网站 下载 Windows 平台的 Git 安装包。
-
运行安装包, 使用默认选项进行安装, 直到安装完成。
-
启动
cmd。 -
在命令提示符中, 依次输入:
> cd Downloads
> git clone https://github.com/HugoAura/Seewo-HugoAura.git
Tip
您也可以将代码 clone 到其他位置, 如果您喜欢的话。
- 在看到如上图所示的输出后, 打开文件资源管理器, 进入
下载 - HugoAura, 确保看到如下图的目录结构:
- 🎉 好啦, 这一步已经完成啦 >w<。请继续前往 步骤二 吧。
方式二: 直接下载源代码包
- 访问 HugoAura 的 GitHub 代码页, 点击绿色的 "Code" 按钮, 跟随下图操作:
- 导航到下载文件所在的目录, 解压源码包, 然后进入解压后文件夹。确保目录结构如下图所示:
Tip
源码根文件夹所在位置无需与图中一致
- 🎉 祝贺你完成了这一步, 请继续前往 步骤二 吧。
二、安装 Node.JS
需要用 asar 这个 NPM 包解包希沃管家的 ASAR 资源文件, 所以需要装 Node.JS。(HugoAura 本体无需 Node.JS 即可运行)
方法一: 直接安装 Node.JS (不推荐)
-
访问 Node.JS 官网, 点击页面左侧的下载按钮, 下载安装包并安装。
-
安装完成后, 重新启动
cmd, 输入node -v, 检查是否能获得类似下图的输出:
- ⏭ 完成啦, 进入 下一步 吧。
方法二: 使用 NVM (推荐)
Important
如果没有强迫症的话, 还是前面那种方法方便一点。(但是我有
-
去下一个 nvm-windows。(
nvm-setup.exe) -
安装。建议把所有的 Subscribe Notifications 都取消勾选掉。
-
重新启动
cmd, 依次输入:
> nvm install node --lts
> nvm use node --lts
> node -v
检查输出是否类似下图:
- ✨ 好咯, 看看下一步是什么 ↓
三、进入希沃管家 SSA 安装文件夹 & 解除读写限制
Tip
SSA==SeewoServiceAssistant
Important
下述操作步骤中, 请保持
cmd处于管理员权限下。
- 先进入到 SSA 的安装文件夹吧:
> cd "C:\Program Files (x86)\Seewo\SeewoService\SeewoService_*\SeewoServiceAssistant"
应该会进到类似 C:\Program Files (x86)\Seewo\SeewoService\SeewoService_1.5.3.3796\SeewoServiceAssistant 的路径。
-
输入
fltmc filters, 列出文件系统过滤驱动。 -
如果输出中有类似
SeewoKeLiteLady的字样, 执行fltmc unload SeewoKeLiteLady:
Tip
如果设备还未绑定学校, 则不会看到此过滤驱动。
Caution
操作被拒绝?
请尝试使用管理员权限重新启动
cmd
四、解包 ASAR & 移入 HugoAura 资源文件
- 先设个
npm镜像吧:
> npm config set registry https://registry.npmmirror.com
- 进入
resources文件夹, 解包 ASAR:
> cd resources
> npm install asar --global
> asar extract .\app.asar .\app-unpacked
- 打开文件资源管理器, 看看结果:
> explorer .
- 接下来把 HugoAura 的资源文件丢进去:
Caution
复杂步骤, 请仔细操作
将 <HugoAura Source>/src/aura 整个文件夹放到 <SSA 安装目录>/resources/ 下, 变成 <SSA 安装目录>/resources/aura 。
将 <HugoAura Source>/src/core/ 下的所有文件都移到 <SSA 安装目录>/resources/app-unpacked/ 下。
五、给 main.js 打补丁
方法一: 比较极端 (不推荐)
-
使用管理员权限打开
notepad.exe, 然后使用左上角文件 - 打开..., 打开<SSA 安装目录>/resources/app-unpacked/main.js。 -
添加主进程注入:
直接在第一行添加
const hook = require("./hook.js");
- 添加 Zeron 抢先加载注入:
找到第一个
n.m=e, 在其前面加上;const zeron = require("./zeron.js");n = zeron(n);
- 调用主进程 Hook:
找到唯一一个
c.canOpenDevTool, 向前找到let f=new s(Object.assign({},{transparent:!0,, 在let f前加上;hook({ central: n, windowName: this.wname, config: c });
- 添加 Preload 注入:
再次找到唯一一个
c.canOpenDevTool, 在其后面直接加上,preload: __dirname + "\\preload.js"
- 好啦... 啊啊 累死了 >.<
方法二: 先格式化吧 (强烈推荐)
-
在设备上安装 VSCode 或其他 IDE。
-
(可选) 安装 Prettier 插件。
-
使用管理员权限启动 VSCode, 左上角
文件 - 打开文件, 打开<SSA 安装文件夹>/resources/app-unpacked/main.js -
有键盘 => 按下
Shift + Alt + F, 无键盘 => 右键 (长按空白区域), 选择 "格式化文档"。 -
如下图所示, 查找并添加 Hook:
第一步: 首行
const hook = require("./hook.js");
第二步:
o.exports;}后换行
const zeron = require("./zeron.js");
n = zeron(n);
第三步: 找到
c.canOpenDevTool, 向上跳到let f = new s(, 在上一行添加hook({ central: n, windowName: this.wname, config: c });
第四步: 在
c.canOpenDevTool后换行添加preload: __dirname + "\\preload.js",
- 🎉 完成!
见证奇迹的时刻!
-
回到命令行, 确认当前是否处在
<SSA 安装目录>/resources目录下。 -
保持在当前目录下, 使用绝对路径运行 HugoAura 源码文件夹下的
scripts/kad.bat。
# 示例
> C:\Users\seewo\Downloads\HugoAura\scripts\kad.bat
- 应该装好了... 看看右上角有没有这个标?
