tree-generator/Releases/v1.0.0/RELEASE.md

RELEASE.md — 目录树生成脚本 v1.0.0

发布信息

项目	值
项目名称	目录树生成脚本
项目 ID	PROJ-20260509011
版本	1.0.0
发布日期	2026-05-16
Git 标签	v1.0.0
提交 Hash	c278c5a
Gitea 仓库	https://git.cclee.wiki/GoudanLabs/tree-generator

---

功能清单

编号	功能	状态
F013	生成目录树（├── / └── 格式，目录在前文件在后，字母排序）	✅ 通过
F014	生成文件列表（-f 参数）	✅ 通过
F015	忽略配置（内置 30+ 种模式 + .treeignore 自定义）	✅ 通过
F016	深度限制（-d 参数）	✅ 通过
F017	Markdown 导出（默认 tree_output.md，可自定义路径）	✅ 通过
F018	统计信息（目录数、文件数、总大小 B/KB/MB/GB）	✅ 通过
F019	循环检测（基于 inode 的符号链接循环检测）	✅ 通过
F020	权限处理（无权限目录显示 [Permission denied]，不中断）	✅ 通过

测试结果：8/8 通过

---

已知问题

问题	描述	影响	优先级
-d 1 深度限制异常	当 -d 参数为 1 时，由于 depth >= MAX_DEPTH 的判断逻辑，根目录下的子目录内容会被跳过，但根目录本身仍显示。在 -d 1 时表现为只显示根目录名，不显示任何子项。	边缘场景，正常使用 -d 2+ 无影响	低

---

升级说明

v1.0.0（首次发布）

• 初始版本
• 纯 Bash 实现，零外部依赖
• 支持 Linux 和 macOS
• 内置 30+ 种常见忽略模式
• 支持 .treeignore 自定义忽略配置
• 基于 inode 的符号链接循环检测
• Markdown 导出 + 终端输出双模式
• 自动统计目录数、文件数和总大小

---

文件清单

dist/

• tree.sh — 主脚本（可执行）

source/

• tree.sh — 源码
• README.md — 完整文档
• tree_architecture_design.md — 架构设计文档

docs/

• README.md — 完整使用说明
• QUICKSTART.md — 快速入门指南

---

环境要求

• 操作系统： Linux 或 macOS
• Shell： Bash 4.0+
• 依赖： 无（仅使用标准工具：stat, awk, basename, dirname, mkdir）