registerComponent：替换或包装 Aether 内置 UI

registerComponent 可修改命名的内置 Compose 目标 — 让你从 Script Mod 中替换、包装或隐藏 Aether 的原生 UI 元素。与在不打扰现有 UI 的情况下添加内容的 surfaces 不同，component 注册会直接介入目标的渲染管线，并可完全移除或重组它。

API 签名

aether.registerComponent(target: string, definition: ComponentDefinition): () => void;

registerComponent 返回一个清理函数。调用它可移除 component 注册，并将目标恢复为先前状态。

可用目标

目标	内置 UI
`app.content`	整个路由后的 Aether 应用内容
`chat.screen`	完整聊天界面
`settings.screen`	完整设置界面
`chat.composer.actionTray`	已选 Skill/MCP/Agent 模式托盘
`chat.composer.skillPicker`	输入栏加号菜单中的 Skill 行

ComponentDefinition 字段

string

此 component 注册的唯一标识符。Aether 用它跟踪同一扩展的注册。若省略，Aether 会根据目标与注册顺序生成一个。

mode

string

为 "before"、"after"、"replace"、"wrap" 或 "hide" 之一。决定此注册如何与目标组件及其他注册交互。默认为 "wrap"。见下方模式语义。

order

number

相对其他针对同一组件的注册的排序优先级。对于 replace 与 hide 模式，order 最高的注册起决定作用。对于 wrap、before 与 after，order 控制层叠顺序。省略时默认为 0。

render

function

返回 ui 节点树的工厂函数。除 "hide" 外所有模式请使用 render 或 tree；hide 会移除组件且不在其位置渲染任何内容。

render: (context: RenderContext) => ui node | Promise<ui node>

tree

object

省略 render 时使用的静态 ui 节点树。

模式语义

模式	行为
`before`	在目标之前立即渲染你的内容，不移除或替换目标
`after`	在目标之后立即渲染你的内容，不移除或替换目标
`replace`	完全替换原生组件。多个扩展对同一目标注册 `replace` 时，`order` 最高者胜出
`wrap`	用你的布局包裹原生组件（或胜出的替换）。在 `render` 树中使用 `ui.core()` 放置被包裹内容。多个 wrapper 从中心向外组合
`hide`	从 UI 中完全移除该组件。`order` 最高的 `hide` 注册起决定作用，规则与 `replace` 相同

示例

Replace

aether.registerComponent("chat.composer.actionTray", {
  id: "replacement",
  mode: "replace",
  order: 100,
  render: () => ui.card([
    ui.text("My replacement tray"),
  ]),
});

Wrap

使用 ui.core() 在布局中放置被包裹的内容：

aether.registerComponent("chat.composer.actionTray", {
  id: "wrapper",
  mode: "wrap",
  render: () => ui.column([
    ui.text("Before the original"),
    ui.core(),
    ui.text("After the original"),
  ]),
});

Hide

aether.registerComponent("chat.composer.skillPicker", {
  id: "remove-native-picker",
  mode: "hide",
  order: 100,
});

来自不同扩展的多个 wrapper 会围绕单一中心组合 — 胜出的 replace 注册，或在无 replace 时的原生组件。Native Mod 组件会完整包裹 Script component 管线，因此 Native 的 replace 对任何 Script 级替换都具有决定性。

概览

Script Mod API

UI 参考

Native Mods

Pi 扩展

示例

registerComponent：替换或包装 Aether 内置 UI

API 签名

可用目标

ComponentDefinition 字段

模式语义

示例

Replace

Wrap

Hide

​API 签名

​可用目标

​ComponentDefinition 字段

​模式语义

​示例

​Replace

​Wrap

​Hide

API 签名

可用目标

ComponentDefinition 字段

模式语义

示例

Replace

Wrap

Hide