📂 文件夹结构生成器 (Folder Structure Generator)

这是一个基于 Python 的轻量级实用工具，旨在快速扫描本地文件夹，明确文件夹中矢量图与栅格图的存在与否，并生成直观的目录树结构文档。包含文本版和网页/幕布导入版两个独立的脚本，满足不同场景下的目录梳理和可视化需求。

✨ 核心特性

• 🌳 多格式导出：支持导出纯文本 (.txt)、交互式网页 (.html) 和思维导图格式 (.opml)。
• 🌐 交互式 HTML：生成的 HTML 文档支持点击折叠/展开文件夹，并自动在文件夹旁汇总统计其内部包含的文件类型。
• 🧠 幕布/XMind 兼容：自动生成 OPML 文件，可一键导入“幕布”、XMind 等思维导图软件，方便进一步结构化整理。
• 🏷️ 智能文件类型识别：内置详细的文件格式映射字典，自动识别后缀并为文件添加直观的类型标签：
  • 文本版 (test_TXT.py)：涵盖数十种格式，包含常规文档、音/视/图多媒体、压缩包，以及各类开发源码（JS/Java/Python等）和系统脚本。
  • 网页版 (test_HTML.py)：针对项目归档优化分类，将常见图片统一归为“栅格图片”，并补充了 .dwg/.dxf 等“矢量数据”格式的专属识别。
• 🛡️ 容错与优化：自动过滤隐藏的 .db 文件，优雅处理无权限访问的系统文件夹，防止程序崩溃。
• 🚀 零依赖：仅使用 Python 标准库（os, pathlib, time），无需 pip install 安装任何第三方包即可直接运行。

📦 文件说明

本项目包含两个主要脚本，可根据需要单独使用：

1. test_TXT.py： 生成纯文本格式的树状目录结构文档，适合轻量级查阅、代码注释辅助和纯文本分享。
2. test_HTML.py： 同时生成交互式 HTML 网页文件和 OPML 格式文件，适合需要浏览器预览（不可编辑），或导入思维导图软件、大纲笔记软件（如Xmind、幕布等）进行详细梳理编辑的场景。

🚀 快速开始

前置条件

• 已安装 Python 3.6 或更高版本。

使用方法

1. 将本项目下载或克隆到本地。

2. 在终端或命令行中运行对应的脚本：

   # 生成纯文本结构文档
   python test_TXT.py
   
   # 或生成 HTML 与 OPML 结构文档
   python test_HTML.py

3. 根据控制台提示，输入（或直接拖拽）你想扫描的文件夹路径（例如 D:\Work\Projects）。

4. 按下回车键，等待扫描完成。

5. 生成的文档会带上时间戳保存在脚本所在的当前目录下，且在 Windows 系统下会自动打开生成的文件以便即时预览。

📄 导出示例

文本导出效果 (test_TXT.py)

📁 根目录: D:\Work\Projects
├── 📁 XXX规划 （包含: PDF文档, Word文档, 矢量数据，栅格图片）  
│   ├── 📄 说明书.pdf [PDF文档]
│   ├── 📄 说明书.docx [Word文档]
│   ├── 📄 地块控制性详细规划.dwg [矢量数据]
│   └── 📄 法定图则.jpg [栅格图片]
├── 📄 图集.pdf [PDF文档]
└── 📄 说明书.pdf [PDF文档]

🛠️ 自定义配置

如果你有特定行业的文件格式需要识别，可以在脚本顶部找到 FILE_TYPES 字典进行扩展。例如，增加设计类文件后缀：

FILE_TYPES = {
    # ... 现有映射 ...
    '.psd': 'Photoshop源文件',
    '.aep': 'AE工程文件',
    '.prproj': 'PR工程文件'
}

📜 许可证 (License)

本项目基于 MIT 许可证开源，您可以自由地使用、修改和分发。