跳到主要内容

Read & Write

readwrite 负责工作区文件访问,是 skills、代码修改流程和本地自动化最常用的基础工具。

read

read 支持文本文件和图片文件:

  • 文本:按行读取,支持 offsetlimit
  • 图片:支持 pngjpeggifwebp
  • 大图:tools.read.auto_resize_images=true 时会自动缩放后再返回

默认文本截断规则来自实现本身:

  • 最多 2000
  • 最多 50KB

如果读到上限,返回结果里会提示继续读取时该使用的 offset

write

write 用来写入文本文件,能力比较直接:

  • path:目标文件
  • content:要写入的文本
  • append:为 true 时改成追加
  • 自动创建父目录

路径解析

  • 两个工具都会把相对路径解析到各自配置的 cwd
  • read / writecwd 可以单独配
  • 如果没有显式配置,运行时会回退到 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 用来生成或处理这些文件