Skip to main content
Aether Script Mod API v2 提供了高级 API 以深度集成 Aether 原生 UI:
  • 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 签名

示例

自定义消息会随着对话一同持久化,并在加载聊天时重新渲染。