Loop
Loop 课程表是一个 Canopus 模块。使用前需要先安装并启用模块,再通过配套插件导入课表。
请使用 AstroBox NG v2.2.5+,支持 API Level 4 和 CanopusConnect。
什么是 Canopus?
Canopus 是专为 Xiaomi Vela 穿戴设备设计并开发的内核模块开发框架,其包含模块 SDK 与设备端管理器两部分。
Vela 系统基于 NuttX 开发,而 NuttX 支持“内核模块”功能。详见:NuttX 文档
通过 Lua 表盘,我们得以调用 NuttX Shell,并通过 insmod 命令载入编译好的内核模块,并通过调用系统内的任意接口实现各种功能。管理器充当一个载入与管理第三方模块的中介,为用户提供便利。
缺陷在于,内核模块的加载是一次性的,重启即会失效,因此每次重启设备都必须重新切换到对应表盘激活 Canopus 管理器,随后由管理器依次载入安装的其它模块。调用系统接口依赖于每个固件内的不同函数地址,因此同一个模块乃至管理器,都需要专门对每一台设备、每一个固件版本进行专门适配。
简单地说,Canopus 在设备端的管理器比较类似于 Android 的 KernelSU 等项目,但其运作原理更像是 iOS 越狱。
兼容性
| 设备型号 | 支持的固件版本 |
|---|---|
| 小米手环 10 Pro(中国大陆版) | 3.101.043 |
| 小米手环 11(中国大陆版) | 4.100.155、4.100.179 |
旧版支持、现已移除:小米手环 10 Pro 3.101.036,小米手环 11 4.100.139。
安装
1. 安装 Canopus 管理器
打开 AstroBox,连接设备,在资源页搜索「Canopus模块管理器」,安装与设备固件匹配的新版管理器。

安装后切换到管理器激活表盘,点击 Run,等待加载完成。详细操作见管理器使用说明。

2. 安装 Loop 模块
前往爱发电商品页购买模块后,在 AstroBox 登录账号,并绑定购买时使用的爱发电账号。

在资源页搜索「Loop课程表」并安装。新版模块直接安装到管理器,不再使用模块释放表盘。

3. 启用模块
- 在设备上打开 Canopus 管理器,进入「模块」,选择 canopus_loop。
- 点击「启用」并确认,再按管理器提示立即激活或重启设备。
- 如果重启了设备,重新切到管理器激活表盘,点击 Run 载入已启用模块。
请保留管理器激活表盘,设备重启后仍会用到。
4. 安装导入插件
在 AstroBox 插件市场安装或更新「Loop课表导入器」至 0.3.1+。新版通过 CanopusConnect 直接导入,无需安装 Loop Import 快应用。
使用
导入课表
- 从 WakeUp、WeekDown 或 Nexio 导出
.ics课表文件。 - 将设备连接到 AstroBox,确保管理器已激活、Loop 已启用并运行。
- 打开「Loop课表导入器」,选择目标设备;若设备刚连接,先刷新设备列表。
- 选择 ICS 来源和文件,核对课程数量、学期名称与起始日。需要修改时,点击字段旁的编辑按钮并保存。
- 点击「推送到手表」,等待插件显示「推送成功」。
学期起始日通常填写学校第 1 教学周的周一。导入时无需让 Loop 页面保持前台。

查看课表
在设备应用列表中打开 Loop,可查看「今日课表」和「本周」,点击课程查看详情。
「数据管理」中可以刷新或清空课表;清空操作立即生效。课程有变化时,重新导出 ICS 并通过插件推送。
升级与旧版迁移
已使用新版 Loop
通过 AstroBox 安装更新,按管理器提示重启,再通过激活表盘 Run 加载。正常更新保留已有课表,无需执行 Clear Env。
从旧版 Canopus / Loop 迁移
保留原始 ICS 文件,按照 AstroBox 内「Canopus 已全面重构」的提示完成旧版卸载和新版管理器安装,再重新安装、启用 Loop 和导入插件。
旧 Loop Import 快应用不再需要,原有课表请通过新版插件重新导入。
