name: file-manager
description: |
文件和目录管理工具。创建、读取、写入、删除、移动、复制文件。
搜索文件、列出目录、获取文件信息。
关键词: 文件, 目录, 创建, 删除, 复制, 移动, 搜索, 列出
license: MIT
metadata:
author: myagent
version: "1.0.0"

File Manager

管理文件和目录的工具集。

When to Use

• 创建、删除、移动、复制文件或目录
• 读取或写入文件内容
• 搜索文件
• 列出目录内容
• 获取文件信息（大小、修改时间等）

Instructions

列出目录

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>

Output Format

所有操作返回 JSON 格式:

{
  "success": true,
  "operation": "list",
  "data": {
    "files": ["file1.py", "file2.py"],
    "directories": ["subdir"],
    "count": 3
  }
}

Safety Notes

• 删除操作不可恢复，谨慎使用
• 写入文件会覆盖原有内容（除非使用 --append）
• 对于重要文件，建议先备份