# 257 ConversationExport · 会话导出

## 用途

选择格式（Markdown、JSON、纯文本）与范围，预览后生成导出文字；写文件由调用方完成。

## 最小示例

```go
var state mujica.ConversationExportState
msgs := []mujica.SessionMessage{{Role: mujica.SessionUser, Text: "Hello"}}
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	if v := mujica.ConversationExport(c, &state, msgs, mujica.ConversationExportOptions{Title: "Greeting"}); v.Exported {
		log.Println(len(v.Content), "bytes to save")
	}
}
ui.Render(view, 400, 300, 1)
```

## 参数

`func ConversationExport(c *ui.Context, s *ConversationExportState, messages []SessionMessage, opts ConversationExportOptions) ConversationExportView`。另有纯函数 `ExportConversation(title, messages, format) string`。

`ConversationExportState`：`Format`（`ExportMarkdown`、`ExportJSON`、`ExportText`）、`Range`（`ExportAll`、`ExportLast`、`ExportSelected`）、`Last`（0 → 10）。

| 字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `Title` | `string` | 必填 | 会话标题，写入导出内容。 |
| `Selected` | `[]int` | nil | `ExportSelected` 使用的消息下标；越界 panic。 |
| `Disabled` | `bool` | false | 禁用。 |

## 状态

格式单选、范围单选（无选中消息时“已选”不可选）、最近 N 条数字框、等宽字体预览、导出按钮、禁用。

## 事件

`Exported`：导出请求；`Content` 为生成的文字，`Format` 为格式。

## 键盘操作

- Tab 依次经过格式组、范围组、数字框、预览、导出按钮；单选组内方向键选择。

## 限制

- 导出不解析消息文字：Markdown 只加标题与作者行，原文原样写入。
- 预览只在格式、范围或消息变化时重新生成。