mirror of
https://github.com/HugoAura/Seewo-HugoAura.git
synced 2026-06-25 02:34:26 +08:00
[Update] =w=
Minorice
@@ -1,5 +1,266 @@
|
||||
<div align="center">
|
||||
<img src="https://s2.loli.net/2025/04/18/OYaZoebFTBmGdDP.png" />
|
||||
<img src="https://s2.loli.net/2025/04/18/Y3pOAvD6IMjgJoN.png" />
|
||||
<h1>HugoAura | 安装</h1>
|
||||
</div>
|
||||
|
||||
## 所以.. 启航吧
|
||||
|
||||
厌倦了每次重启后都被还原工整的桌面? 期待着老师下课时忘记点击 "下课锁屏" 按钮? 烦恼于自己成为了一名 "无实权" 的电教委? 抑或是......
|
||||
|
||||
自从众多学校开始部署希沃集控, "冰点还原"、"班主任巡视"、"屏幕锁" 等话题不绝于耳。诚然, 希沃集控给学校统一管理设备带来了巨大便利, 但也给电子白板栓上了一道 "无形的枷锁"。
|
||||
|
||||
无论你来这里的目的是什么... 但我相信, 我们都有一个共同的目标: 打破这道枷锁, 获得我们 "电教委的自由", 对吧?
|
||||
|
||||
所以... 启航吧。
|
||||
|
||||
> [!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 安装包。
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/qxzLsRnlem6VEO4.png" width="75%" /></div>
|
||||
|
||||
2. 运行安装包, 使用默认选项进行安装, 直到安装完成。
|
||||
|
||||
3. 启动 `cmd`。
|
||||
|
||||
4. 在命令提示符中, 依次输入:
|
||||
|
||||
```
|
||||
> cd Downloads
|
||||
> git clone https://github.com/HugoAura/HugoAura.git
|
||||
```
|
||||
|
||||
> [!TIP]
|
||||
> 您也可以将代码 clone 到其他位置, 如果您喜欢的话。
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/FHOPtlzEd4Z6gTU.png" width="75%" /></div>
|
||||
|
||||
|
||||
5. 在看到如上图所示的输出后, 打开文件资源管理器, 进入 `下载 - HugoAura`, 确保看到如下图的目录结构:
|
||||
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/UmWXwIxTO1PJvlg.png" width="75%" /></div>
|
||||
|
||||
|
||||
6. 🎉 好啦, 这一步已经完成啦 >w<。请继续前往 <a href="">步骤二</a> 吧。
|
||||
|
||||
### 方式二: 直接下载源代码包
|
||||
|
||||
1. 访问 [HugoAura 的 GitHub 代码页](https://github.com/HugoAura/HugoAura), 点击绿色的 "Code" 按钮, 跟随下图操作:
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/CsWMj9J6OUkHntf.png" width="75%" /></div>
|
||||
|
||||
2. 导航到下载文件所在的目录, 解压源码包, 然后进入解压后文件夹。确保目录结构如下图所示:
|
||||
|
||||
> [!TIP]
|
||||
> 源码根文件夹所在位置无需一致
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/UmWXwIxTO1PJvlg.png" width="75%" /></div>
|
||||
|
||||
3. 🎉 祝贺你完成了这一步, 请继续前往 <a href="">步骤二</a> 吧。
|
||||
|
||||
## 安装 Node.JS
|
||||
|
||||
需要用 `asar` 这个 NPM 包解包希沃管家的 ASAR 资源文件, 所以需要装 Node.JS。(HugoAura 本体无需 Node.JS 即可运行)
|
||||
|
||||
### 方法一: 直接安装 Node.JS (不推荐)
|
||||
|
||||
1. 访问 [Node.JS 官网](https://nodejs.org/zh-cn), 点击页面左侧的下载按钮, 下载安装包并安装。
|
||||
|
||||
2. 安装完成后, 重新启动 `cmd`, 输入 `node -v`, 检查是否能获得类似下图的输出:
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/ZwHltVKd2ETYSCo.png" width="75%" /></div>
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
检查输出是否类似下图:
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/dySjUkNhlvPtXFx.png" width="75%" /></div>
|
||||
|
||||
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`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/EfhQRjaLHB9PWMr.png" width="75%" /></div>
|
||||
|
||||
## 解包 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 .
|
||||
```
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/HoWuwpRedZ1Xrnb.png" width="75%" /></div>
|
||||
|
||||
4. 接下来把 HugoAura 的资源文件丢进去:
|
||||
|
||||
> [!CAUTION]
|
||||
> 复杂步骤, 请仔细操作
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/zmURbjoctfTerHq.jpg" width="100%" /></div>
|
||||
|
||||
```
|
||||
将 <HugoAura Source>/src/aura 整个文件夹放到 <SSA 安装目录>/resources/ 下, 变成 <SSA 安装目录>/resources/aura 。
|
||||
将 <HugoAura Source>/src/core/ 下的所有文件都移到 <SSA 安装目录>/resources/app-unpacked/ 下。
|
||||
```
|
||||
|
||||
## 给 `main.js` 打补丁
|
||||
|
||||
### 方法一: 比较极端 (不推荐)
|
||||
|
||||
1. 使用管理员权限打开 `notepad.exe`, 然后使用左上角 `文件 - 打开...`, 打开 `<SSA 安装目录>/resources/app-unpacked/main.js`。
|
||||
|
||||
2. 添加主进程注入:
|
||||
|
||||
> 直接在第一行添加 `const hook = require("./hook.js");`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/VbyGQ6ejX8zuFvt.png" width="75%" /></div>
|
||||
|
||||
3. 添加 Zeron 抢先加载注入:
|
||||
|
||||
> 找到第一个 `n.m=e`, 在其前面加上 `;const zeron = require("./zeron.js");n = zeron(n);`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/atWlrAi7gMXmdnD.png" width="75%" /></div>
|
||||
|
||||
4. 调用主进程 Hook:
|
||||
|
||||
> 找到唯一一个 `c.canOpenDevTool`, 向前找到 `let f=new s(Object.assign({},{transparent:!0,`, 在 `let f` 前加上 `;hook({ central: n, windowName: this.wname, config: c });`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/wZSCmyglTzGL6xh.png" width="75%" /></div>
|
||||
|
||||
5. 添加 Preload 注入:
|
||||
|
||||
> 再次找到唯一一个 `c.canOpenDevTool`, 在其后面直接加上 `,preload: __dirname + "\\preload.js"`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/GVeN5AdYTyZpimH.png" width="75%" /></div>
|
||||
|
||||
6. 好啦... 啊啊 累死了 >.<
|
||||
|
||||
### 方法二: 先格式化吧 (强烈推荐)
|
||||
|
||||
1. 在设备上安装 [VSCode](https://code.visualstudio.com/) 或其他 IDE。
|
||||
|
||||
2. (可选) 安装 Prettier 插件。
|
||||
|
||||
3. 使用**管理员权限**启动 VSCode, 左上角 `文件 - 打开文件`, 打开 `<SSA 安装文件夹>/resources/app-unpacked/main.js`
|
||||
|
||||
4. 有键盘 => 按下 `Shift + Alt +F`, 无键盘 => 右键 (长按空白区域), 选择 "格式化文档"。
|
||||
|
||||
5. 如下图所示, 查找并添加 Hook:
|
||||
|
||||
> 第一步: 首行 `const hook = require("./hook.js");`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/fdwsohXmzlk1826.png" width="75%" /></div>
|
||||
|
||||
> 第二步: `o.exports;}` 后换行
|
||||
|
||||
```
|
||||
const zeron = require("./zeron.js");
|
||||
n = zeron(n);
|
||||
```
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/iRHAQDO4dtbEqyn.png" width="75%" /></div>
|
||||
|
||||
> 第三步: 找到 `c.canOpenDevTool`, 向上跳到 `let f = new s(`, 在上一行添加 `hook({ central: n, windowName: this.wname, config: c });`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/7XQ8sxVIpOfT9FN.png" width="75%" /></div>
|
||||
|
||||
> 第四步: 在 `c.canOpenDevTool` 后换行添加 `preload: __dirname + "\\preload.js",`
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/18/lZsXTd6pFnik5QL.png" width="75%" /></div>
|
||||
|
||||
6. 🎉 完成!
|
||||
|
||||
## ~~见证奇迹的时刻!~~
|
||||
|
||||
1. 回到命令行, 确认当前是否处在 `<SSA 安装目录>/resources` 目录下。
|
||||
|
||||
2. **保持在当前目录下**, 使用绝对路径运行 HugoAura 源码文件夹下的 `scripts/kad.bat`。
|
||||
|
||||
```
|
||||
# 示例
|
||||
> C:\Users\seewo\Downloads\HugoAura\scripts\kad.bat
|
||||
```
|
||||
|
||||
3. 应该装好了... 看看右上角有没有这个标?
|
||||
|
||||
<div align="center"><img src="https://s2.loli.net/2025/04/19/r7Dqv6YuBMOJE5f.png" width="75%" /></div>
|
||||
Reference in New Issue
Block a user