多文件读取工具(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/)。