Read
read 负责工作区文件访问,是查看本地文本和图片文件的基础 builtin tool。
当前默认 builtin registry 不注册独立的 write 工具。如果本地自动化需要创建或修改文件,请使用 exec 或 process 执行合适的脚本或命令,再用 read 检查结果。
read
read 支持文本文件和图片文件:
- 文本:按行读取,支持
offset和limit - 图片:支持
png、jpeg、gif、webp - 大图:
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 }