要在执行点击或滚动操作时按住修饰键（如 Shift、Ctrl 或 Alt），请在这些操作上使用 `text` 参数。这与 `hold_key` 不同，后者在不执行其他操作的情况下按住键一段时间。 Shift+点击（例如，选择一系列项目）： ```json { "action": "left_click", "coordinate": [500, 300], "text": "shift" } ``` Ctrl+点击（例如，在 Windows/Linux 上多选）： ```json { "action": "left_click", "coordinate": [500, 300], "text": "ctrl" } ``` Cmd+点击（例如，在 macOS 上多选）： ```json { "action": "left_click", "coordinate": [500, 300], "text": "super" } ``` Shift+滚动（例如，水平滚动）： ```json { "action": "scroll", "coordinate": [500, 400], "scroll_direction": "down", "scroll_amount": 3, "text": "shift" } ``` 点击/滚动操作中的 `text` 参数接受修饰键，如 `shift`、`ctrl`、`alt` 和 `super`（用于 Command/Windows 键）。

某些应用程序需要时间来响应操作：这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。 ```python hidelines={1..4,-3..} import time def click_at(x, y): ... def click_and_wait(x, y, wait_time=0.5): click_at(x, y) time.sleep(wait_time) # 允许 UI 更新 print("ok") ``` ```typescript hidelines={1..4,-3..} import { setTimeout } from "node:timers/promises"; function clickAt(x: number, y: number): void {} async function clickAndWait(x: number, y: number, waitMs = 500): Promise { clickAt(x, y); await setTimeout(waitMs); // 允许 UI 更新 } await clickAndWait(100, 200); console.log("ok"); ``` ```csharp hidelines={1..5} ClickAndWait(100, 200); Console.WriteLine("ok"); static void ClickAt(int x, int y) { } static void ClickAndWait(int x, int y, double waitSeconds = 0.5) { ClickAt(x, y); Thread.Sleep(TimeSpan.FromSeconds(waitSeconds)); // 允许 UI 更新 } ``` ```go hidelines={1..9,-4..} package main import ( "fmt" "time" ) func clickAt(x, y int) {} func clickAndWaitFor(x, y int, wait time.Duration) { clickAt(x, y) time.Sleep(wait) // 允许 UI 更新 } func clickAndWait(x, y int) { clickAndWaitFor(x, y, 500*time.Millisecond) } func main() { fmt.Println("ok") } ``` ```java hidelines={1..2,-4..} void clickAt(int x, int y) {} void clickAndWait(int x, int y) throws InterruptedException { clickAndWait(x, y, 500); } void clickAndWait(int x, int y, long waitTimeMillis) throws InterruptedException { clickAt(x, y); Thread.sleep(waitTimeMillis); // 允许 UI 更新 } void main() { IO.println("ok"); } ``` ```php hidelines={1..4,-2..} ```ruby hidelines={1..2,-2..} def click_at(x, y) = nil def click_and_wait(x, y, wait_time: 0.5) click_at(x, y) sleep(wait_time) # 允许 UI 更新 end puts "ok" ```

检查请求的操作是否安全有效：这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。 ```python hidelines={1,-3..} display_width, display_height = 1024, 768 def validate_action(action_type, params): if action_type == "left_click": x, y = params.get("coordinate", (0, 0)) if not (0 <= x < display_width and 0 <= y < display_height): return False, "Coordinates out of bounds" return True, None print(validate_action("left_click", {"coordinate": (2000, 100)})) ``` ```typescript hidelines={1..3,-2..} const displayWidth = 1024; const displayHeight = 768; interface ActionParams { coordinate?: [number, number]; } function validateAction(actionType: string, params: ActionParams): [boolean, string | null] { if (actionType === "left_click") { const [x, y] = params.coordinate ?? [0, 0]; if (!(x >= 0 && x < displayWidth && y >= 0 && y < displayHeight)) { return [false, "Coordinates out of bounds"]; } } return [true, null]; } console.log(validateAction("left_click", { coordinate: [2000, 100] })); ``` ```csharp hidelines={1..2,5..7} using System.Text.Json; const int DisplayWidth = 1024; const int DisplayHeight = 768; Console.WriteLine(ValidateAction("left_click", new Dictionary { ["coordinate"] = JsonSerializer.SerializeToElement(new[] { 2000, 100 }) })); static (bool IsValid, string? Error) ValidateAction(string actionType, IReadOnlyDictionary parameters) { if (actionType == "left_click") { int x = parameters["coordinate"][0].GetInt32(); int y = parameters["coordinate"][1].GetInt32(); if (x is < 0 or >= DisplayWidth || y is < 0 or >= DisplayHeight) { return (false, "Coordinates out of bounds"); } } return (true, null); } ``` ```go hidelines={1..4,-5..} package main import "fmt" const ( displayWidth = 1024 displayHeight = 768 ) func validateAction(actionType string, params map[string]any) (bool, string) { if actionType == "left_click" { coord, ok := params["coordinate"].([]any) if !ok || len(coord) != 2 { return false, "Invalid coordinate" } x, y := int(coord[0].(float64)), int(coord[1].(float64)) if !(0 <= x && x < displayWidth && 0 <= y && y < displayHeight) { return false, "Coordinates out of bounds" } } return true, "" } func main() { ok, msg := validateAction("left_click", map[string]any{"coordinate": []any{2000.0, 100.0}}) fmt.Println(ok, msg) } ``` ```java hidelines={1..2,-4..} import com.anthropic.core.JsonValue; static final int DISPLAY_WIDTH = 1024; static final int DISPLAY_HEIGHT = 768; record Validation(boolean valid, String error) {} Validation validateAction(String actionType, Map params) { if (actionType.equals("left_click")) { List coord = (List) params.get("coordinate").asArray().get(); long x = ((Number) coord.get(0).asNumber().get()).longValue(); long y = ((Number) coord.get(1).asNumber().get()).longValue(); if (!(0 <= x && x < DISPLAY_WIDTH && 0 <= y && y < DISPLAY_HEIGHT)) { return new Validation(false, "Coordinates out of bounds"); } } return new Validation(true, null); } void main() { IO.println(validateAction("left_click", Map.of("coordinate", JsonValue.from(List.of(2000, 100))))); } ``` ```php hidelines={1..2,-3..} [2000, 100]]); echo ($valid ? 'true' : 'false') . ' ' . $error . "\n"; ``` ```ruby hidelines={-2..} DISPLAY_WIDTH = 1024 DISPLAY_HEIGHT = 768 def validate_action(action_type, params) if action_type == "left_click" x, y = params.fetch(:coordinate, [0, 0]) unless (0...DISPLAY_WIDTH).cover?(x) && (0...DISPLAY_HEIGHT).cover?(y) return [false, "Coordinates out of bounds"] end end [true, nil] end p validate_action("left_click", {coordinate: [2000, 100]}) ```

保留所有操作的日志以进行故障排除：这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。这是应用程序端辅助代码，没有 API 请求。请参阅 SDK 选项卡了解模式。 ```python hidelines={-3..} import logging def log_action(action_type, params, result): logging.info(f"Action: {action_type}, Params: {params}, Result: {result}") print("ok") ``` ```typescript hidelines={-2..} function logAction(actionType: string, params: unknown, result: unknown): void { console.error( `Action: ${actionType}, Params: ${JSON.stringify(params)}, Result: ${JSON.stringify( result )}` ); } console.log("ok"); ``` ```csharp hidelines={1..3} LogAction("screenshot", null, ""); Console.WriteLine("ok"); static void LogAction(string actionType, object? parameters, object? result) { Console.Error.WriteLine($"Action: {actionType}, Params: {parameters}, Result: {result}"); } ``` ```go hidelines={1..7,-4..} package main import ( "fmt" "log" ) func logAction(actionType string, params map[string]any, result any) { log.Printf("Action: %s, Params: %v, Result: %v", actionType, params, result) } func main() { fmt.Println("ok") } ``` ```java hidelines={-4..} import static java.lang.System.Logger.Level.INFO; static final System.Logger LOGGER = System.getLogger("computer-use"); void logAction(String actionType, Object params, Object result) { LOGGER.log(INFO, "Action: {0}, Params: {1}, Result: {2}", actionType, params, result); } void main() { IO.println("ok"); } ``` ```php hidelines={1..2,-2..} ```ruby hidelines={-2..} require "logger" LOGGER = Logger.new($stderr) def log_action(action_type, params, result) LOGGER.info("Action: #{action_type}, Params: #{params}, Result: #{result}") end puts "ok" ```