name: 文件管理器 description: | 文件和目录管理工具。创建、读取、写入、删除、移动、复制文件。 搜索文件、列出目录、获取文件信息。 关键词: 文件, 目录, 创建, 删除, 复制, 移动, 搜索, 列出 license: MIT metadata: author: myagent version: “1.0.0”
文件管理器
管理文件和目录的工具集。
何时使用
- 创建、删除、移动、复制文件或目录
- 读取或写入文件内容
- 搜索文件
- 列出目录内容
- 获取文件信息(大小、修改时间等)
指令
列出目录
python scripts/file_ops.py list <path> [--recursive] [--pattern "*.py"]
读取文件
python scripts/file_ops.py read <file_path> [--encoding utf-8]
写入文件
python scripts/file_ops.py write <file_path> --content "内容" [--append]
复制文件
python scripts/file_ops.py copy <source> <destination>
移动/重命名
python scripts/file_ops.py move <source> <destination>
删除
python scripts/file_ops.py delete <path> [--recursive]
搜索文件
python scripts/file_ops.py search <directory> --pattern "*.py" [--content "search_text"]
获取文件信息
python scripts/file_ops.py info <path>
输出格式
所有操作返回 JSON 格式:
{
"success": true,
"operation": "list",
"data": {
"files": ["file1.py", "file2.py"],
"directories": ["subdir"],
"count": 3
}
}
安全说明
- 删除操作不可恢复,谨慎使用
- 写入文件会覆盖原有内容(除非使用 --append)
- 对于重要文件,建议先备份