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