52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
# 263 ToolApprovalDialog 工具审批对话框
|
|
|
|
## 用途
|
|
|
|
工具执行前请求批准：显示工具名、执行理由和参数预览，允许或拒绝。遵循 Dialog 与 AlertDialog 规则。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
open := true
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
r := mujica.ToolApprovalDialog(c, &open, mujica.ToolApprovalOptions{
|
|
Tool: "delete_files", Args: "{\"glob\":\"*.tmp\"}", Reason: "Clean the build folder.",
|
|
})
|
|
if r.Allowed {
|
|
fmt.Println("run the tool")
|
|
}
|
|
}
|
|
ui.Render(view, 400, 300, 1)
|
|
```
|
|
|
|
签名：`func ToolApprovalDialog(c *ui.Context, open *bool, opts ToolApprovalOptions) ToolApprovalResult`。`Tool` 为空时 panic。
|
|
|
|
## 参数
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `Tool` | `string` | 必填 | 工具名。 |
|
|
| `Args` | `string` | `""` | 参数，合法 JSON 会格式化高亮。 |
|
|
| `Reason` | `string` | `""` | Agent 给出的理由，作为对话框说明。 |
|
|
|
|
## 状态
|
|
|
|
- 打开时焦点在“拒绝”；点击遮罩不做任何事。
|
|
- 参数过长时在预览区内滚动，按钮始终可见。
|
|
|
|
## 事件
|
|
|
|
- `Allowed`：点击允许，或焦点在允许上按 Enter / Space。
|
|
- `Denied`：点击拒绝、焦点在拒绝上按 Enter、或按 Escape。
|
|
- `Element`：对话框面板，关闭时为 nil。
|
|
|
|
## 键盘操作
|
|
|
|
- 打开时焦点在拒绝，Enter 只触发聚焦按钮，必须 Tab 到“允许”才能批准。
|
|
- Escape 等同拒绝；Tab 在对话框内循环；关闭后焦点回到打开者。
|
|
|
|
## 限制
|
|
|
|
- 输入法组合期间按 Escape 仍会拒绝（MyGo 不公开组合状态，`ui/editor.go:73`）。
|