{
  "schemaVersion": "1.0",
  "item": {
    "slug": "filesystem",
    "name": "Filesystem",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/AmaoFx/filesystem",
    "canonicalUrl": "https://clawhub.ai/AmaoFx/filesystem",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/filesystem",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=filesystem",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "filesystem",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T05:14:59.166Z",
      "expiresAt": "2026-05-10T05:14:59.166Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=filesystem",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=filesystem",
        "contentDisposition": "attachment; filename=\"filesystem-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "filesystem"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/filesystem"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/filesystem",
    "agentPageUrl": "https://openagent3.xyz/skills/filesystem/agent",
    "manifestUrl": "https://openagent3.xyz/skills/filesystem/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/filesystem/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Filesystem Operations",
        "body": "文件系统操作工具，提供目录列表、内容搜索、批量处理和目录分析功能。"
      },
      {
        "title": "列出目录",
        "body": "# 列出当前目录\nls -la\n\n# 递归列出目录树\nfind . -type f -name \"*.md\" | head -20\n\n# 按类型过滤\nfind . -type f \\( -name \"*.md\" -o -name \"*.txt\" \\)"
      },
      {
        "title": "搜索文件",
        "body": "# 按名称搜索\nfind . -name \"*keyword*\"\n\n# 按内容搜索\ngrep -r \"keyword\" . --include=\"*.md\"\n\n# 不区分大小写搜索\ngrep -ri \"keyword\" . --include=\"*.md\""
      },
      {
        "title": "分析目录",
        "body": "# 统计文件类型\nfind . -type f -name \"*.md\" | wc -l\n\n# 查看目录大小\ndu -sh .\n\n# 找出最大文件\nfind . -type f -exec ls -lh {} \\; | sort -k5 -h | head -10"
      },
      {
        "title": "1. 目录列表",
        "body": "基础列表：\n\nls -la                    # 详细列表\nls -lh                    # 人类可读大小\nls -lt                    # 按修改时间排序\nls -R                     # 递归列表\n\n高级列表：\n\n# 列出特定类型\nfind . -type f -name \"*.md\"\n\n# 按深度列出\nfind . -maxdepth 2 -type f\n\n# 排除特定目录\nfind . -type f -not -path \"*/node_modules/*\""
      },
      {
        "title": "2. 文件搜索",
        "body": "按名称搜索：\n\n# 精确匹配\nfind . -name \"filename.md\"\n\n# 模式匹配\nfind . -name \"*pattern*\"\n\n# 大小写不敏感\nfind . -iname \"*pattern*\"\n\n按内容搜索：\n\n# 基础搜索\ngrep -r \"keyword\" .\n\n# 包含行号\ngrep -rn \"keyword\" .\n\n# 只搜索特定文件\ngrep -r \"keyword\" . --include=\"*.md\"\n\n# 排除目录\ngrep -r \"keyword\" . --exclude-dir=node_modules\n\n正则表达式搜索：\n\n# 使用正则\ngrep -r \"^## \" . --include=\"*.md\"\n\n# 多个关键词\ngrep -r \"key1\\|key2\" .\n\n# 行首/行尾\ngrep -r \"^关键词\" .\ngrep -r \"关键词$\" ."
      },
      {
        "title": "3. 批量操作",
        "body": "批量复制：\n\n# 复制特定类型\nfind . -name \"*.md\" -exec cp {} backup/ \\;\n\n# 复制到多个位置\nfor file in *.md; do cp \"$file\" dir1/ && cp \"$file\" dir2/; done\n\n批量移动：\n\n# 移动特定文件\nfind . -name \"*.log\" -exec mv {} logs/ \\;\n\n# 按条件移动\nfind . -type f -size +1M -exec mv {} large/ \\;\n\n批量删除：\n\n# 删除特定类型\nfind . -name \"*.tmp\" -delete\n\n# 删除空目录\nfind . -type d -empty -delete\n\n# 删除旧文件\nfind . -type f -mtime +30 -delete\n\n批量重命名：\n\n# 使用 rename 命令\nrename 's/old/new/' *.md\n\n# 添加前缀\nfor file in *.md; do mv \"$file\" \"prefix_$file\"; done"
      },
      {
        "title": "4. 目录分析",
        "body": "大小分析：\n\n# 总大小\ndu -sh .\n\n# 各目录大小\ndu -h --max-depth=1 . | sort -hr\n\n# 最大的文件\nfind . -type f -exec ls -lh {} \\; | sort -k5 -hr | head -10\n\n文件类型统计：\n\n# 按扩展名统计\nfind . -type f -name \"*.md\" | wc -l\n\n# 各类型统计\nfind . -type f -name \"*.*\" | sed 's/.*\\.//' | sort | uniq -c\n\n目录结构分析：\n\n# 目录树\ntree -L 2\n\n# 递归深度\nfind . -type d | wc -l\n\n# 文件分布\nfind . -type f | cut -d/ -f1-2 | sort | uniq -c"
      },
      {
        "title": "5. 文件信息查询",
        "body": "文件详情：\n\n# 完整信息\nstat filename\n\n# 只看大小\nls -lh filename\n\n# 只看时间\nls -lt filename\n\n文件内容预览：\n\n# 头部\nhead -20 filename\n\n# 尾部\ntail -20 filename\n\n# 随机行\nshuf -n 10 filename\n\n# 字符数\nwc -c filename\n\n# 行数\nwc -l filename"
      },
      {
        "title": "tree 命令",
        "body": "# 安装\nbrew install tree\n\n# 使用\ntree -L 2 -I 'node_modules|__pycache__'"
      },
      {
        "title": "fd 命令（快速查找）",
        "body": "# 安装\nbrew install fd\n\n# 使用\nfd \"pattern\" /path\nfd -e md .    # 只找 md 文件\nfd -t f .       # 只找文件"
      },
      {
        "title": "ripgrep 命令（快速搜索）",
        "body": "# 安装\nbrew install ripgrep\n\n# 使用\nrg \"keyword\" .\nrg -t md \"keyword\" .\nrg -i \"keyword\" .          # 不区分大小写\nrg --type md \"pattern\" ."
      },
      {
        "title": "1. 搜索优化",
        "body": "使用 fd 或 ripgrep 替代 find 和 grep（更快）\n先缩小搜索范围，再进行深度搜索\n使用文件类型过滤减少搜索时间"
      },
      {
        "title": "2. 批量操作安全",
        "body": "操作前先用 --dry-run 查看会发生什么\n批量删除前先列出文件确认\n重要操作前先备份"
      },
      {
        "title": "3. 目录分析",
        "body": "使用 -max-depth 限制递归深度\n使用 -size 过滤大文件\n使用 -mtime 按时间筛选"
      },
      {
        "title": "查找并处理 Markdown 文件",
        "body": "# 查找所有 md 文件\nfind . -name \"*.md\" -type f\n\n# 统计 md 文件数量\nfind . -name \"*.md\" | wc -l\n\n# 列出最大的 md 文件\nfind . -name \"*.md\" -exec ls -lh {} \\; | sort -k5 -hr | head -5"
      },
      {
        "title": "搜索并替换内容",
        "body": "# 搜索所有匹配项\ngrep -rn \"old_text\" . --include=\"*.md\"\n\n# 替换（使用 sed）\nfind . -name \"*.md\" -exec sed -i '' 's/old_text/new_text/g' {} \\;"
      },
      {
        "title": "清理临时文件",
        "body": "# 删除 .tmp 文件\nfind . -name \"*.tmp\" -delete\n\n# 删除空目录\nfind . -type d -empty -delete\n\n# 删除 30 天前的日志\nfind . -name \"*.log\" -mtime +30 -delete"
      },
      {
        "title": "安全提醒",
        "body": "⚠️ 批量操作前先确认：\n\n列出要操作的文件\n确认不会误删重要文件\n考虑先备份\n\n⚠️ 删除操作不可逆：\n\nrm 删除后无法恢复\n大批量删除前仔细检查\n考虑使用 rm -i 交互式删除\n\n⚠️ 权限注意：\n\n某些操作可能需要 sudo\n系统目录操作要谨慎\n考虑文件权限问题"
      }
    ],
    "body": "Filesystem Operations\n\n文件系统操作工具，提供目录列表、内容搜索、批量处理和目录分析功能。\n\n快速开始\n列出目录\n# 列出当前目录\nls -la\n\n# 递归列出目录树\nfind . -type f -name \"*.md\" | head -20\n\n# 按类型过滤\nfind . -type f \\( -name \"*.md\" -o -name \"*.txt\" \\)\n\n搜索文件\n# 按名称搜索\nfind . -name \"*keyword*\"\n\n# 按内容搜索\ngrep -r \"keyword\" . --include=\"*.md\"\n\n# 不区分大小写搜索\ngrep -ri \"keyword\" . --include=\"*.md\"\n\n分析目录\n# 统计文件类型\nfind . -type f -name \"*.md\" | wc -l\n\n# 查看目录大小\ndu -sh .\n\n# 找出最大文件\nfind . -type f -exec ls -lh {} \\; | sort -k5 -h | head -10\n\n核心功能\n1. 目录列表\n\n基础列表：\n\nls -la                    # 详细列表\nls -lh                    # 人类可读大小\nls -lt                    # 按修改时间排序\nls -R                     # 递归列表\n\n\n高级列表：\n\n# 列出特定类型\nfind . -type f -name \"*.md\"\n\n# 按深度列出\nfind . -maxdepth 2 -type f\n\n# 排除特定目录\nfind . -type f -not -path \"*/node_modules/*\"\n\n2. 文件搜索\n\n按名称搜索：\n\n# 精确匹配\nfind . -name \"filename.md\"\n\n# 模式匹配\nfind . -name \"*pattern*\"\n\n# 大小写不敏感\nfind . -iname \"*pattern*\"\n\n\n按内容搜索：\n\n# 基础搜索\ngrep -r \"keyword\" .\n\n# 包含行号\ngrep -rn \"keyword\" .\n\n# 只搜索特定文件\ngrep -r \"keyword\" . --include=\"*.md\"\n\n# 排除目录\ngrep -r \"keyword\" . --exclude-dir=node_modules\n\n\n正则表达式搜索：\n\n# 使用正则\ngrep -r \"^## \" . --include=\"*.md\"\n\n# 多个关键词\ngrep -r \"key1\\|key2\" .\n\n# 行首/行尾\ngrep -r \"^关键词\" .\ngrep -r \"关键词$\" .\n\n3. 批量操作\n\n批量复制：\n\n# 复制特定类型\nfind . -name \"*.md\" -exec cp {} backup/ \\;\n\n# 复制到多个位置\nfor file in *.md; do cp \"$file\" dir1/ && cp \"$file\" dir2/; done\n\n\n批量移动：\n\n# 移动特定文件\nfind . -name \"*.log\" -exec mv {} logs/ \\;\n\n# 按条件移动\nfind . -type f -size +1M -exec mv {} large/ \\;\n\n\n批量删除：\n\n# 删除特定类型\nfind . -name \"*.tmp\" -delete\n\n# 删除空目录\nfind . -type d -empty -delete\n\n# 删除旧文件\nfind . -type f -mtime +30 -delete\n\n\n批量重命名：\n\n# 使用 rename 命令\nrename 's/old/new/' *.md\n\n# 添加前缀\nfor file in *.md; do mv \"$file\" \"prefix_$file\"; done\n\n4. 目录分析\n\n大小分析：\n\n# 总大小\ndu -sh .\n\n# 各目录大小\ndu -h --max-depth=1 . | sort -hr\n\n# 最大的文件\nfind . -type f -exec ls -lh {} \\; | sort -k5 -hr | head -10\n\n\n文件类型统计：\n\n# 按扩展名统计\nfind . -type f -name \"*.md\" | wc -l\n\n# 各类型统计\nfind . -type f -name \"*.*\" | sed 's/.*\\.//' | sort | uniq -c\n\n\n目录结构分析：\n\n# 目录树\ntree -L 2\n\n# 递归深度\nfind . -type d | wc -l\n\n# 文件分布\nfind . -type f | cut -d/ -f1-2 | sort | uniq -c\n\n5. 文件信息查询\n\n文件详情：\n\n# 完整信息\nstat filename\n\n# 只看大小\nls -lh filename\n\n# 只看时间\nls -lt filename\n\n\n文件内容预览：\n\n# 头部\nhead -20 filename\n\n# 尾部\ntail -20 filename\n\n# 随机行\nshuf -n 10 filename\n\n# 字符数\nwc -c filename\n\n# 行数\nwc -l filename\n\n实用工具\ntree 命令\n# 安装\nbrew install tree\n\n# 使用\ntree -L 2 -I 'node_modules|__pycache__'\n\nfd 命令（快速查找）\n# 安装\nbrew install fd\n\n# 使用\nfd \"pattern\" /path\nfd -e md .    # 只找 md 文件\nfd -t f .       # 只找文件\n\nripgrep 命令（快速搜索）\n# 安装\nbrew install ripgrep\n\n# 使用\nrg \"keyword\" .\nrg -t md \"keyword\" .\nrg -i \"keyword\" .          # 不区分大小写\nrg --type md \"pattern\" .\n\n最佳实践\n1. 搜索优化\n使用 fd 或 ripgrep 替代 find 和 grep（更快）\n先缩小搜索范围，再进行深度搜索\n使用文件类型过滤减少搜索时间\n2. 批量操作安全\n操作前先用 --dry-run 查看会发生什么\n批量删除前先列出文件确认\n重要操作前先备份\n3. 目录分析\n使用 -max-depth 限制递归深度\n使用 -size 过滤大文件\n使用 -mtime 按时间筛选\n常见任务\n查找并处理 Markdown 文件\n# 查找所有 md 文件\nfind . -name \"*.md\" -type f\n\n# 统计 md 文件数量\nfind . -name \"*.md\" | wc -l\n\n# 列出最大的 md 文件\nfind . -name \"*.md\" -exec ls -lh {} \\; | sort -k5 -hr | head -5\n\n搜索并替换内容\n# 搜索所有匹配项\ngrep -rn \"old_text\" . --include=\"*.md\"\n\n# 替换（使用 sed）\nfind . -name \"*.md\" -exec sed -i '' 's/old_text/new_text/g' {} \\;\n\n清理临时文件\n# 删除 .tmp 文件\nfind . -name \"*.tmp\" -delete\n\n# 删除空目录\nfind . -type d -empty -delete\n\n# 删除 30 天前的日志\nfind . -name \"*.log\" -mtime +30 -delete\n\n安全提醒\n\n⚠️ 批量操作前先确认：\n\n列出要操作的文件\n确认不会误删重要文件\n考虑先备份\n\n⚠️ 删除操作不可逆：\n\nrm 删除后无法恢复\n大批量删除前仔细检查\n考虑使用 rm -i 交互式删除\n\n⚠️ 权限注意：\n\n某些操作可能需要 sudo\n系统目录操作要谨慎\n考虑文件权限问题"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/AmaoFx/filesystem",
    "publisherUrl": "https://clawhub.ai/AmaoFx/filesystem",
    "owner": "AmaoFx",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/filesystem",
    "downloadUrl": "https://openagent3.xyz/downloads/filesystem",
    "agentUrl": "https://openagent3.xyz/skills/filesystem/agent",
    "manifestUrl": "https://openagent3.xyz/skills/filesystem/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/filesystem/agent.md"
  }
}