三层扩展架构
每一层面向 Aether 技术栈的不同部分，语言、加载方式与访问面各不相同。pi.extensions 层与 Pi Coding Agent 层集成 — 注册 Agent 会执行的命令、工具与钩子。aether.extensions 层提供 Script Mod API v2：注册 UI 表面、替换或包装内置 Compose 组件、定义全屏页面、读写应用状态、调用服务并拦截操作。aether.native 层将编译后的 Kotlin DEX 代码直接加载进应用进程，可不受限地访问全部 Android API、Compose 可组合项与 Aether 实现类。
无权限沙箱
扩展是受信任代码。设计上没有权限沙箱。安装扩展意味着信任它可使用 Node.js 运行时、Android 应用上下文、全部 Aether 服务以及 Alpine/Termux 工作区。Native Mod 可直接使用反射、JNI 或 Android API。公开的注册 API 是为了便利与互操作，而非安全边界。请只从你信任的来源安装扩展。一个包，多层
单个package.json 可同时声明全部三层。pi.extensions 数组、aether.extensions 数组与 aether.native 对象彼此独立 — 你可以任意组合，指向不同入口文件，或通过命名导出在 pi.extensions 与 aether.extensions 之间共享同一入口。这样你可以发布一个在 Pi Coding Agent 与 Aether Android 应用中都能正确工作的组合包。
安装扩展
导入的扩展包位于 Aether 管理的 Alpine 文件系统中的~/.aether/extensions。你可以用两种方式安装扩展：
- 导入 zip：打开 设置 → 扩展，点按 导入扩展，选择 zip 文件。Aether 会将包解压到
~/.aether/extensions并立即加载。 - npm 包：通过 Aether 的包管理界面添加包，并在其
package.json中声明aether.extensions条目。Aether 会在加载时发现它，并与本地安装的扩展一并加载。
热重载
触发扩展重载时，Script Mods 与 Pi 扩展会在不重启 Aether 的情况下重载。入口文件不会被自动监视变更。扩展运行时会重新导入更新后的文件，再次调用你的工厂函数，并触发 UI 刷新。Native Mod 仅在应用进程启动时发现并加载；安装、更新、移除或修改 Native Mod 需要重启 Aether。深入了解
包格式
了解全部三层的
package.json 结构，含字段级参考与示例。快速开始
几分钟内构建并安装你的第一个 Script Mod 扩展。
Script Mod API
注册 UI 表面、组件、页面、操作与服务调用。
Native Mods
编写具备完整 Android 与 Compose 访问能力的 Kotlin DEX mod。