wip chat sessions 2

docs/components/248-prompt-library.md

@@ -0,0 +1,49 @@
+# 248 PromptLibrary · 提示模板库
+
+## 用途
+
+按分类与搜索浏览提示模板，预览模板，填写 `{{变量}}` 后插入。
+
+## 最小示例
+
+```go
+var state mujica.PromptLibraryState
+templates := []mujica.PromptTemplate{{ID: "1", Category: "Letters", Title: "Invitation", Body: "Invite {{guest}}."}}
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if v := mujica.PromptLibrary(c, &state, templates, mujica.PromptLibraryOptions{}); v.Inserted != "" {
+		log.Println("insert", v.Inserted)
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+`func PromptLibrary(c *ui.Context, s *PromptLibraryState, templates []PromptTemplate, opts PromptLibraryOptions) PromptLibraryView`。另有 `PromptLibraryVariables(body)` 与 `PromptLibraryFill(body, values)`。
+
+`PromptTemplate`：`ID`、`Category`、`Title`（ID 与 Title 必填）、`Body`（`{{name}}` 为变量，名称可含字母、数字、`_.-`）。
+
+`PromptLibraryState`：`Category`（空为全部）、`Query`、`Selected`、`Values`（变量值）。
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `Label` | `string` | "" | 无障碍名称。 |
+| `Disabled` | `bool` | false | 禁用全部操作。 |
+
+## 状态
+
+分类与模板行（选中：Selection 底 + 菱形）、无匹配、未选模板、预览（未填变量以 [名称] 标出，已填值酒红加粗）、插入按钮（变量未填全时禁用）、禁用。
+
+## 事件
+
+`Inserted`：变量已填好的模板正文，非空时由调用方插入输入框。
+
+## 键盘操作
+
+- Tab 依次进入分类列、搜索框、模板列、变量输入框、插入按钮；列内 ↑/↓ 移动；Enter/Space 选择。
+
+## 限制
+
+- 过滤只在模板切片、查询或分类变化时重算。
+- 变量为简单占位替换，不支持条件或循环。