文件夹清单导出 · 目录树与体积统计【律令·本地零联网】

文件清单与目录导出：目录树打印、文件清单导出 CSV/JSON（含 SHA256 文件信息）、按扩展名体积统计，重复文件只报告不删除。

这个技能做什么

本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

目录清单导出与体积统计

子命令（全部实测通过）

tree — 打印目录树

dir_tree.py tree ./项目资料 --depth 2 --size

真实输出：

    LICENSE.md (1.1 KB)
    README.md (167 B)
    SKILL.md (5.3 KB)
└── scripts/
      csv_toolkit.py (10.0 KB)

目录 1 个、文件 4 个（深度上限 2）

--dirs-only 只看目录骨架；--depth N 控制层级（默认 3，超大目录请先压到 1~2 层）。

export — 导出清单（CSV / JSON）

dir_tree.py export ./项目资料 --fmt csv --out 清单.csv

真实输出：

已导出 2 条 -> 清单.csv (csv, utf-8-sig 兼容 Excel)

CSV 字段：rel, size, mtime, ext（--hash 时追加 sha256）。用 utf-8-sig 编码，Excel 双击打开中文不乱码。 JSON 模式（--fmt json）输出 {root, count, files[]}，带 --hash 时每条含完整 SHA256：

{
  "root": "D:\\...\\directory-listing",
  "count": 2,
  "files": [
    {"rel": "LICENSE.md", "size": 1079, "mtime": "2026-09-26 08:42:26", "ext": "md",
     "sha256": "074137e965f37d5633045ca09dc09d7e58e44d19717a519370ee1580cb39195e"}
  ]
}

不写 --out 时直接打到屏幕，方便管道给别的工具。

stats — 体积统计

dir_tree.py stats ./项目资料 --top 4

真实输出：

目录: D:\...\directory-listing
文件数: 2 | 总大小: 8.9 KB (9090 字节)

按扩展名 Top 4:
  py                 1 个      7.8 KB   88.1%
  md                 1 个      1.1 KB   11.9%

最大文件 Top 4:
      7.8 KB  scripts/dir_tree.py
      1.1 KB  LICENSE.md

字节数原样给出，百分比按实际总和算，绝不四舍五入凑数。

dup — 重复文件（只报告）

dir_tree.py dup ./项目资料 --top 10

真实输出（无重复时）：

重复文件组: 0 组 | 可释放约 0 B
未发现内容重复的文件。

有重复时按 大小 + SHA256 双重判重（只比大小会误判），输出分组与"可释放约 X"，结尾固定提示：

本工具只报告，不删除。确认后如需清理，交给 file-dedup 处理。

工作流建议

1. 先 tree --depth 1 看骨架 → stats 找占空间的扩展名
2. 要留档 / 要给同事核对 → export --fmt csv
3. 怀疑存了多份 → dup 看分组，删之前务必人工过一遍列表

自检清单

• 没有删除或改名任何文件
• CSV 用 Excel 打开中文正常（utf-8-sig）
• 重复判定用了 SHA256 而不是只看大小

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。 未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。 各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。

与相邻技能的关系

反向边界：本包只做盘点，绝不删改任何文件；dup 只报告可释放空间，删除必须转交 file-dedup 并由人工确认。

标签

文件夹清单目录导出文件清单目录树文件信息

安装方式

1. 打开 SkillHub 上的技能页，点击安装；
2. 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
3. 在你的 Agent 里直接说出使用场景即可触发，例如「导出目录清单、文件列表导出 Excel、目录体积统计」。

同类技能

常见问题

按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。