registerSettings— 向设置中心添加原生扩展设置页面。registerComposerMenuItem— 向输入栏加号菜单添加自定义操作项。registerMessageType— 定义在聊天时间线中原生渲染的自定义消息类型。
设置页面 (registerSettings)
registerSettings(别名为 registerSettingsPage)向 Aether 设置中心内的独立 Extensions 组添加一个设置页面。宿主使用 Aether 内置的设置 UI 骨架(卡片、间距、排版与控件)渲染该页面;扩展仅需提供数据模型。
API 签名
定义 Schema
支持的控件类型
sections[].settings 中的每个设置可指定控件类型:
自动状态持久化
值控件(text, password, textarea, number, toggle, select, segmented, tab, slider)会自动将其数值持久化在扩展存储中,存储键为 settings:<pageId>:<settingId>。
设置页面示例
输入栏菜单项 (registerComposerMenuItem)
registerComposerMenuItem(别名为 registerComposerMenu)向输入栏加号菜单添加自定义操作入口。
API 签名
示例
自定义消息类型 (registerMessageType)
registerMessageType(别名为 registerCustomMessage)注册自定义消息渲染器。当通过 aether.messages.append(type, payload, text) 向对话追加带有匹配 type 的消息时,Aether 会使用你自定义的声明式 UI 树进行渲染。
API 签名
示例
自定义消息会随着对话一同持久化,并在加载聊天时重新渲染。