目录文本搜索

要解决什么问题

排查线上问题或审计代码时，你往往要在一整棵目录里找某段字符串或正则：日志里的 error、配置里的账号名、压缩包备份里的关键字。手写 grep -r 能扫明文文件，但遇到 .zip、.rar 嵌套包、GBK 编码的 Windows 日志，或上百 MB 的巨型文件时，流程很容易断在「解压、编码、路径安全」这些细节上。

技能如何工作

本技能通过核心脚本 scripts/search_tool.py 在指定 --path 下递归只读扫描，用 --pattern 做默认正则匹配（不确定时可加 --no-regex 当纯字符串）。

• 文件类型：常见文本与源码（如 .log、.cfg、.md、.json、.py 等）。
• 压缩包：支持 .zip、.rar、.tar、.tar.gz、.tar.bz2、.7z，可嵌套解压后继续搜索。
• 编码：依次尝试 UTF-8、GBK、latin-1。
• 大文件：超过 100 MB 会跳过并给出警告。
• 结果：写入 search_results/ 下带时间戳的文件，不覆盖历史记录；执行后应告知路径并汇总各文件命中行数，必要时摘要关键行。

典型触发表述包括：「在 X 目录下查找 Y」「搜索所有日志中包含 error 的行」「在压缩包里找 Account_Main」等。

适用边界与注意点

解压使用系统临时目录，结束后清理；对 ZIP/TAR 等做防路径遍历（拒绝含 .. 的路径）。不修改任何原始文件。RAR/7z 等依赖可选库与系统 unrar；未安装时脚本会提示，ZIP/TAR 仍可用。