多文件读取工具(read_many_files

用于按路径或 glob 模式读取多个文件:

  • 文本文件:按顺序拼接内容,中间插入 --- {filePath} --- 分隔,末尾附加 --- End of content ---
  • 图片(PNG/JPEG 等)、PDF、音频(MP3/WAV)、视频(MP4/MOV):若显式匹配,返回 base64 数据;
  • 其他二进制文件会被跳过(通过检测空字节)。

参数

  • paths(必填):文件或 glob 模式数组;
  • exclude:排除的模式;
  • include:额外包含的模式;
  • recursive:是否递归(默认 true,实际取决于 **);
  • useDefaultExcludes:是否应用默认忽略(node_modules.git 等);
  • respect_git_ignore:是否遵循 .gitignore

使用示例

read_many_files(paths=["src/**/*.ts"])
read_many_files(paths=["README.md", "docs/**/*.md", "assets/logo.png"], exclude=["docs/OLD_README.md"])
read_many_files(paths=["**/*.js"], include=["**/*.test.js", "images/**/*.jpg"], useDefaultExcludes=False)

注意事项

  • 仅当 paths/include 中明确指定时才会返回图像/PDF/音视频;
  • 处理大量文件或大文件会消耗较多资源;
  • 目录路径需配合通配符使用(如 docs/* 而非 docs/)。