读取指定路径的本地文件内容，允许 AI 查看文件代码或文本。

向指定路径写入或覆盖文件内容，常用于生成/修改代码,允许 AI 修改文件代码或文本。

列出指定目录下的所有文件和文件夹名称（已自动忽略 node_modules 等大文件夹）。当你不确定项目结构、找不到某个文件在哪里时，必须先调用此工具,辅助 AI 了解项目结构。

在本地终端安全运行 shell 命令（如 npm test, git status, npm run build）。当修改代码后需要验证是否报错，或者需要安装依赖、运行构建时使用此工具。

当需要安排下属专家执行具体工作时调用此工具。每次只能派发一个任务，等下属汇报结果后，再派发下一个。

语义化检索整个本地代码库。当不知道某段功能、组件、路由在哪里时，调用此工具通过关键词或功能描述找出最相关的真实代码片段。

扫描整个本地代码库（js/ts/jsx/tsx文件），调用 Gemini Embedding API 构建/重构本地向量索引。当项目代码发生重大变化后，或者首次使用 searchCodebase 前，必须调用此工具构建索引。