一、功能简介

您是否曾为了编写文档或项目说明（README），需要手动整理并输入复杂的目录结构？或者在代码审查时，想快速展示一个模块的文件布局？

这个动作可以帮助您一键完成这项工作！它会自动获取路径，快速生成一份美观、清晰的树形目录结构，并自动将结果复制到剪贴板，让您随处粘贴，即刻使用。

二、亮点功能

1. 智能路径识别 无需繁琐操作，动作会自动按“当前选择 >资源管理器当前目录> 剪贴板 > 手动输入”的优先级来确定您想要扫描的文件夹，覆盖所有使用场景。

2. 高度可定制 通过右键点击动作图标进入配置，您可以全面掌控输出的样式和内容：

   • maxDepth: 最大扫描深度。

   • maxEntriesPerDirectory: 每层最大条目数。

   • outputFormat: 输出格式，可选 text（纯文本）或 markdown（自动添加代码块）。

   • showHidden: 显示隐藏文件，可设为 true 或 false。

3. 强大的智能忽略

   • 自动.gitignore支持：自动读取 .gitignore 文件，智能忽略无需展示的文件和目录。

   • 支持否定规则：能正确处理 !.env.example 这样的不忽略规则。

三、使用方法

常规使用 (左键单击)

1. 在任意位置运行本动作，动作会自动按“当前选择 >资源管理器当前目录> 剪贴板 > 手动输入”的优先级扫描的文件夹。

2. 完成后，目录结构已在您的剪贴板中，直接去需要的地方 Ctrl+V 粘贴即可。

高级配置 (右键单击)

1. 在 Quicker 面板的本动作图标上点击鼠标右键。

2. 在弹出的菜单中选择“设置”进行配置。

四、配置项说明

• 最大深度(默认值: 3) 控制“钻”多深。如果设置为 1，就只会显示第一层子目录和文件。

• 文件最大数量(默认值: 5) 控制“看”多宽。如果一个文件夹下有100个文件，为了版面整洁，只会列出前5个，并在末尾显示一个 ... 省略号。这个限制对文件和子目录的总和有效。

• 输出格式(默认值: text) 。可选text（纯文本）或markdown（自动添加代码块）。
• 是否显示隐藏文件和文件夹(默认值: false) 。