[重构与增强]: 优化哈希计算与图片工具集，移除 WebDAV 模块

- **功能重组**：将 `icon-maker` 升级为 `image-toolkit`，整合格式转换、ICNS/ICO 生成与解析功能，新增 `convert_img.py`、`dump_icns.py`、`dump_ico.py`
- **哈希优化**：重写 `hash.py` 支持流式处理大文件，统一输入解析逻辑，提升性能与内存效率
- **目录树增强**：为 `tree.py` 增加文件过滤、排除模式支持，支持从文件读取忽略规则
- **依赖清理**：移除 `webdav` 模块及相关测试文件，简化项目结构
- **脚本调整**：优化 `activate_venv.sh` 避免自动安装依赖，仅保留虚拟环境激活提示
- **文档更新**：同步 README 说明，修正格式与依赖安装命令空格问题

Author: RealChuan

README.md

@@ -12,14 +12,13 @@
 | **cli_logger** | loguru 日志配置示例，控制台 + 文件双通道输出 | [`cli_logger.py`](cli_logger/cli_logger.py) |
 | **dirwatch** | 实时监控文件夹变化（增/删/改/重命名） | [`dirwatch.py`](dirwatch/dirwatch.py) |
 | **hash** | 计算文件或文本的哈希值（MD5/SHA-1/SHA-2/SHA-3/BLAKE2/BLAKE3） | [`hash.py`](hash/hash.py) |
-| **icon-maker** | 一键生成 macOS / Windows 应用图标（`.icns` / `.ico`） | [`make_icns.py`](icon-maker/make_icns.py) / [`make_ico.py`](icon-maker/make_ico.py) |
+| **image-toolkit** | 图片格式转换工具 + 一键生成/解析`.icns` / `.ico` | [`convert_img.py`](image-toolkit/convert_img.py) / [`dump_icns.py`](image-toolkit/dump_icns.py) / [`dump_ico.py`](image-toolkit/dump_ico.py) / [`make_icns.py`](image-toolkit/make_icns.py) / [`make_ico.py`](image-toolkit/make_ico.py) |
 | **m3u8_download** | m3u8 下载器，自动合并 ts 为单个视频 | [`m3u8_dl.py`](m3u8_download/m3u8_dl.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) |
 | **tree** | 可视化目录树生成工具 | [`tree.py`](tree/tree.py) |
 | **utils** | 通用工具库（颜色输出等） | [`colors.py`](utils/colors.py) |
-| **webdav** | 轻量级 WebDAV 客户端，支持上传/下载/删除/移动 | [`webdav.py`](webdav/webdav.py) |
 | **sync_req** | 依赖同步工具，从 pyproject.toml 生成 requirements.txt | [`sync_req.py`](sync_req.py) |
 
 ## 🚀 快速开始
@@ -39,7 +38,7 @@ source venv/bin/activate
 source activate_venv.sh
 
 # 安装依赖
-pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple
+pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple 
 ```
 
 ### 同步依赖文件
@@ -51,7 +50,7 @@ pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple
 python sync_req.py
 
 # 使用生成的 requirements.txt 安装依赖
-pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
+pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple 
 ```
 
 ### 使用说明

activate_venv.sh

@@ -20,6 +20,4 @@ source "$VENV_NAME/bin/activate"
 # 提示用户后续操作
 echo "虚拟环境已激活，当前 Python 路径: $(which python)"
 
-current_path=$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")
-pip install --upgrade pip
-pip install -r "${current_path}/requirements.txt" -i https://pypi.tuna.tsinghua.edu.cn/simple
+echo "你可以使用 'deactivate' 命令退出虚拟环境"

hash/hash.py

@@ -16,11 +16,11 @@
 import hashlib
 import os
 import sys
-from typing import Dict, List, Callable
+from typing import Dict, List, Callable, Union, IO
 from utils import Colors
 
 
-# ---------- 算法表 ----------
+# ---------------- 算法表 ----------------
 ALGO_MAP: Dict[str, Callable[[], "hashlib._Hash"]] = {}
 
 # 标准库自带
@@ -49,33 +49,49 @@
 except ImportError:
     pass
 
-
-# ---------- 工具 ----------
-def calc_hash(data: bytes, algo: str) -> str:
-    """计算指定算法哈希值，返回十六进制字符串"""
-    h = ALGO_MAP[algo]()
-    h.update(data)
-    return h.hexdigest()
-
-
-def read_target(target: str) -> bytes:
-    """从文件、文本或 stdin 读取二进制数据"""
-    if target == "-":
+# ---------------- 流式核心 ----------------
+BUF = 1 << 20
+
+
+def multi_hash_stream(
+    stream: Union[bytes, IO[bytes]], algos: List[str], buf_size: int = BUF
+) -> Dict[str, str]:
+    """一次读取，返回 algo->hex 的映射"""
+    hashers = {a: ALGO_MAP[a]() for a in algos}
+    if isinstance(stream, bytes):  # 小文本
+        for h in hashers.values():
+            h.update(stream)
+        return {a: h.hexdigest() for a, h in hashers.items()}
+    # 文件 / stdin
+    while chunk := stream.read(buf_size):
+        for h in hashers.values():
+            h.update(chunk)
+    return {a: h.hexdigest() for a, h in hashers.items()}
+
+
+# ---------------- 输入解析 ----------------
+def parse_input(args) -> Union[bytes, IO[bytes]]:
+    if args.target == "-":
         print(f"{Colors.OK}从标准输入读取数据{Colors.END}")
-        return sys.stdin.buffer.read()
-    if os.path.isfile(target):
-        print(f"{Colors.OK}读取文件: {target}{Colors.END}")
-        with open(target, "rb") as f:
-            return f.read()
+        return sys.stdin.buffer
+    if args.text:
+        print(f"{Colors.OK}按文本内容计算{Colors.END}")
+        return args.target.encode("utf-8")
+    if os.path.isfile(args.target):
+        print(f"{Colors.OK}读取文件: {args.target}{Colors.END}")
+        return open(args.target, "rb")
     print(f"{Colors.OK}按文本内容计算{Colors.END}")
-    return target.encode("utf-8")
+    return args.target.encode("utf-8")
 
 
-# ---------- 主入口 ----------
+# ---------------- 主入口 ----------------
 def main(argv: List[str] = None) -> None:
     parser = argparse.ArgumentParser(description="计算文件或文本的哈希值")
-    parser.add_argument("target", nargs="?", help="文件路径、文本或 '-' 表示 stdin")
+    parser.add_argument("target", nargs="?", help="文件路径、文本或 '-'")
     parser.add_argument("-a", "--algo", choices=list(ALGO_MAP), help="仅输出指定算法")
+    parser.add_argument(
+        "-t", "--text", action="store_true", help="强制将 TARGET 视为文本"
+    )
     parser.add_argument("-l", "--list", action="store_true", help="列出支持的算法")
     args = parser.parse_args(argv)
 
@@ -88,22 +104,32 @@ def main(argv: List[str] = None) -> None:
         return
 
     if args.target is None:
-        parser.error("缺少参数 target（或改用 -l 查看算法列表）")
+        parser.error("缺少参数 TARGET（或改用 -l 查看算法列表）")
 
     try:
-        data = read_target(args.target)
+        stream = parse_input(args)
     except OSError as e:
-        print(f"{Colors.ERR}读取失败: {e}{Colors.END}", file=sys.stderr)
+        print(f"{Colors.ERR}打开失败: {e}{Colors.END}", file=sys.stderr)
         sys.exit(2)
 
-    if args.algo:
-        print(
-            f"{Colors.BOLD}{args.algo.upper()}{Colors.END}: {calc_hash(data, args.algo)}"
-        )
-    else:
+    # 要算哪些算法
+    to_calc = [args.algo] if args.algo else sorted(ALGO_MAP)
+
+    # 统一走 multi_hash_stream
+    if hasattr(stream, "seek"):
+        stream.seek(0)
+    results = multi_hash_stream(stream, to_calc)
+
+    # 输出
+    if args.algo:  # 单算法
+        print(f"{Colors.BOLD}{args.algo.upper()}{Colors.END}: " f"{results[args.algo]}")
+    else:  # 多算法
         print(f"{Colors.BOLD}哈希值:{Colors.END}")
         for k in sorted(ALGO_MAP):
-            print(f"  {k.upper()}: {calc_hash(data, k)}")
+            print(f"  {k.upper()}: {results[k]}")
+
+    if hasattr(stream, "close"):
+        stream.close()
 
 
 if __name__ == "__main__":

image-toolkit/convert_img.py

@@ -0,0 +1,163 @@
+# -*- coding: utf-8 -*-
+"""
+convert_img.py
+通用图片格式/分辨率批量转换工具
+
+用法:
+    ./convert_img.py input.png
+    ./convert_img.py input.png -f webp -r 800x600
+    ./convert_img.py input.png -r 1920x1080 --no-ratio -q 90
+    ./convert_img.py --list-input
+    ./convert_img.py --list-output
+"""
+import os
+import sys
+import datetime
+import argparse
+from PIL import Image, ImageOps
+
+
+# -------------------- 列表格式 --------------------
+def list_input_formats():
+    """Pillow 能读取的格式"""
+    return sorted(
+        {
+            ext.lstrip(".").lower()
+            for ext, fmt in Image.registered_extensions().items()
+            if fmt in Image.OPEN
+        }
+    )
+
+
+def list_output_formats():
+    """Pillow 能写入的格式"""
+    return sorted(
+        {
+            ext.lstrip(".").lower()
+            for ext, fmt in Image.registered_extensions().items()
+            if fmt in Image.SAVE
+        }
+    )
+
+
+# -------------------- 分辨率解析 --------------------
+def parse_resolution(s: str):
+    try:
+        w, h = map(int, s.lower().split("x"))
+        return w, h
+    except Exception:
+        raise argparse.ArgumentTypeError("分辨率格式必须是 宽x高，例如 800x600")
+
+
+# -------------------- 核心转换 --------------------
+def convert_image(
+    src_path, dst_template: str, dst_size=None, keep_ratio=True, quality=95
+):
+    """
+    :param dst_template: 带 {} 占位符的路径模板，例如
+                         '/tmp/demo_20250920_{}x{}.webp'
+    """
+    with Image.open(src_path) as im:
+        im = ImageOps.exif_transpose(im).convert("RGBA")
+
+        # 1. 缩放并拿到真实分辨率
+        if dst_size:
+            src_w, src_h = im.size
+            dst_w, dst_h = dst_size
+            if keep_ratio:
+                ratio = min(dst_w / src_w, dst_h / src_h)
+                dst_w, dst_h = int(src_w * ratio), int(src_h * ratio)
+            im = im.resize((dst_w, dst_h), Image.LANCZOS)
+        else:
+            dst_w, dst_h = im.size  # 未指定分辨率就用原图尺寸
+
+        # 2. 生成最终路径
+        dst_path = dst_template.format(dst_w, dst_h)
+
+        # 3. 保存
+        save_kw = {}
+        ext = os.path.splitext(dst_path)[1].lower()
+        if ext in (".jpg", ".jpeg"):
+            im = im.convert("RGB")
+            save_kw.update(quality=quality, optimize=True)
+        elif ext == ".webp":
+            save_kw.update(quality=quality)
+        elif ext == ".png":
+            save_kw.update(optimize=True)
+
+        im.save(dst_path, **save_kw)
+        print(f"✅ 已生成 -> {dst_path}")
+
+
+# -------------------- 命令行入口 --------------------
+def main(argv=None):
+    parser = argparse.ArgumentParser(description="万能图片转换小工具")
+    parser.add_argument("input", nargs="?", help="输入图片路径")
+    parser.add_argument(
+        "-f", "--format", help="输出格式（jpg/png/bmp/webp/...），默认保持原格式"
+    )
+    parser.add_argument(
+        "-r",
+        "--resolution",
+        type=parse_resolution,
+        help="目标分辨率 宽x高，例如 800x600",
+    )
+    parser.add_argument(
+        "--no-ratio", action="store_true", help="不保持宽高比（默认保持）"
+    )
+    parser.add_argument("-o", "--output", help="输出目录（默认跟输入图片同目录）")
+    parser.add_argument(
+        "-q", "--quality", type=int, default=95, help="JPEG/WebP 质量，默认 95"
+    )
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument(
+        "--list-input", action="store_true", help="列出本脚本支持的所有输入格式"
+    )
+    group.add_argument(
+        "--list-output", action="store_true", help="列出本脚本支持的所有输出格式"
+    )
+
+    args = parser.parse_args(argv)
+
+    # ---- 列表模式 ----
+    if args.list_input:
+        print("本脚本支持的输入格式：")
+        print(" ".join(list_input_formats()))
+        return
+    if args.list_output:
+        print("本脚本支持的输出格式：")
+        print(" ".join(list_output_formats()))
+        return
+
+    # ---- 转换模式 ----
+    if not args.input:
+        parser.print_help()
+        sys.exit("请提供输入文件，或使用 --list-input / --list-output 查看支持格式")
+    if not os.path.isfile(args.input):
+        sys.exit("输入文件不存在")
+
+    out_dir = args.output or os.path.dirname(os.path.abspath(args.input))
+    os.makedirs(out_dir, exist_ok=True)
+
+    src_ext = os.path.splitext(args.input)[1][1:].lower()
+    dst_ext = (args.format or src_ext).lower().strip(".")
+    if dst_ext == "jpeg":
+        dst_ext = "jpg"
+
+    date_str = datetime.datetime.now().strftime("%Y%m%d")
+    dst_template = os.path.join(
+        out_dir,
+        f"{os.path.splitext(os.path.basename(args.input))[0]}_{date_str}_{{}}x{{}}.{dst_ext}",
+    )
+
+    convert_image(
+        args.input,
+        dst_template,
+        dst_size=args.resolution,
+        keep_ratio=not args.no_ratio,
+        quality=args.quality,
+    )
+
+
+if __name__ == "__main__":
+    main()