wip chat sessions 2

docs/components/257-conversation-export.md

@@ -0,0 +1,48 @@
+# 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 只加标题与作者行，原文原样写入。
+- 预览只在格式、范围或消息变化时重新生成。