rahimgujjar/DirNav

# DirNav：高级文件系统侦察与映射工具 ## 📑 执行摘要 DirNav 是一款高性能、多线程的目录映射实用工具，专为深度文件系统侦察而设计。它使用 Python 开发并配备了 PyQt5 原生界面，能够突破标准操作系统的限制，对复杂嵌套目录和压缩存档进行递归式的结构化映射。 DirNav 专为系统管理员、取证分析人员和开发者设计，无需显式解压即可无缝检查物理磁盘和虚拟存档（ZIP、APK、JAR、CBZ），从而生成全面且可移植的数据蓝图。 ## 🚀 核心功能 * **异步存档检查：** 利用 `ThreadPoolExecutor` 并行递归扫描 `.zip`、`.apk` 和 `.jar` 文件。它完全在内存中映射内部存档结构并计算文件分配情况。 * **原生 OS 集成：** 借助 PyQt5 保持原生的 Windows 10/11 UX 进行文件和文件夹意图选择，摒弃了笨重的自定义对话框。 * **深度元数据解析：** * **MIME 检测：** 集成 `python-magic` 进行精确的文件签名验证，忽略容易伪造的文件扩展名。 * **媒体遥测：** 直接从物理磁盘和嵌入式存档二进制文件中提取精确的图像分辨率（通过 `Pillow`）。 * **快捷方式解析：** 利用 `pywin32` COM 接口动态解析 `.lnk` 目标路径。 * **可扩展遥测导出：** 将映射好的系统结构动态编译为深度嵌套的 JSON、纯文本，或动态封装的 PDF 账本（通过 `reportlab`）。 ## 🛠️ 技术架构 ### 技术栈 * **语言：** Python 3.x * **GUI 框架：** PyQt5 * **并发：** `concurrent.futures.ThreadPoolExecutor` * **可选依赖项：** `python-magic-bin`, `pywin32`, `Pillow`, `reportlab` ### “智能意图” Pipeline 标准的 OS 对话框在动态选择“文件”或“文件夹”时往往力不从心。DirNav 通过在调用原生 OS 选择器之前提示用户选择**意图**（目录映射 vs. 存档检查）来解决此问题。这使得应用程序能够根据目标向量，灵活调整其递归深度限制和多线程分配策略。 ## 📥 安装与设置 ### 1. 克隆仓库 ``` git clone https://github.com/rahimgujjar/DirNav.git cd DirNav ``` ### 2. 安装核心依赖 要使用完整的功能集（MIME 映射、PDF 生成和 LNK 解析），请安装以下依赖项： ``` pip install -r requirements.txt ``` ### 3. 执行 运行 GUI 应用程序（`.pyw` 扩展名可确保其在 Windows 环境下运行时不会显示持久的后台控制台）： ``` python src/DirNav.py ``` ## 🛡️ 隐私与执行说明 DirNav 完全在离线环境下运行，不需要任何提升的网络权限。所有目录映射、MIME 评估和 PDF 生成均在宿主机的内存边界内本地完成。

标签：PyQt5, 元数据提取, 压缩包解析, 数字取证, 桌面应用, 目录映射, 自动化脚本, 进程保护, 逆向工具