wip chat sessions 2

docs/components/246-welcome-screen.md

@@ -0,0 +1,46 @@
+# 246 WelcomeScreen · 欢迎页
+
+## 用途
+
+新会话的欢迎页：衬线问候、菱形分隔、副标题、能力卡片，以及放置起始提示的插槽。
+
+## 最小示例
+
+```go
+cards := []mujica.CapabilityCard{{Title: "Write", Examples: []string{"Draft a decree"}}}
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if v := mujica.WelcomeScreen(c, mujica.WelcomeScreenOptions{Greeting: "Good evening", Cards: cards}); v.Example != "" {
+		log.Println("ask", v.Example)
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+`func WelcomeScreen(c *ui.Context, opts WelcomeScreenOptions) CapabilityCardsView`。
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `Greeting` | `string` | 必填 | 问候语，空时 panic。 |
+| `Subtitle` | `string` | "" | 副标题。 |
+| `Cards` | `[]CapabilityCard` | nil | 能力卡片，最多三列。 |
+| `Prompts` | `func()` | nil | 起始提示插槽，例如 `SuggestionChips`。 |
+| `Disabled` | `bool` | false | 禁用卡片示例与插槽内容。 |
+
+## 状态
+
+默认、禁用（由 MyGo 置灰）。卡片与示例按钮的状态见 249 CapabilityCards。
+
+## 事件
+
+返回值的 `Example`：点击的示例提示。插槽内组件的事件由调用方自行读取。
+
+## 键盘操作
+
+- Tab 依次经过各卡片的示例与插槽内控件；卡片内 ↑/↓ 在示例间移动；Enter/Space 选择。
+
+## 限制
+
+- 问候语按纯文本显示，不解析 Markdown。