script
Destructive
Manage Godot GDScript files: read, write, edit, batch replace, generate tests, and execute code with safety checks.
Instructions
脚本操作。读写: read_script, write_script。编辑: edit_script（行号/search_and_replace）。执行: execute_gdscript（⚠️ 沙箱仅防误操作，不可用于不可信输入。高安全场景请用 ALLOW_EXECUTE_GDSCRIPT=false 或容器隔离）。测试: generate_test, create_test_scene。批量替换: project_replace。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | execute_gdscript: 要执行的 GDScript 代码 | |
| action | Yes | 操作类型 | |
| search | No | project_replace: 搜索文本 | |
| content | No | write_script: GDScript 内容 | |
| dry_run | No | project_replace: 仅预览不写入（默认 false） | |
| replace | No | project_replace: 替换文本 | |
| timeout | No | execute_gdscript: 超时秒数（默认 30） | |
| end_line | No | edit_script: 替换结束行（1-based，含） | |
| overwrite | No | write_script: 覆盖已有文件（默认 false） | |
| extensions | No | project_replace: 文件扩展名（默认 [".gd"]） | |
| godot_path | No | 覆盖 Godot 二进制路径（可选，优先于项目配置和环境变量） | |
| start_line | No | edit_script: 替换起始行（1-based） | |
| indent_mode | No | edit_script: 缩进模式（默认 raw） | raw |
| new_content | No | edit_script: 替换内容 | |
| script_path | No | read_script 用绝对路径；write_script/edit_script/generate_test 用绝对或相对项目路径 | |
| exclude_dirs | No | project_replace: 排除目录（默认 [".godot", ".import"]） | |
| project_path | No | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） | |
| auto_validate | No | edit_script: 自动验证语法并在失败时回滚（默认 true） | |
| load_autoloads | No | execute_gdscript: 省略时自动检测 autoload 引用；显式 true/false 覆盖自动检测 | |
| verify_content | No | edit_script: 期望内容守卫（不匹配则中止） | |
| search_and_replace | No | edit_script: 内容搜索替换模式（提供时忽略 start_line/end_line） |