> Discover all available pages from the documentation index: https://mastra.zisheng.pro/llms.txt

# Processor

Processor 接口已更新为使用一致的命名模式和数据库消息类型。

## 已变更

### Processor 配置从 `name` 改为 `id`

Processor 现在必须提供 `id` 字段，而不再要求 `name`。`name` 字段现在是可选的。此变更与 scorer 和 Agent 等其他 Mastra 实体保持一致。

迁移时，请更新 Processor 定义，将 `id` 作为必填字段。

```diff
import type { InputProcessor } from '@mastra/core/processors';

  const processor: InputProcessor = {
-   name: 'my-processor',
+   id: 'my-processor',
+   name: 'My Processor', // optional
    processInput: async ({ messages }) => {
      // ...
    },
  };
```

### Processor 消息类型从 `MastraMessageV2` 改为 `MastraDBMessage`

Processor 消息类型已从 `MastraMessageV2` 改为 `MastraDBMessage`。Processor 和 scorer 现在使用数据库消息格式及其类型。

迁移时，请更新 Processor 消息类型的导入和用法。

```diff
import type { InputProcessor } from '@mastra/core/processors';
- import type { MastraMessageV2 } from '@mastra/core/agent';
+ import type { MastraDBMessage } from '@mastra/core/agent';

  const processor: InputProcessor = {
    id: 'my-processor',
-   processInput: async ({ messages }: { messages: MastraMessageV2[] }) => {
+   processInput: async ({ messages }: { messages: MastraDBMessage[] }) => {
      // ...
    },
  };
```

## 已移除

### 已弃用的输入 Processor 导出

`@mastra/core/agent/input-processors/processors` 中已移除包含内置 Processor 在内的已弃用输入 Processor 导出。请改用 `@mastra/core/processors`。此变更将 Processor 类型统一到 `Processor` 接口下。

如果使用了 `InputProcessor`，请将其替换为实现 `processInput` 函数的 `Processor`。

```diff
- import { InputProcessor, ModerationProcessor } from '@mastra/core/agent/input-processors/processors';
+ import { Processor, ModerationProcessor } from '@mastra/core/processors';
```

### Memory Processor 导出迁移到 core

`@mastra/memory/processors` 导出已移除。所有 Processor 现在都从 `@mastra/core/processors` 导出。此变更将所有 Processor 导出集中在同一位置。

迁移时，请将导入路径从 `@mastra/memory/processors` 更新为 `@mastra/core/processors`。

```diff
- import { TokenLimiter, ToolCallFilter } from '@mastra/memory/processors';
+ import { TokenLimiter, ToolCallFilter } from '@mastra/core/processors';
```