MujicaUI/docs/components/263-tool-approval-dialog.md

263 ToolApprovalDialog 工具审批对话框

用途

工具执行前请求批准：显示工具名、执行理由和参数预览，允许或拒绝。遵循 Dialog 与 AlertDialog 规则。

最小示例

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）。