wip chat sessions 2

2026-10-05 14:24:42 -04:00
1 parent 1367525c12
commit 85b41f6435
@@ -0,0 +1,47 @@
+# 254 SystemPromptEditor · 系统提示编辑器
+
+## 用途
+
+多行编辑系统提示，显示字数，可恢复默认，有未保存标记，Cmd/Ctrl+S 保存。
+
+## 最小示例
+
+```go
+prompt, saved := "You are helpful.", "You are helpful."
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if mujica.SystemPromptEditor(c, &prompt, mujica.SystemPromptEditorOptions{Default: "You are helpful.", Saved: saved}).Save {
+		saved = prompt
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+`func SystemPromptEditor(c *ui.Context, value *string, opts SystemPromptEditorOptions) SystemPromptEditorView`。
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `Default` | `string` | "" | 恢复默认时写回的文字。 |
+| `Saved` | `string` | "" | 最近一次保存的文字；与当前值不同即显示“未保存”。 |
+| `MaxLength` | `int` | 0 | 字数上限：显示 n / 上限，超出时提示并禁止保存。 |
+| `Saving` | `bool` | false | 调用方正在保存，编辑被阻止。 |
+| `Disabled` | `bool` | false | 禁用。 |
+
+## 状态
+
+已保存、未保存（警告色菱形 + 文字）、超出上限（错误提示）、保存中、禁用。
+
+## 事件
+
+`Save`：请求保存当前值；`Restored`：已恢复默认。
+
+## 键盘操作
+
+- Tab：进入文本框，再到恢复默认与保存按钮。
+- Cmd+S（macOS）/ Ctrl+S：保存（有改动且未超限时）。
+
+## 限制
+
+- 超出上限不会截断文字，只阻止保存。