用途：该技能面向授权渗透测试中的 Web 路径与文件枚举，适用于简单 CLI 工作流即可满足的场景，覆盖发现与侦察、漏洞分析阶段，也可用于复测与收尾。
适用时机：需要对已确认的 Web 目标做快速内容发现；只需检查较窄的路由集而不做深度递归；或需要可重复的路径枚举流程用于重测。应避免在目标脆弱或对速率敏感时使用，也不应在阶段目标不支持时进行大范围或递归枚举。
输入：已确认的基础 URL、字典或扩展名列表、线程数、状态码过滤与排除项。
操作流程：先用最贴合假设的最小字典开始；积极过滤噪声，只审查有意义的响应；区分已认证与未认证覆盖范围；将命中结果交由人工验证；保留路径集与所用选项以便重测。
命令语法（目标需替换为已批准的范围内资产）：
基础扫描，含常见扩展名
dirsearch -u https://portal.contoso.com -e php,aspx,html,txt
自定义字典，多个扩展名
dirsearch -u https://portal.contoso.com -w /usr/share/seclists/Discovery/Web-Content/raft-small-words.txt -e php,aspx
排除特定响应码
dirsearch -u https://portal.contoso.com -w paths.txt -x 403,404
输出到文件
dirsearch -u https://portal.contoso.com -e php,aspx -o contoso-dirsearch.txt
带会话 Cookie 的已认证扫描
dirsearch -u https://portal.contoso.com -e php -H "Cookie: session=<token>"
递归扫描，最大深度 3
dirsearch -u https://portal.contoso.com -e php,aspx -r --max-recursion-depth 3
加延迟以避免触发 WAF
dirsearch -u https://portal.contoso.com -e php --delay 0.5
需捕获的证据：确认存在的新路径或文件、暗示隐藏功能的响应模式，以及运行中使用的确切选项。
安全边界：保持请求低影响并符合已批准范围；若应用出现不稳定或触发速率限制，应停止。