Read & Write
read 和 write 负责工作区文件访问,是 skills、代码修改流程和本地自动化最常用的基础工具。
read
read 支持文本文件和图片文件:
- 文本:按行读取,支持
offset和limit - 图片:支持
png、jpeg、gif、webp - 大图:
tools.read.auto_resize_images=true时会自动缩放后再返回
默认文本截断规则来自实现本身:
- 最多
2000行 - 最多
50KB
如果读到上限,返回结果里会提示继续读取时该使用的 offset。
write
write 用来写入文本文件,能力比较直接:
path:目标文件content:要写入的文本append:为true时改成追加- 自动创建父目录
路径解析
- 两个工具都会把相对路径解析到各自配置的
cwd read/write的cwd可以单独配- 如果没有显式配置,运行时会回退到 workspace 路径
示例
读取文件前 200 行:
{ "tool": "read", "path": "README.md", "limit": 200 }
从第 201 行继续:
{ "tool": "read", "path": "README.md", "offset": 201, "limit": 200 }
写入文件:
{
"tool": "write",
"path": "notes/plan.md",
"content": "# Plan\n\nShip the tool docs.\n"
}
追加内容:
{
"tool": "write",
"path": "logs/run.txt",
"content": "done\n",
"append": true
}
相关
- Exec 用来生成或处理这些文件