---
tagName: ai-portal.project-conversations
displayName: WrappedAiPortalProjectConversations
description: 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。
category: ""
source: "@next-bricks/ai-portal"
---

# WrappedAiPortalProjectConversations

> 项目会话列表构件，展示项目中的会话记录，支持目标分类、操作菜单。

## 导入

```tsx
import { WrappedAiPortalProjectConversations } from "@easyops/wrapped-components";
```

## Props

| 属性        | 类型             | 必填 | 默认值 | 说明                                                                         |
| ----------- | ---------------- | ---- | ------ | ---------------------------------------------------------------------------- |
| list        | `Conversation[]` | 否   | -      | 会话列表数据，为 undefined 时显示加载状态                                    |
| urlTemplate | `string`         | 否   | -      | 会话详情链接模板，支持使用会话字段插值，如 /conversations/{{conversationId}} |
| actions     | `ActionType[]`   | 否   | -      | 操作菜单配置，每项会话行尾显示可操作的菜单项                                 |
| goals       | `Goal[]`         | 否   | -      | 目标列表，用于显示会话关联的目标名称                                         |

## Events

| 事件          | detail                                                                                                        | 说明                         |
| ------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| onGoalClick   | `Conversation` — { conversationId: 会话ID, title: 会话标题, startTime: 开始时间, goalInstanceId: 目标实例ID } | 点击会话关联的目标标签时触发 |
| onActionClick | `ActionClickDetail` — { action: 操作项配置, item: 所属会话数据 }                                              | 点击操作菜单项时触发         |

## Examples

### 基础使用

展示会话列表，当 list 为 undefined 时显示加载态。

```tsx
<WrappedAiPortalProjectConversations
  list={[
    {
      conversationId: "conv-a",
      title: "标题一",
      description: "这是一段描述",
      startTime: 1757904096,
    },
    { conversationId: "conv-b", title: "标题二", startTime: 1757863597 },
  ]}
/>
```

### 带目标分类

配置 goals 后会话卡片会显示关联的目标名称标签。

```tsx
<WrappedAiPortalProjectConversations
  goals={[
    { instanceId: "GOAL0001", title: "提升研发效率" },
    { instanceId: "GOAL0002", title: "降低故障率" },
  ]}
  list={[
    {
      conversationId: "conv-a",
      title: "关联目标的会话",
      startTime: 1757904096,
      goalInstanceId: "GOAL0001",
    },
    {
      conversationId: "conv-b",
      title: "全局会话（无目标）",
      startTime: 1757863597,
    },
  ]}
/>
```

### 带操作菜单

配置 actions 后每行显示可操作的菜单项。

```tsx
<WrappedAiPortalProjectConversations
  actions={[
    { text: "删除", event: "delete", icon: { lib: "antd", icon: "delete" } },
  ]}
  list={[
    {
      conversationId: "conv-a",
      title: "会话标题一",
      description: "这是一段描述",
      startTime: 1757904096,
      username: "alice",
    },
    { conversationId: "conv-b", title: "会话标题二", startTime: 1757863597 },
  ]}
  onActionClick={(e) => console.log("操作点击:", e.detail)}
/>
```

### 加载状态

list 为 undefined 时显示加载中状态。

```tsx
<WrappedAiPortalProjectConversations />
```