edit - 文件编辑工具
提供行级编辑、搜索替换、插入和删除操作，支持备份和恢复。
概述
edit 工具让智能体能够：
- 替换文件中的特定内容
- 在指定行插入新内容
- 删除指定的行
- 撤销最近的编辑
配置
json
{
"type": "builtin",
"name": "edit",
"description": "编辑文件，支持搜索替换、插入删除",
"config": {
"workDir": "${global.root_dir}/workspace",
"backup": true,
"maxBackups": 10
}
}配置参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
workDir | string | - | 工作目录 |
backup | bool | true | 编辑前是否备份 |
maxBackups | int | 10 | 最大备份数量 |
操作类型
replace - 搜索替换
搜索并替换文件中的内容。
参数：
json
{
"operation": "replace",
"path": "path/to/file.txt",
"search": "要搜索的内容",
"replace": "替换后的内容"
}可选参数：
| 参数 | 说明 |
|---|---|
replaceAll | 替换所有匹配项（默认只替换第一个） |
ignoreCase | 忽略大小写 |
useRegex | 使用正则表达式 |
示例：
json
{
"operation": "replace",
"path": "config.yaml",
"search": "old_value",
"replace": "new_value",
"replaceAll": true
}insert - 插入内容
在指定位置插入新内容。
参数：
json
{
"operation": "insert",
"path": "path/to/file.txt",
"line": 10,
"content": "要插入的内容"
}插入位置：
| line 值 | 说明 |
|---|---|
| 数字 | 在该行之前插入 |
start | 在文件开头插入 |
end | 在文件末尾插入 |
after:pattern | 在匹配行之后插入 |
before:pattern | 在匹配行之前插入 |
示例：
json
{
"operation": "insert",
"path": "README.md",
"line": "after:## 安装",
"content": "\n### 环境要求\n- Go 1.24+"
}delete - 删除内容
删除指定的行或匹配的内容。
参数：
json
{
"operation": "delete",
"path": "path/to/file.txt",
"lines": [5, 6, 7]
}删除方式：
| 参数 | 说明 |
|---|---|
lines | 删除指定行号 |
pattern | 删除匹配的行 |
range | 删除行范围，如 "5-10" |
示例：
json
{
"operation": "delete",
"path": "temp.txt",
"pattern": "^#.*$"
}undo - 撤销编辑
撤销最近的编辑操作。
参数：
json
{
"operation": "undo",
"path": "path/to/file.txt"
}可选参数：
| 参数 | 说明 |
|---|---|
steps | 撤销步数（默认 1） |
使用示例
修改配置值
用户: 把 config.yaml 里的 port 改成 8080
智能体调用:
{
"operation": "replace",
"path": "config.yaml",
"search": "port: 9527",
"replace": "port: 8080"
}在指定位置插入代码
用户: 在 main 函数后面添加一个新函数
智能体调用:
{
"operation": "insert",
"path": "main.go",
"line": "after:func main()",
"content": "\nfunc newFunction() {\n // 新函数\n}"
}删除注释行
用户: 删除所有单行注释
智能体调用:
{
"operation": "delete",
"path": "code.go",
"pattern": "^\\s*//.*$"
}备份机制
自动备份
每次编辑前自动创建备份：
原文件: document.md
备份: document.md.bak.1
备份: document.md.bak.2
...备份管理
bash
# 查看备份列表
ls -la document.md.bak.*
# 恢复到指定备份
cp document.md.bak.2 document.md正则表达式
edit 工具支持使用正则表达式进行高级搜索替换：
正则替换示例
json
{
"operation": "replace",
"path": "data.txt",
"search": "\\b\\d{4}-\\d{2}-\\d{2}\\b",
"replace": "DATE",
"useRegex": true,
"replaceAll": true
}常用正则模式
| 模式 | 说明 |
|---|---|
^ | 行首 |
$ | 行尾 |
\\b | 单词边界 |
\\d+ | 数字 |
\\w+ | 单词字符 |
.* | 任意字符 |
安全限制
工作目录限制
只能编辑 workDir 配置的目录及其子目录中的文件。
备份数量限制
超过 maxBackups 的旧备份会被自动删除。
二进制文件保护
默认不允许编辑二进制文件。
错误处理
| 错误 | 原因 | 解决方案 |
|---|---|---|
pattern not found | 搜索内容不存在 | 检查搜索内容是否正确 |
line out of range | 行号超出范围 | 检查文件行数 |
no backup available | 没有可用的备份 | 确认备份功能已启用 |
binary file | 尝试编辑二进制文件 | 仅编辑文本文件 |
最佳实践
1. 精确匹配
使用足够精确的搜索内容，避免误替换：
json
// 不推荐 - 可能误替换
{"search": "port", "replace": "8080"}
// 推荐 - 精确匹配
{"search": "port: 9527", "replace": "port: 8080"}2. 先读取再编辑
编辑前先读取文件，了解当前内容：
json
// 1. 读取文件
{"operation": "read", "path": "config.yaml"}
// 2. 确认后再编辑
{"operation": "replace", "path": "config.yaml", ...}3. 使用版本控制
重要文件建议使用 Git 管理：
bash
git add document.md
git commit -m "更新文档"