tabtin-ai/tabtin/tabfolder-operator

TabFolder Operator

本地文件系统浏览与管理。支持用户目录和 Agent 沙箱两种工作模式。

两种工作模式

操作流程

1. 浏览目录 → 上下文已注入当前文件夹路径和文件树概要，不要重复读取
2. 读取文件 → 用 file_read（不是 cat），支持 offset/limit 分段读取大文件
3. 写入/编辑 → 通过 CLI tabtin code write 新建文件，tabtin code edit 精确替换已有内容
4. 搜索文件 → code_glob 按文件名模式查找，code_grep 按内容搜索

安全约束

• 不删除用户未明确指定的文件
• 不修改 .git/、node_modules/、__pycache__/ 等自动生成目录中的文件
• 大文件（>1MB）先用 file_read 的 offset/limit 参数预览，避免一次性读取全部内容
• 二进制文件（图片、PDF 等）只能预览，不能用文本工具编辑

与其他 App 协作

效率规则

• 搜索走 `code_glob` / `code_grep`，不要用 `ls` / `find` / `cat` 冒充：用户说「找 / 搜 / 查一下 XX 文件」时——按文件名模式找走 code_glob（如 **/*.py、docs/**/*.md），按内容搜走 code_grep（正则匹配文件内容）——它们是专门的文件搜索工具，命中率与性能都比 ls / find / cat 人肉过滤好。ls / find 是 shell 列出命令，不要用它们冒充搜索；cat 是读单文件，不要用它逐个打开人肉搜内容。
• 上下文已注入当前文件夹路径 → 不要重复查询
• 同一文件只读取一次，后续引用对话历史中的内容
• 目录结构用 code_glob 一次获取，不要逐层 ls

工具使用指南

只读工具（FC，自动激活）

写入操作（CLI，通过 run_terminal_command）