Agent
fbad6a4647
- 更新为 Python 3.8+ 实现（tree_gen.py） - 8 个功能全部通过（F013-F020） - 更新 RELEASE.md、QUICKSTART.md 为 Python 版本 - 移除旧 Bash 版本文件（tree.sh） - 添加架构设计文档（t023-architecture-design.md）
81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
# 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 标准库，零第三方依赖
|