适用人群： 用 QwenPaw 干活的人。不管是写代码、改配置、整理笔记，还是日常管理文件，只要你觉得 AI 处理文件时"差那么一点"，这个插件就是给你准备的。

QwenPaw 自带了 read_file、write_file、edit_file，还有 grep_search 和 glob_search。日常基本够用，但碰到下面这些情况就没办法了。

问题一：缺少文件信息查看、文本读取和对比工具

QwenPaw 有 grep_search（搜内容）和 glob_search（按文件名搜），但缺一些更基础的文件操作：

• 想看看文件具体多大、什么时候修改的 → 没有
• 一个无后缀文件，想知道它是什么类型 → 没有
• 两个文件对比一下差异 → 没有
• 想看看某个文件的历史版本列表 → 没有
• 想按行读取文件、只看中间一段，输出带行号的 CSV 方便 AI 处理 → 原生 read_file 虽然支持行范围，但输出是纯文本，没有行号
• 想搜文件里匹配某个模式的所有行，只看匹配行 → 原生有 grep_search，但插件版输出 CSV 格式，更适合 AI 工具链处理

这个插件补了 8 个工具：

• file_tools_listdir — 列出目录内容，支持递归，能看到文件大小、修改时间、权限等属性
• file_tools_info — 看文件/文件夹的元信息
• file_tools_guess — 猜文件类型（读文件头魔数，不看后缀）
• file_tools_diff — 两个文件对比差异，输出 unified diff 格式
• file_tools_history — 查看文件历史版本列表
• file_tools_read_lines — 按行读取，指定起始行和行数，可以只看文件中间一段
• file_tools_read_block — 读取矩形块，像观察窗口一样在文本里上下左右移动
• file_tools_regex — 正则匹配文件内容，只返回匹配行，不读全文

问题二：AI 改文件没有安全网

edit_file 是原地修改，没有备份，没有预览，没有后悔药。改错了就错了。

这个插件补了 6 个修改工具，每个都自动备份：

• file_tools_append — 追加内容到文件末尾
• file_tools_replace_lines — 替换指定行区间
• file_tools_insert_lines — 在指定行前插入内容
• file_tools_delete_lines — 删除指定行区间
• file_tools_replace — 子串查找替换，支持 dry_run（只预览不改）
• file_tools_regex_replace — 正则替换，支持反向引用，也支持 dry_run

dry_run 可以先看看会改成什么样，确认没问题再真改。

问题三：AI 没法安全删文件

edit_file 删不了文件。想让 AI 帮忙删个临时文件，它只能让你自己动手，或者直接跑系统命令删了——但那是真删，找不回来的。

这个插件补了 5 个安全操作工具：

• file_tools_copy — 复制文件/目录，目标目录不存在会自动创建
• file_tools_move — 移动/重命名
• file_tools_trash — 删除到回收站，不是直接删
• file_tools_trash_undo — 从回收站恢复
• file_tools_mkdir — 创建目录

重点是 trash，走回收站，删错了还能找回来。

问题四：AI 改错了没法回退

这是最烦的——所有修改都没有历史记录。改错了要么靠记忆恢复，要么认栽。

这个插件补了 1 个历史回滚工具：

• file_tools_undo — 恢复到指定历史版本（历史版本列表用问题一里的 history 查看）

每次修改工具执行时都会自动备份原文件，所以可以随时回退到任意版本。版本号 1 是最旧的，数字越大越新。

总结

补齐了 QwenPaw 自带的文件工具覆盖不到的日常操作。总共 20 个工具，分五类：

• 信息读取（5 个）：listdir、info、guess、diff、history
• 文本读取（3 个）：read_lines、read_block、regex
• 文件修改（6 个）：append、replace_lines、insert_lines、delete_lines、replace、regex_replace（自动备份）
• 安全操作（5 个）：copy、move、trash、trash_undo、mkdir
• 历史回滚（1 个）：undo

装了之后，AI 能做的事就多了不少，而且更安全——改前有预览，改后有备份，删文件走回收站。

---

安装方式：

推荐使用官方的插件市场安装。

https://platform.agentscope.io/plugins/qwenpaw-plugin-file-tools

项目地址：`https://github.com/One-sixth/qwenpaw-plugin-file-tools