首页/新闻资讯/正文详情

如何开发Aether扩展:Extension API教程,给AI Agent注入自定义设置页与实时Widget

发布时间:2026/11/21 5:27:28 来源:云帆数科 栏目:资讯中心
如何开发Aether扩展:Extension API教程,给AI Agent注入自定义设置页与实时Widget
【免费下载链接】AetherCodex for Android, iOS Mac. | Aether 扶摇项目地址https://gitcode.com/gh_mirrors/aether33/Aether点击查看免费下载Aether 是一款运行在 Android、iOS 与 Mac 上的 AI Agent 应用被称为口袋里的 Codex。它最大的亮点之一是开放的Extension API你只需一个包含 TypeScript 脚本的 npm 包就能给 Aether 的 AI Agent 注入自定义设置页、实时 Widget、命令、拦截器等能力。本教程带你从零搭建第一个 Aether 扩展包理解Surface 表面插槽 声明式 UI 树 原生设置页三件套并附上官方示例与常见坑位。一、先看懂Aether 扩展包的三种形态Aether 沿用 Pi Coding Agent 的可信代码扩展模型一个扩展包可以同时包含三种能力完整定义见 docs/AETHER_EXTENSIONS.md形态配置字段特点Pi 扩展pi.extensionsAgent 工具、命令、hooks与 Pi 生态兼容Script 扩展aether.extensionsTypeScript/JS 编写热重载可直接改 UI 与应用逻辑Native Modaether.nativeKotlin/DEX 编译产物可直接调用 Android 与 Compose需重启加载包结构非常直观本质上就是一个package.json加入口脚本{ name: my-aether-mod, version: 1.0.0, pi: { extensions: [./agent.ts] }, aether: { api: { min: 2, max: 2 }, extensions: [./android.ts] } }⚠️ 注意Aether 有意不做权限沙箱——安装扩展即意味着信任它可以访问 Node 运行时、Android 应用上下文与本地工作区。请只安装你信任的扩展。导入后的扩展会放在 Aether 托管的 Alpine 文件系统中~/.aether/extensions所有入口脚本都被监听文件改动后自动原子化热重载加载失败时保留上一个可用运行时错误会显示在 Extensions 页面上。二、一键搭建创建并导入你的第一个扩展1. 克隆仓库获取参考代码git clone https://gitcode.com/gh_mirrors/aether33/Aether2. 安装类型声明包只含类型声明运行时实现由 Aether 注入npm install --save-dev baimoqilin/aether-extension-api声明源码位于 packages/extension-api/src/index.tsAetherExtensionAPI接口就是你在扩展里能拿到的全部能力ui、host、services、state、storage、messages以及一系列register*方法。3. 编写入口脚本。官方示例 examples/aether-extension/index.ts 是最小完整参考import { defineAetherExtension, ui } from baimoqilin/aether-extension-api; export const activateAether defineAetherExtension((aether) { aether.registerSurface(chat.composer.top, { id: quick-tools, render: ({ storage }) ui.card([ ui.row([ ui.button(Count ${storage.count ?? 0}, increment, { tone: neutral }), ui.button(Prefill, prefill), ], { wrap: true }), ]), }); });4. 打包导入将目录压缩为 zip在 Aether 的设置 → Extensions扩展页中点击导入即可导入逻辑实现于 PiExtensionManager.kt会自动处理npm ci --omitdev依赖安装。三、实时 WidgetregisterSurface 与声明式 UI 树想给 AI Agent 界面加一块实时刷新的状态卡片用registerSurface把内容塞进指定插槽即可无需替换任何内置 UI。常用插槽一览插槽位置chat.top聊天顶栏下方chat.list.start/chat.list.end消息列表首/尾chat.composer.top输入框正上方Widget 最佳位置settings.hub设置中枢顶部drawer.header/drawer.footer会话抽屉固定头/尾aether.registerSurface(chat.composer.top, { id: status, order: 10, render: ({ is_running, draft_input, storage }) ui.row([ ui.text(is_running ? Agent running : Ready), ui.text(${String(draft_input).length} chars), ui.text(Count: ${storage.count ?? 0}), ]), });关键点声明式 UI 树ui.text / card / column / row / button / switch / input / progress / web等原语最终由 Aether 用原生 Compose 渲染视觉风格与内置界面完全一致实时性render接收的 context 含is_running、draft_input等公共状态Agent 开始/结束、输入变化都会触发重渲染持久化aether.storage.get/set自动落盘到~/.aether/app-extension-state.json重启不丢响应交互ui.button(Increment, increment)点击后触发你注册的aether.registerAction(increment, ...)再调用aether.invalidate()即可局部刷新。进阶替换、包裹、隐藏内置组件比 Surface 更强的是registerComponent它针对具名内置组件提供before / after / replace / wrap / hide五种模式按order排序、最后一个replace生效aether.registerComponent(chat.composer.skillPicker, { id: remove-native-picker, mode: hide, // 隐藏内置 Skill 选择器 order: 100, });典型目标包括chat.screen、settings.screen、chat.composer.actionTray等。需要完全自由的 HTML 微界面时还有ui.web({ height, html })逃生舱可通过Aether.postMessage()回调回已注册的 action。四、注入自定义设置页registerSettings这是扩展原生感最强的能力registerSettings会在设置的Extensions 分组位于 Reliability 与 Agent Skills 之间里为你生成一整页原生设置沿用 Aether 内置页的卡片、间距与字体——你只提供数据不能覆盖样式。aether.registerSettings({ id: preferences, icon: settings, title: Preferences, subtitle: Extension behavior, sections: [{ title: General, settings: [ { id: endpoint, type: text, label: Endpoint, default: https://example.com }, { id: enabled, type: toggle, label: Enabled, default: true }, { id: mode, type: select, label: Mode, options: [ { value: fast, label: Fast }, { value: quality, label: Quality }, ], default: fast }, ], }], });支持的控件text、password、textarea、number、toggle、select/dropdown、segmented、tab、slider、button、link、label、divider等完整枚举见 AetherSettingType值按扩展 × 页 × 设置项三元组自动持久化热重载后自动恢复支持categories二级分类先显示分类列表再进入子页AI 也能改你的设置Aether Agent 可通过aether_config_get({ categories: [extensions] })查看该页并用aether_config_set替你调整开关和取值。五、让扩展活起来状态、服务与拦截Script Mod 与 Aether 内核之间还有三条通道接口定义见 docs/AETHER_EXTENSIONS.mdaether.state读写公共状态如draft_input预填输入框、selected_model_key切模型、agent_mode_enabled支持transaction批量操作await aether.state.transaction([ { path: draft_input, value: Review the current changes. }, { path: agent_mode_enabled, value: true }, ]);aether.services可发现、可替换的服务注册表内置skills、state等高优先级注册可覆盖核心实现const skills await aether.services.invoke(skills, list);aether.intercept拦截内置操作如chat.new、skills.selection返回{ cancel: true, reason }即可阻止操作——比如锁定某个 Skill 不允许取消。此外还有低层aether.host.invoke()桥覆盖app.sendMessage、app.newChat、app.setModel、runtime.execute执行 Alpine/Termux 命令等方法详见宿主方法表。六、官方示例与生态扩展巡礼仓库自带可直接导入的参考实现examples/aether-extension/Pi Aether 双形态组合包含输入框上方卡片、原生设置页、before_send事件改写是最推荐的新手起点examples/global-skills-mod/展示如何用声明式 UI 替换原生 action tray、直写 Aether 原生 Skill 选择服务并新增全局 Skills 页——组合 UI 替换 真实应用状态的标准范式。仓库extensions/目录下还有三个生产级扩展可作进阶阅读扩展能力pi-mcp-adapter/接入任意 MCP ServerOAuth、工具审批、资源面板pi-subagents/多 Agent 编排、调度、独立视图pi-web-access/数十种搜索/抓取后端与网页提取七、常见坑位与最佳实践清单热重载是原子的所有脚本工厂必须全部加载成功才会替换运行时失败会保留旧运行时并在 Extensions 页报错。aether.api的min/max版本不兼容会直接拒绝加载Native Mod 需重启DEX 类路径只在进程启动时发现增删改 Native Mod 必须重启 Aether崩溃循环时 Aether 会自动进入Native Mod Safe Mode跳过全部 Native Mod 但保留脚本扩展可在扩展页一键重新启用依赖自动安装zip 导入时有 lockfile 走npm ci --omitdev否则npm install --omitdev捆绑的node_modules会原样使用只做数据不碰样式设置页与 Surface 的视觉由 Aether 原生渲染别想着自定义布局需要自由样式请用ui.web命名规范与 Pi 共用的包把 Pi 工厂作为default exportAether 工厂导出为activateAether即可一份代码两端运行。照着 examples/aether-extension/ 改三行代码你就已经拥有第一个能跑在 AI Agent 里的实时 Widget 和原生设置页了。更多细节请阅读 docs/AETHER_EXTENSIONS.md 的完整 API 说明。赞分享【免费下载链接】AetherCodex for Android, iOS Mac. | Aether 扶摇项目地址https://gitcode.com/gh_mirrors/aether33/Aether点击查看免费下载相关推荐APITable扩展开发Widget系统与自定义功能APITable扩展开发Widget系统与自定义功能 本文详细介绍了APITable Widget SDK的开发环境搭建、自定义数据列类型与公式开发、自动化机后端前端低代码协同办公企业应用数据库Voyager 1.4.7 更新解读收藏对话库、回复完成通知与 Gemini UI 兼容性修复Voyager 1.4.7 更新解读收藏对话库、回复完成通知与 Gemini UI 兼容性修复 本篇技术指南围绕 Voyager 增强套件Gemini、AIAI 应用前端插件系统提示工程终极Ownphotos API开发指南从零开始扩展自定义功能终极Ownphotos API开发指南从零开始扩展自定义功能 Ownphotos是一个强大的自托管Google Photos替代方案提供了照片管理、人脸识别上一篇OpenScholar 官方实现深度解析基于 peS2o 检索与自反馈循环的科研文献综述生成管线下一篇bk-cmdb 业务容器拓扑树缓存接口get_biz_kube_cache_topo解析一次请求取回 Cluster、Namespace、Workload 全量层级创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

magpie 同名撞车全解析:45+ 编码代理的模型管理工具,如何和窗口缩放版各取所需
magpie 同名撞车全解析:45+ 编码代理的模型管理工具,如何和窗口缩放版各取所需

magpie 同名撞车全解析:45 编码代理的模型管理工具,如何和窗口缩放版各取所需 【免费下载链接】magpie Every agents model. One place. Codex on DeepSeek, Claude Code on Kimi, from the menu bar. 项目地址: https://gitcode.com/gh_mirrors/magpi… · 2026/11/21 5:27:27

9Drive 流式传输设计解析:为什么上传大文件不落盘、数据直连云盘
9Drive 流式传输设计解析:为什么上传大文件不落盘、数据直连云盘

【免费下载链接】9drive 9Drive is a storage gateway web app for connecting multiple Google Drive accounts into one virtual storage dashboard. Users can connect Google Drive accounts, track quota, upload files, organize files with virtual folders, preview fi… · 2026/11/11 1:24:49

Pot-Desktop 完整指南:跨平台划词翻译与截图 OCR 软件三分钟上手
Pot-Desktop 完整指南:跨平台划词翻译与截图 OCR 软件三分钟上手

Pot-Desktop 完整指南:跨平台划词翻译与截图 OCR 软件三分钟上手 【免费下载链接】pot-desktop 🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition. 项目地址: https://gitcode.com/GitHub_Trending… · 2026/11/18 8:08:07

黄石电工证哪里考官方报名入口怎么找?外省证转过来能用吗?
黄石电工证哪里考官方报名入口怎么找?外省证转过来能用吗?

黄石电工证哪里考官方报名入口怎么找?外省证转过来能用吗? 之前考的证在外省能不能转过来?这是很多想考黄石电工证的工友最关心的问题。尤其是从外地来黄石打工、创业的人,手里拿着老家的电工证,但不确定能不能在黄石上岗、能不能参加考试、能不能换证。… · 2026/11/21 5:26:32

技校电工证查询多少钱?实操考试心里没底怕挂科?过来人教你避坑
技校电工证查询多少钱?实操考试心里没底怕挂科?过来人教你避坑

技校电工证查询多少钱?实操考试心里没底怕挂科?过来人教你避坑 实操考试心里没底怕挂科?技校电工证查询多少钱?这些问题,我以前也纠结过。作为驻马店本地的房建工程从业者,去年为了转岗做电工,我硬着头皮去考了低压电工证,结果实操考试差点挂科,现在… · 2026/11/21 5:26:32

技校给的电工证怎么转异地 郑州报考避坑指南
技校给的电工证怎么转异地 郑州报考避坑指南

技校给的电工证怎么转异地 郑州报考避坑指南 实操考试心里没底怕挂科?你不是一个人。每年郑州金水区有上千名建筑工人、设备操作员、维修师傅在考电工证,但真正能一次过的人不到30%。今天咱们就聊聊技校给的电工证怎么转异地,顺便说说郑州报考避坑指南… · 2026/11/21 5:26:32

尉氏低压电工证培训在哪考才不白交钱
尉氏低压电工证培训在哪考才不白交钱

尉氏低压电工证培训在哪考才不白交钱 你是不是也担心自己报了尉氏低压电工证培训,结果考试没过,钱就打水漂了?我见过太多人因为选错培训机构,花了几千块,最后连报名资格都没拿到。别急,今天咱们就从一个真实的案例说起,帮你把尉氏低压电工证培训这条路… · 2026/11/21 5:26:32

宿州市咨询考电工证怎么报名学历不高也能报
宿州市咨询考电工证怎么报名学历不高也能报

宿州市咨询考电工证怎么报名学历不高也能报 你是不是也觉得学历不高怕报不上名?别担心,现在考电工证真的不看你有没有大学文凭,只要你符合条件,一样能报名考试。宿州市咨询考电工证怎么报名?今天我就从零开始,告诉你怎么做,别再被那些复杂的流程搞糊涂… · 2026/11/21 5:26:32

有毕业证没有电工证 电工证上岗必备怎么解决
有毕业证没有电工证 电工证上岗必备怎么解决

有毕业证没有电工证 电工证上岗必备怎么解决 之前考的证在外省能不能转过来,这是很多在外地工作、回老家发展的朋友最关心的问题。如果你手里有毕业证,却没有电工证,那在很多岗位上是“卡”不住的,尤其是在建筑、电力、施工等对安全要求高的行业,… · 2026/11/21 5:25:32

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码