跳转到主要内容
本指南带你创建最小扩展：在聊天输入框上方添加一个按钮，点击后插入预设提示词。你将使用 Aether Script Mod API v2 — 无需 Kotlin 或原生工具链。
1

创建扩展目录

为扩展新建目录并进入：
2

创建 package.json

创建指向入口文件的 package.json：
package.json
aether.extensions 数组告诉 Aether 将哪些文件作为 Script Mod 加载。需要时可列出多个入口文件，此处一个即可。
3

创建扩展入口文件

创建带有表面注册与操作处理程序的 index.ts：
index.ts
defineAetherExtension 包装你的工厂函数，并为 aether API 提供完整 TypeScript 类型。registerAction 将字符串 "insert-prompt" 绑定到写入 draft_input 状态路径的处理程序。registerSurface 将按钮注入 chat.composer.top 插槽 — 即消息输入框正上方。
4

打包为 zip

将目录打包为 zip 归档：
zip 可将包放在归档根目录，或放在恰好一层顶层包目录中。
5

在 Aether 中安装

打开对话抽屉，然后前往 设置 → 扩展 → 导入扩展。选择 my-first-extension.zip。Aether 会将包解压到 ~/.aether/extensions 并立即热加载扩展 — 无需重启。
6

测试扩展

进入聊天界面。你应能在输入框上方看到 Insert summary prompt 按钮。点击它 — Aether 会调用你的 insert-prompt 操作处理程序，用预设文本修补 draft_input。输入框会立刻填入内容。若按钮未出现，打开 设置 → 扩展，确认扩展已列出且已启用。在该页面查看错误日志以排查加载时问题。

​
后续步骤

使用完整 Script Mod API 进一步扩展你的 mod：

UI 表面

在更多聊天与设置插槽中注册内容，或完全替换内置 Compose 组件。

状态 API

读写应用状态路径，包括 draft_input、selected_skill_ids、agent_mode_enabled 等。

页面

添加全屏抽屉页面，通过 TypeScript 驱动原生 Compose 布局。

Native Mods

编写在进程启动时加载的 Kotlin DEX mod，解锁完整 Android 与 Compose 访问能力。