[工具集合更新]: 新增图标生成工具和目录树工具，优化文档结构

- icon-maker: 新增Windows图标生成工具make_ico.py，重构make_icns模块为icon-maker，提取公共函数到icon_common.py
- tree: 新增目录树生成工具tree.py，支持彩色输出和跨平台兼容
- README: 更新工具列表和描述，添加分类说明和快速开始指南

Author: RealChuan

README.md

@@ -5,18 +5,23 @@
 
 让开发和生活都更快乐的小工具集合 🧰
 
-| 模块 | 一句话描述 | 文件 |
+## 📦 工具列表
+
+| 模块 | 描述 | 文件 |
 |---|---|---|
 | **cli_logger** | loguru 日志配置示例，控制台 + 文件双通道输出 | [`cli_logger.py`](cli_logger/cli_logger.py) |
-| **dirwatch** | 实时监控文件夹变化（增 / 删 / 改 / 重命名） | [`dirwatch.py`](dirwatch/dirwatch.py) |
+| **dirwatch** | 实时监控文件夹变化（增/删/改/重命名） | [`dirwatch.py`](dirwatch/dirwatch.py) |
+| **icon-maker** | 一键生成 macOS / Windows 应用图标（`.icns` / `.ico`） | [`make_icns.py`](icon-maker/make_icns.py) / [`make_ico.py`](icon-maker/make_ico.py) |
 | **m3u8_download** | m3u8 下载器，自动合并 ts 为单个视频 | [`m3u8_dl.py`](m3u8_download/m3u8_dl.py) |
-| **make_icns** | 一键生成 macOS 应用图标（`.icns`） | [`make_icns.py`](make_icns/make_icns.py) |
-| **procmon** | 按进程名实时监控 CPU / 内存 / 线程 / 句柄 | [`procmon.py`](procmon/procmon.py) |
-| **resolve** | 域名解析，快速获取 IP、端口、协议 | [`resolve.py`](resolve/resolve.py) |
+| **procmon** | 按进程名实时监控 CPU/内存/线程/句柄 | [`procmon.py`](procmon/procmon.py) |
+| **resolve** | 域名解析工具，快速获取 IP、端口、协议信息 | [`resolve.py`](resolve/resolve.py) |
 | **syncthing** | Syncthing API 封装，监控文件夹与设备状态 | [`syncthing_monitor.py`](syncthing/syncthing_monitor.py) |
-| **webdav** | 轻量级 WebDAV 客户端，支持上传 / 下载 / 删除 / 移动 | [`webdav.py`](webdav/webdav.py) |
+| **tree** | 可视化目录树生成工具 | [`tree.py`](tree/tree.py) |
+| **webdav** | 轻量级 WebDAV 客户端，支持上传/下载/删除/移动 | [`webdav.py`](webdav/webdav.py) |
+
+## 🚀 快速开始
 
-## 🚀 一键安装依赖
+### 安装依赖
 
 ```bash
 pip install -r requirements.txt

icon-maker/icon_common.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+from typing import Tuple, Optional
+from PIL import Image
+
+
+def parse_hex_color(hex_color: str) -> Tuple[int, int, int, int]:
+    hex_color = hex_color.lstrip("#")
+    n = len(hex_color)
+    if n == 3:
+        hex_color = "".join(c * 2 for c in hex_color) + "FF"
+    elif n == 4:
+        hex_color = "".join(c * 2 for c in hex_color)
+    elif n == 6:
+        hex_color += "FF"
+    elif n != 8:
+        raise ValueError("颜色格式错误，支持：#RGB、#RGBA、#RRGGBB、#RRGGBBAA")
+    return tuple(int(hex_color[i : i + 2], 16) for i in (0, 2, 4, 6))
+
+
+def square_image(
+    img: Image.Image, bg_color: Optional[Tuple[int, int, int, int]] = None
+) -> Image.Image:
+    if img.width == img.height:
+        return img.copy()
+    side = max(img.width, img.height)
+    canvas = Image.new("RGBA", (side, side), bg_color or (0, 0, 0, 0))
+    x, y = (side - img.width) // 2, (side - img.height) // 2
+    canvas.paste(img, (x, y), img if img.mode == "RGBA" else None)
+    return canvas

make_icns/maek_icns.py icon-maker/make_icns.pymake_icns/maek_icns.py renamed to icon-maker/make_icns.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
 make-icns.py
@@ -15,46 +14,12 @@
 import tempfile
 import subprocess
 from PIL import Image, ImageOps
+from icon_common import parse_hex_color, square_image
 
 # icns 所需全部分辨率
 ICNS_SIZES = [16, 32, 64, 128, 256, 512, 1024]
 
 
-def parse_hex_color(hex_color: str):
-    """
-    支持 #RGB、#RGBA、#RRGGBB、#RRGGBBAA
-    返回 (R, G, B, A)  0-255
-    """
-    hex_color = hex_color.lstrip("#")
-    n = len(hex_color)
-    if n == 3:  # #RGB   -> #RRGGBB + 不透明
-        hex_color = "".join(c * 2 for c in hex_color) + "FF"
-    elif n == 4:  # #RGBA  -> #RRGGBBAA
-        hex_color = "".join(c * 2 for c in hex_color)
-    elif n == 6:  # #RRGGBB -> 不透明
-        hex_color += "FF"
-    elif n != 8:
-        raise ValueError("颜色格式错误，支持：#RGB、#RGBA、#RRGGBB、#RRGGBBAA")
-
-    return tuple(int(hex_color[i : i + 2], 16) for i in (0, 2, 4, 6))
-
-
-def square_image(img: Image.Image, bg_color=None) -> Image.Image:
-    """将 img 做成最小外接正方形，bg_color=None 代表透明"""
-    if img.width == img.height:
-        return img.copy()
-    side = max(img.width, img.height)
-    if bg_color is None:  # 透明
-        new_im = Image.new("RGBA", (side, side), (0, 0, 0, 0))
-    else:  # 纯色
-        new_im = Image.new("RGBA", (side, side), bg_color)
-    # 居中粘贴
-    x = (side - img.width) // 2
-    y = (side - img.height) // 2
-    new_im.paste(img, (x, y), img if img.mode == "RGBA" else None)
-    return new_im
-
-
 def build_icns(source_img: Image.Image, output_icns: str):
     """生成 .icns 文件"""
     tempdir = tempfile.mkdtemp()

icon-maker/make_ico.py

@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+"""
+make_ico.py
+将任意图片快速生成多尺寸 ico 图标。
+
+用法:
+    ./make_ico.py input.png                    # 透明背景
+    ./make_ico.py input.jpg "#FF00FF"          # 指定背景色
+    ./make_ico.py input.tiff -o MyIcon.ico    # 指定输出文件名
+"""
+import os
+import sys
+import argparse
+from PIL import Image, ImageOps
+from icon_common import parse_hex_color, square_image
+
+# 常用 ico 尺寸（Windows 推荐倒序存放）
+# Pillow 还是会从小到大生成，无视传入的顺序
+ICO_SIZES = [256, 128, 64, 48, 32, 16]
+
+
+def build_ico(source_img: Image.Image, output_ico: str) -> None:
+    """生成 .ico 文件"""
+
+    icons = []
+    for size in ICO_SIZES:
+        icons.append(source_img.resize((size, size), Image.LANCZOS))
+
+    # 保存为 ico（Pillow 会自动打包多尺寸）
+    # 写入为PNG压缩格式，windows 文件属性分辨率只能识别第一张图，即16x16
+    icons[0].save(
+        output_ico,
+        format="ICO",
+        sizes=[(s, s) for s in ICO_SIZES],
+        append_images=icons[1:],
+    )
+    print(f"✅ 已生成 {output_ico}（含尺寸：{ICO_SIZES}）")
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description="把任意图片做成 ico 图标")
+    parser.add_argument("input", help="输入图片路径")
+    parser.add_argument("bgcolor", nargs="?", help="背景色（十六进制，可选，默认透明）")
+    parser.add_argument("-o", "--output", help="输出 .ico 文件名（可选）")
+    args = parser.parse_args()
+
+    if not os.path.isfile(args.input):
+        sys.exit("输入文件不存在")
+
+    # 1. 读图
+    img = Image.open(args.input).convert("RGBA")
+
+    # 2. 背景色
+    if args.bgcolor:
+        bg_color = parse_hex_color(args.bgcolor)
+    else:
+        bg_color = None  # 透明
+
+    # 3. 正方形化
+    square = square_image(img, bg_color)
+
+    # 4. 输出文件名
+    if args.output:
+        out_ico = args.output
+    else:
+        base, _ = os.path.splitext(args.input)
+        out_ico = base + ".ico"
+
+    # 5. 生成 ico
+    build_ico(square, out_ico)
+    print("已生成 →", out_ico)
+
+
+if __name__ == "__main__":
+    main()

tree/tree.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+tree.py
+递归或非递归打印目录结构，效果类似 Linux 的 tree 命令。
+
+用法:
+    python tree.py /path/to/dir          # 仅列一层
+    python tree.py /path/to/dir -r       # 递归子目录
+    python tree.py -h
+"""
+import os
+import sys
+import argparse
+from pathlib import Path
+from typing import List
+
+
+class Colors:
+    OK = "\033[92m"
+    WARN = "\033[93m"
+    ERR = "\033[91m"
+    BOLD = "\033[1m"
+    END = "\033[0m"
+
+    @staticmethod
+    def enable_windows_color() -> None:
+        if sys.platform == "win32":
+            os.system("")
+
+
+Colors.enable_windows_color()
+
+PREFIX_MIDDLE = "├── "
+PREFIX_LAST = "└── "
+PREFIX_CONT = "│   "
+PREFIX_EMPTY = "    "
+
+
+def tree(dir_path: Path, prefix: str = "", recursive: bool = False) -> None:
+    """打印目录树，recursive 控制是否进入子目录"""
+    entries: List[Path] = sorted(
+        dir_path.iterdir(), key=lambda p: (p.is_file(), p.name.lower())
+    )
+    for idx, path in enumerate(entries):
+        is_last = idx == len(entries) - 1
+        connector = PREFIX_LAST if is_last else PREFIX_MIDDLE
+        if path.is_dir():
+            print(f"{prefix}{connector}{Colors.BOLD}{path.name}{Colors.END}")
+            if recursive:  # 仅递归时继续深入
+                extension = PREFIX_EMPTY if is_last else PREFIX_CONT
+                tree(path, prefix + extension, recursive=True)
+        else:
+            print(f"{prefix}{connector}{path.name}")
+
+
+def main(argv: List[str] = None) -> None:
+    parser = argparse.ArgumentParser(description="打印目录结构")
+    parser.add_argument("directory", help="要列出的目录路径")
+    parser.add_argument(
+        "-r", "--recursive", action="store_true", help="递归子目录（默认不递归）"
+    )
+    args = parser.parse_args(argv)
+
+    root = Path(args.directory).expanduser().resolve()
+    if not root.is_dir():
+        print(f"{Colors.ERR}错误: {root} 不是有效目录{Colors.END}", file=sys.stderr)
+        sys.exit(2)
+
+    print(f"{Colors.OK}{root}{Colors.END}")
+    try:
+        tree(root, recursive=args.recursive)
+    except KeyboardInterrupt:
+        sys.exit(130)
+    except Exception as e:
+        print(f"{Colors.ERR}遍历失败: {e}{Colors.END}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()