文件打包与敏感信息扫描工具教学文档<\/h1>

一、工具概述<\/h2>

1.1 工具简介<\/h3>
这是一个基于Go语言开发的文件打包与敏感信息扫描工具，具备文件打包压缩、敏感文件搜索、文件信息查看等功能。工具采用模块化架构设计，支持命令行操作，能够智能处理被占用的文件。<\/p>

1.2 核心功能特性<\/h3>

文件打包压缩<\/strong>：支持ZIP和GZIP格式，具备递归打包、文件过滤能力<\/li>
敏感信息扫描<\/strong>：基于文件名、路径、扩展名的敏感文件检测<\/li>
占用文件处理<\/strong>：支持读取被其他进程锁定的文件<\/li>
灵活过滤机制<\/strong>：支持按大小、时间、目录深度等条件过滤<\/li>

中断安全<\/strong>：支持Ctrl+C安全中断操作<\/li> <\/ul>
二、系统架构设计<\/h2>
2.1 整体架构层次<\/h3>
file-packer-tool\/ ├── main.go # 程序入口，CLI命令定义 ├── cmd\/ # 子命令实现 │ ├── pack.go # 打包命令 │ ├── info.go # 文件信息命令 │ ├── extract.go # 解压命令（占位） │ └── list.go # 列表命令（占位） └── internal\/ # 内部模块 ├── fileops\/ # 文件操作核心 │ ├── packer.go # 文件打包器 │ └── stream_reader.go # 文件流读取器 ├── logger\/ # 日志模块 │ └── logger.go # 简单日志实现 └── search\/ # 搜索模块 └── searcher.go # 文件搜索器 <\/code><\/pre> 2.2 各模块职责说明<\/h3> 入口层（main.go）<\/h4> 使用Cobra框架构建CLI命令行界面<\/li> 定义和管理所有子命令<\/li> 处理全局配置和信号中断<\/li> <\/ul> 命令层（cmd\/）<\/h4> pack.go<\/strong>：文件打包命令实现<\/li> info.go<\/strong>：文件信息查看命令<\/li> search<\/strong>：敏感文件搜索命令（集成在main.go中）<\/li> extract.go<\/strong>：解压命令（暂未实现）<\/li> list.go<\/strong>：压缩包列表命令（暂未实现）<\/li> <\/ul> 业务层（internal\/）<\/h4> fileops<\/strong>：核心文件操作逻辑<\/li> search<\/strong>：文件搜索和敏感信息检测<\/li> logger<\/strong>：日志记录功能<\/li> <\/ul> 三、核心功能详解<\/h2> 3.1 文件打包功能（pack命令）<\/h3> 3.1.1 功能特性<\/h4> 支持ZIP和GZIP压缩格式<\/li> 递归打包子目录<\/li> 文件过滤（包含\/排除规则）<\/li> 大文件跳过机制<\/li> 符号链接处理<\/li> 线程安全的打包操作<\/li> <\/ul> 3.1.2 使用示例<\/h4> # 打包目录为ZIP格式<\/span> <\/span><\/span>tool pack \/path\/to\/source --output output.zip --format zip <\/span><\/span> <\/span><\/span># 使用GZIP压缩单个文件<\/span> <\/span><\/span>tool pack file.txt --output file.txt.gz --format gzip <\/span><\/span> <\/span><\/span># 带过滤条件的打包<\/span> <\/span><\/span>tool pack \/source --exclude "*.tmp,*.log"<\/span> --include "*.txt,*.doc"<\/span> <\/span><\/span><\/code><\/pre>3.1.3 技术实现要点<\/h4> ZIP打包<\/strong>：支持多文件递归打包，使用互斥锁保护共享状态<\/li> GZIP打包<\/strong>：仅支持单文件，符合GZIP规范<\/li> 文件占用处理<\/strong>：尝试多种方式读取被锁定文件<\/li> 中断处理<\/strong>：支持Ctrl+C安全终止打包过程<\/li> <\/ul> 3.2 敏感文件搜索功能（search命令）<\/h3> 3.2.1 搜索模式<\/h4> 扩展名过滤<\/strong>：按文件扩展名搜索（如.txt,.doc,.pdf）<\/li> 关键词搜索<\/strong>：路径和文件名中包含关键词<\/li> 敏感信息检测<\/strong>：基于预定义规则的敏感文件识别<\/li> 正则表达式<\/strong>：支持自定义正则模式匹配<\/li> 递归搜索<\/strong>：可控制搜索深度和范围<\/li> <\/ul> 3.2.2 搜索选项详解<\/h4> # 基本搜索<\/span> <\/span><\/span>tool search \/path --extensions .txt,.doc --keywords password,secret <\/span><\/span> <\/span><\/span># 高级搜索<\/span> <\/span><\/span>tool search \/path --sensitive --recursive --max-depth 5<\/span> --file-size-limit 10MB <\/span><\/span> <\/span><\/span># 结果导出<\/span> <\/span><\/span>tool search \/path --output results.txt --show-content --content-preview 200<\/span> <\/span><\/span><\/code><\/pre>3.2.3 敏感文件识别规则<\/h4> 文件名关键词<\/strong>：password、secret、key、config等<\/li> 敏感路径<\/strong>：包含System32、.env、config等目录<\/li> 常见敏感文件<\/strong>：密钥文件、配置文件、日志文件等<\/li> 评分机制<\/strong>：根据匹配程度给文件打分，高分文件优先显示<\/li> <\/ul> 3.3 文件信息查看（info命令）<\/h3> 3.3.1 功能描述<\/h4> 查看文件详细信息，包括：<\/p> 文件基本属性（路径、大小、修改时间）<\/li> 文件占用状态检测<\/li> 读取方式信息（普通读取、备份权限、卷影副本等）<\/li> <\/ul> 3.3.2 使用示例<\/h4> tool info filename.txt <\/span><\/span><\/code><\/pre>四、关键技术实现<\/h2> 4.1 被占用文件读取技术<\/h3> 4.1.1 四级读取策略<\/h4> 工具按顺序尝试四种读取方法：<\/p> 共享模式打开<\/strong>：使用Windows API以共享模式打开文件<\/li> 备份权限打开<\/strong>：利用系统备份权限绕过文件锁定<\/li> 卷影副本访问<\/strong>：从系统还原点读取文件副本<\/li> 内存映射读取<\/strong>：通过内存映射方式读取文件内容<\/li> <\/ol> 4.1.2 实现代码位置<\/h4> 核心逻辑位于internal\/fileops\/stream_reader.go<\/code>，提供智能的文件流读取能力。<\/p> 4.2 日志模块设计<\/h3> 4.2.1 当前实现<\/h4> 支持Info、Error、Debug三个日志级别<\/li> 输出格式：[级别] 时间消息 [key1 value1 key2 value2]<\/code><\/li> 所有日志输出到控制台<\/li> <\/ul> 4.2.2 已知限制<\/h4> 字段显示格式不够友好<\/li> 缺乏日志级别开关控制<\/li> 不支持文件输出和日志轮转<\/li> <\/ul> 4.3 搜索算法优化<\/h3> 4.3.1 性能考虑<\/h4> 支持目录深度限制，避免无限递归<\/li> 文件大小限制，跳过过大文件<\/li> 排除系统目录和用户指定目录<\/li> 支持时间范围过滤<\/li> <\/ul> 4.3.2 当前限制<\/h4> 仅搜索文件名和路径，不搜索文件内容<\/li> 时间范围解析存在bug（如"7d"被解析为7小时）<\/li> 隐藏文件处理逻辑较为简单<\/li> <\/ul> 五、使用指南<\/h2> 5.1 编译和安装<\/h3> # 编译项目<\/span> <\/span><\/span>go build -o file-packer-tool <\/span><\/span> <\/span><\/span># 或直接运行<\/span> <\/span><\/span>go run main.go [<\/span>command]<\/span> [<\/span>options]<\/span> <\/span><\/span><\/code><\/pre>5.2 命令参考<\/h3> 5.2.1 pack命令完整选项<\/h4> tool pack [source] --output [output] --format [zip|gzip] --exclude [patterns] # 排除文件模式 --include [patterns] # 包含文件模式 --max-size [size] # 最大文件大小限制 --no-recurse # 禁止递归 <\/code><\/pre> 5.2.2 search命令完整选项<\/h4> tool search [directory] --extensions [exts] # 文件扩展名过滤 --keywords [words] # 关键词搜索 --sensitive # 启用敏感信息检测 --recursive # 递归搜索子目录 --max-depth [depth] # 最大递归深度 --file-size-limit [size] # 文件大小限制 --output [file] # 结果导出文件 --show-content # 显示文件内容预览 <\/code><\/pre> 5.3 最佳实践<\/h3> 5.3.1 敏感文件扫描<\/h4> # 全面扫描敏感文件<\/span> <\/span><\/span>tool search \/home\/user --sensitive --recursive --max-depth 10<\/span> \ <\/span><\/span><\/span><\/span> --extensions .key,.pem,.env,.config \ <\/span><\/span><\/span><\/span> --keywords password,secret,api-key \ <\/span><\/span><\/span><\/span> --output scan_results.txt <\/span><\/span><\/code><\/pre>5.3.2 安全打包重要文件<\/h4> # 打包配置文件，排除临时文件<\/span> <\/span><\/span>tool pack \/etc\/important-configs --output backup.zip \ <\/span><\/span><\/span><\/span> --format zip --exclude "*.tmp,*.log"<\/span> --max-size 100MB <\/span><\/span><\/code><\/pre>六、扩展和定制<\/h2> 6.1 添加新的搜索规则<\/h3> 可以修改internal\/search\/searcher.go<\/code>中的敏感文件识别逻辑，添加自定义的检测规则。<\/p> 6.2 支持新的压缩格式<\/h3> 在internal\/fileops\/packer.go<\/code>中实现新的压缩格式支持，遵循现有的接口设计。<\/p> 6.3 日志系统改进建议<\/h3> 实现日志级别控制<\/li> 添加文件输出支持<\/li> 改进字段显示格式<\/li> 支持结构化日志<\/li> <\/ul> 七、注意事项和限制<\/h2> 7.1 已知问题<\/h3> GZIP格式仅支持单文件打包<\/li> 搜索功能不检查文件内容<\/li> 时间范围过滤存在解析错误<\/li> 日志系统功能较为基础<\/li> <\/ol> 7.2 平台兼容性<\/h3> 主要针对Windows平台优化（文件占用处理）<\/li> 在Linux\/macOS上可能功能受限<\/li> 路径分隔符处理需要平台适配<\/li> <\/ul> 7.3 性能考虑<\/h3> 大目录搜索可能耗时较长<\/li> 建议合理设置搜索深度和文件大小限制<\/li> 敏感文件检测会增加处理开销<\/li> <\/ul> 本教学文档全面介绍了文件打包与敏感信息扫描工具的设计原理、功能特性和使用方法，为安全研究人员和系统管理员提供了实用的文件处理解决方案。<\/p>

文件打包与敏感信息扫描工具教学文档<\/h1>

一、工具概述<\/h2>

1.1 工具简介<\/h3>
这是一个基于Go语言开发的文件打包与敏感信息扫描工具，具备文件打包压缩、敏感文件搜索、文件信息查看等功能。工具采用模块化架构设计，支持命令行操作，能够智能处理被占用的文件。<\/p>

二、系统架构设计<\/h2>

2.2 各模块职责说明<\/h3>

三、核心功能详解<\/h2>

3.1 文件打包功能（pack命令）<\/h3>

3.2 敏感文件搜索功能（search命令）<\/h3>

3.3 文件信息查看（info命令）<\/h3>

四、关键技术实现<\/h2>

4.1 被占用文件读取技术<\/h3>

4.1.2 实现代码位置<\/h4>
核心逻辑位于`internal\/fileops\/stream_reader.go<\/code>，提供智能的文件流读取能力。<\/p>`

4.3 搜索算法优化<\/h3>

五、使用指南<\/h2>

5.2 命令参考<\/h3>

5.3 最佳实践<\/h3>

六、扩展和定制<\/h2>

6.1 添加新的搜索规则<\/h3>
可以修改`internal\/search\/searcher.go<\/code>中的敏感文件识别逻辑，添加自定义的检测规则。<\/p>`

七、注意事项和限制<\/h2>

文件打包与敏感信息扫描工具教学文档<\/h1>

一、工具概述<\/h2>

1.1 工具简介<\/h3> 这是一个基于Go语言开发的文件打包与敏感信息扫描工具，具备文件打包压缩、敏感文件搜索、文件信息查看等功能。工具采用模块化架构设计，支持命令行操作，能够智能处理被占用的文件。<\/p>

二、系统架构设计<\/h2>

2.2 各模块职责说明<\/h3>

三、核心功能详解<\/h2>

3.1 文件打包功能（pack命令）<\/h3>

3.2 敏感文件搜索功能（search命令）<\/h3>

3.3 文件信息查看（info命令）<\/h3>

四、关键技术实现<\/h2>

4.1 被占用文件读取技术<\/h3>

4.1.2 实现代码位置<\/h4> 核心逻辑位于internal\/fileops\/stream_reader.go<\/code>，提供智能的文件流读取能力。<\/p>

4.3 搜索算法优化<\/h3>

五、使用指南<\/h2>

5.2 命令参考<\/h3>

5.3 最佳实践<\/h3>

六、扩展和定制<\/h2>

6.1 添加新的搜索规则<\/h3> 可以修改internal\/search\/searcher.go<\/code>中的敏感文件识别逻辑，添加自定义的检测规则。<\/p>

七、注意事项和限制<\/h2>

1.1 工具简介<\/h3>
这是一个基于Go语言开发的文件打包与敏感信息扫描工具，具备文件打包压缩、敏感文件搜索、文件信息查看等功能。工具采用模块化架构设计，支持命令行操作，能够智能处理被占用的文件。<\/p>

4.1.2 实现代码位置<\/h4>
核心逻辑位于`internal\/fileops\/stream_reader.go<\/code>，提供智能的文件流读取能力。<\/p>`

6.1 添加新的搜索规则<\/h3>
可以修改`internal\/search\/searcher.go<\/code>中的敏感文件识别逻辑，添加自定义的检测规则。<\/p>`