@alint-js/tools-fs

共享文件系统 AgentTools)用于alint插件,其规则允许代理人探索一个项目. createTools(cwd, options?) 返回四个工具,所有相对于 cwd数字 :

• read_file 读取 UTF-8 文件(路径相对于 cwd 或绝对).
• list_files — 列表文件, 有可选的 glob patterns, (中文(简体) ), ignore,以及 directory。 。 。 .
• search_files ——通过子字符串匹配文件路径.
• search_in_files ——匹配文件内容,返回 path:line: snippet 线条.

使用量

import { createTools, DEFAULT_IGNORE_PATTERNS } from '@alint-js/tools-fs'

// Built-in ignores:
const tools = createTools(ctx.cwd)
// Extend the builtins:
const py = createTools(ctx.cwd, { ignore: [...DEFAULT_IGNORE_PATTERNS, '**/.venv/**'] })
// Replace the builtins:
const bare = createTools(ctx.cwd, { ignore: ['**/generated/**'] })

options.ignore 替换 内建( e)git/build/dist/node_modules/vendor; 传播 DEFAULT_IGNORE_PATTERNS 换句话说, per-call忽略了代理总是附加在工具创建时间设置的被忽略列表中. 基础 listFiles 编号 : readFile 编号 : searchFiles 编号 : searchInFiles 也输出.

何时使用

• 使用 当 a ctx.agent 规则需要通用读取/列表/搜索工具来探索一个项目.

不使用时

• 别 用于一个没有代理循环的单一结构化的模型判断,或者当您需要真正的代码搜索(regex/AST/leader)时.