变更日志
========

0.4.5
-----

CLI 重构
~~~~~~~~

- 新增 ``pf`` 统一入口：通过 ``pf <tool> [command] [options]`` 调用所有工具
- 13 个工具迁移到 YAML 配置（filedate/filelevel/folderback/folderzip/screenshot/sshcopyid/lscalc/bumpversion/autofmt/piptool/packtool/pdftool/gittool）
- YAML 配置支持 ``cli:`` 段声明命令行参数 schema，由 ``build_cli_parser`` 自动生成 argparse
- 删除 13 个冗余 ``.py`` 入口脚本，统一通过 ``pf`` 调用
- ``run()`` 在 ``verbose=True`` 时自动把 verbose 标记应用到所有 spec
- 全局选项 ``--verbose`` 改为 ``--quiet``（默认显示执行过程）
- ``cmd`` 任务成功时打印 stdout（此前被静默丢弃）
- ``gittool`` 用 ``CLEAN_EXCLUDES`` 数组变量配置 ``git clean -e`` 参数

YAML 任务编排
~~~~~~~~~~~~~

- 支持 ``variables`` 变量定义，``${VAR}`` 在 cmd/env/cwd 中替换
- 列表变量展开为 cmd 数组多个元素
- ``cli:`` 段支持 subcommands/positional/options 三级 schema
- 支持 ``type: path`` 自动转为 ``pathlib.Path``

文档
~~~~

- 搭建 Sphinx 文档，发布到 ReadTheDocs
- 更新 README：CLI 示例改为 ``pf`` 统一入口，模块结构表补全

0.3.x
-----

- 新增 YAML 任务编排（GitHub Actions 风格 schema）
- 新增 ``fn:`` 函数引用与 ``register_fn`` / ``get_fn`` 注册中心
- 新增 ``compose`` / ``GraphComposer`` 多图组合
- 新增 ``task_template`` 任务模板工厂
- 新增 ``concurrency_key`` + ``concurrency_limits`` 并发限制
- 新增 ``JSONBackend`` 断点续跑与 ``batch()`` 批量落盘
- 新增 ``cache_key`` 缓存键函数
- 新增条件执行（``IS_WINDOWS`` / ``HAS_INSTALLED`` / ``ENV_VAR_EQUALS`` 等）
- 四种执行策略：``sequential`` / ``thread`` / ``async`` / ``dependency``
- 参数名即依赖的上下文注入机制