SuperAPI AI 工具集

read

编程与开发

查看项目

更新于 10-16 09:18

技能介绍

用途

Read 是一个文件读取工具,用于读取文件内容并附带行号。它适合在查看源代码、读取配置文件、查阅文档或检查任意文本文件时使用。

主要能力

  • 读取指定文件的文本内容,并在输出中附带行号。
  • 支持通过参数控制读取范围,便于处理大文件。
  • 返回格式为“N\tline_content”,即制表符分隔的行号与行内容,方便引用具体位置。

使用方式

调用时需要提供以下参数:

  • 必需:path(绝对路径)
  • 可选:limit(最大行数)、offset(起始行,0 开始计数)

规则:

  • 始终使用绝对路径,不要使用相对路径。
  • 对大文件使用 limit 与 offset,按 100 至 200 行分块读取。
  • 返回格式为“N\tline_content”(制表符分隔的行号与内容)。

示例:

{"name": "Read", "input": {"path": "/absolute/path/to/file.py"}}

带范围的示例:

{"name": "Read", "input": {"path": "/absolute/path/to/file.py", "limit": 50, "offset": 100}}

工作流程

  • 使用绝对路径:始终提供文件的完整绝对路径。
  • 分块读取:对大文件使用 limit 和 offset,每次读取 100 至 200 行。
  • 检查行号:输出包含行号,可用于引用具体位置。
  • 与编辑配合:编辑文件前先读取,以获取用于 oldText 的精确内容。

适用场景

  • 查看源代码。
  • 读取配置文件。
  • 查阅文档。
  • 检查任意文本文件。

限制

资料中未提供关于平台支持、收费方式、性能上限或文件类型限制的更多说明。