跳到主要内容

Read

read 负责工作区文件访问,是查看本地文本和图片文件的基础 builtin tool。

当前默认 builtin registry 不注册独立的 write 工具。如果本地自动化需要创建或修改文件,请使用 execprocess 执行合适的脚本或命令,再用 read 检查结果。

read

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

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

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

  • 最多 2000
  • 最多 50KB

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

路径解析

  • read 会把相对路径解析到它配置的 cwd
  • 如果省略 tools.read.cwd,运行时会回退到由本地 config root 派生的 workspace path
  • tools.read.auto_resize_images=true 时,大图可以自动缩放后再返回

示例

读取文件前 200 行:

{ "tool": "read", "path": "README.md", "limit": 200 }

从第 201 行继续:

{ "tool": "read", "path": "README.md", "offset": 201, "limit": 200 }

相关

  • Exec 用来生成或处理这些文件
  • Process 用于较长时间运行的本地自动化