From d90b61c005501550209f19b50ed9b1ea6d9b9632 Mon Sep 17 00:00:00 2001 From: Minorice <154642983+Minoricew@users.noreply.github.com> Date: Sat, 19 Apr 2025 00:16:29 +0800 Subject: [PATCH] [Update] =w= --- Installation-|-安装.md | 263 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 262 insertions(+), 1 deletion(-) diff --git a/Installation-|-安装.md b/Installation-|-安装.md index 9f45409..c2ff4aa 100644 --- a/Installation-|-安装.md +++ b/Installation-|-安装.md @@ -1,5 +1,266 @@
- +

HugoAura | 安装

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