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

## 发布信息

| 项目 | 值 |
|------|------|
| **项目名称** | 目录树生成脚本 |
| **项目 ID** | PROJ-20260509011 |
| **版本** | 1.0.0 |
| **发布日期** | 2026-05-16 |
| **Git 标签** | v1.0.0 |
| **Gitea 仓库** | https://git.cclee.wiki/GoudanLabs/tree-generator |
| **运行平台** | Windows 10/11（兼容 Linux/macOS） |
| **技术栈** | Python 3.8+ 标准库，零第三方依赖 |

---

## 功能清单

| 编号 | 功能 | 状态 |
|------|------|------|
| F013 | 路径输入（命令行参数，支持相对/绝对路径） | ✅ 通过 |
| F014 | 忽略配置（自动加载 .treeignore/.gitignore，内置默认列表） | ✅ 通过 |
| F015 | 递归遍历（生成完整树形结构，自动检测符号链接循环） | ✅ 通过 |
| F016 | 目录树生成（├── / └── 字符绘制，目录带 / 后缀） | ✅ 通过 |
| F017 | 文件树生成（完整路径 + 文件大小） | ✅ 通过 |
| F018 | 终端输出（UTF-8 编码，自动格式化显示） | ✅ 通过 |
| F019 | Markdown 保存（默认 tree_output.md，含代码块+表格+统计） | ✅ 通过 |
| F020 | 统计信息（目录数、文件数、总大小自动格式化） | ✅ 通过 |

**测试结果：8/8 通过**

---

## 已知问题

| 问题 | 描述 | 影响 | 优先级 |
|------|------|------|--------|
| `-f` 模式下树形显示仅展示根目录级别文件 | 在 `-f`（files-only）模式下，树形显示部分仅展示根目录的直接子文件，深层嵌套文件在文件列表中可以正确列出，但树形视图中未完整展示。此为显示层问题，不影响文件列表和统计功能的正确性。 | 非阻塞性，文件列表和 Markdown 输出正常 | 低 |

---

## 升级说明

### v1.0.0（首次发布）

- 初始版本
- Python 3.8+ 实现，零第三方依赖
- 专为 Windows 平台优化，同时兼容 Linux/macOS
- 内置常见忽略项（.git、node_modules、__pycache__ 等）
- 支持 `.treeignore` / `.gitignore` 自定义忽略配置
- 自动检测符号链接循环，避免无限递归
- Markdown 导出（UTF-8 with BOM，Windows 记事本兼容）+ 终端输出双模式
- 自动统计目录数、文件数和总大小（B/KB/MB/GB 自动格式化）
- 深度限制（`-d` 参数）
- 目录树 / 文件树 / 混合模式可选

---

## 文件清单

### dist/
- `tree_gen.py` — 主脚本（Python 3.8+，可直接运行）

### source/
- `tree_gen.py` — 完整源码
- `README.md` — 完整使用文档
- `t023-architecture-design.md` — 架构设计文档

### docs/
- `README.md` — 完整使用说明
- `QUICKSTART.md` — 快速入门指南

---

## 环境要求

- **操作系统：** Windows 10/11（也兼容 Linux/macOS）
- **Python：** 3.8 或更高版本
- **依赖：** 仅使用 Python 标准库，零第三方依赖