自定义

当宿主需要适配 recorder 的内建行为，但又不想自己重做 AIMD 解析和 record 状态管理时，可以使用这些自定义入口。

Type Plugins

当宿主需要的是“某个 type 的专用行为”，而不是整类字段整体替换时，使用 typePlugins。

type plugin 可以定义：

• 自定义初始值
• 归一化逻辑
• 显示 / 解析钩子
• 某个 AIMD type token 对应的完整自定义 recorder widget

内建的 AiralogyMarkdown widget 也是沿着这条 type plugin 路径实现的，所以如果宿主需要不同的工作流，仍然可以覆盖默认实现。

完整架构说明和端到端示例请参考：

• 类型插件

宿主字段适配器

当宿主应用希望用自己的组件替换或包裹 recorder 的内建字段，但仍保留 AIMD 解析和记录状态管理时，可以使用 fieldAdapters：

<script setup lang="ts">
import { h } from "vue"
import { AimdRecorder } from "@airalogy/aimd-recorder"
</script>

<template>
  <AimdRecorder
    :content="content"
    :model-value="record"
    :field-adapters="{
      step: ({ node, defaultVNode }) =>
        h('step-card', {
          'step-id': node.id,
          'step-number': node.step,
          title: node.title || node.id,
          level: String(node.level),
        }, () => [defaultVNode]),
    }"
  />
</template>

每个 adapter 都会拿到解析后的 AIMD 节点、当前字段值、完整 record 快照、内建本地化消息，以及 recorder 默认生成的 vnode。wrapField 会在 adapter 解析之后继续执行，因此宿主仍然可以保留统一的校验外壳或 assigner UI 包裹层。

字段元数据覆盖

当宿主需要在运行时覆盖显示文案或输入行为，但不想修改 AIMD 源文档时，可以使用 fieldMeta。key 使用和 recorder 事件一致的字段 scope：

<AimdRecorder
  :content="content"
  :model-value="record"
  :field-meta="{
    'var:temperature': {
      title: '温度 (C)',
      description: '宿主应用运行时提供的标签说明',
      examples: [25.0, 37.0],
    },
    'var_table:samples:sample_id': {
      title: '样本 ID',
      description: '试管或孔位标识',
      examples: ['S-001'],
    },
  }"
/>

fieldMeta.title、fieldMeta.description 和 fieldMeta.examples 会覆盖 AIMD kwargs 中的同名显示元数据，用于 recorder 标签和示例占位文案。inputType、placeholder、enumOptions、disabled、assigner 等已有行为字段仍然在同一个 entry 上生效。

标签覆盖

如果只是想微调内建文案，可以覆盖 messages：

<script setup lang="ts">
import { AimdRecorder } from "@airalogy/aimd-recorder"
</script>

<template>
  <AimdRecorder
    locale="zh-CN"
    :messages="{
      step: {
        annotationPlaceholder: '步骤备注',
      },
      table: {
        addRow: '新增一行',
      },
    }"
  />
</template>

兼容说明

AimdProtocolRecorder 仍然导出为已废弃的兼容别名，但新的使用方式建议直接写 AimdRecorder。