92 Commits

Author	SHA1	Message	Date
zhou	529a024ea1	feat(cli): rich 深度集成 — 执行生命周期 ✓/✗/▸/○ 符号 + dry-run + 命令输出	2026-07-06 22:27:25 +08:00
zhou	fca6f17a5c	chore: 升级项目适配 Python 3.10+ 并重构代码 ... 1. 移除对 Python 3.8/3.9 的支持，更新 tox、pyproject.toml 配置 2. 替换 typing 导入为 collections.abc 标准库类型 3. 重构 CLI 系统从 argparse 迁移到 typer 4. 优化代码格式与类型注解，修复多处类型兼容问题 5. 更新依赖声明，移除 graphlib_backport 兼容包	2026-07-06 22:14:59 +08:00
zhou	7a87a4177e	feat(ops): 新增 _common 共享辅助模块消除跨平台重复代码 ... 新增 src/pyflowx/ops/_common.py 提供 platform_command/ensure_platform/IGNORE_PATTERNS 三个公共 API, 配套 12 个单元测试; 修复上个提交中 8 个 ops 模块引用缺失模块导致的 ImportError.	2026-07-06 20:40:38 +08:00
zhou	04d6871e8d	chore: 发布v0.4.8版本，清理冗余代码并优化跨平台实现 ... 1. 移除folderzip和folderback模块中的默认导出函数与测试用例 2. 重构跨平台命令获取逻辑，统一使用platform_common工具函数 3. 移动IGNORE_PATTERNS常量到公共模块，精简packtool和autofmt代码 4. 重构平台检查逻辑，复用ensure_platform减少重复代码 5. 优化pdftool模块的依赖检查逻辑，提取公共检查函数 6. 修复测试用例中的字符串断言冗余内容	2026-07-06 20:22:59 +08:00
zhou	e31646e281	feat: 新增envdev、gittool、msdownload、pymake工具模块及对应测试用例 ... 新增四个业务工具模块： 1. envdev: 开发环境镜像源配置工具，支持Python/Conda/Rust镜像配置及Linux系统环境配置 2. gittool: Git操作工具，提供提交、初始化、清理、推送等快捷子命令 3. msdownload: ModelScope模型/数据集下载工具 4. pymake: 项目构建工具，覆盖构建、测试、发布等全流程开发操作 同时为每个工具模块编写了完整的注册验证与功能测试用例	2026-07-06 13:11:09 +08:00
zhou	f7fb95af83	refactor: 重构项目架构，移除YAML编排与旧注册系统 ... 1. 将所有YAML配置的工具迁移到`@px.tool`装饰器实现 2. 拆分`llm`模块为`msdownload`和`sglang`子模块 3. 移除废弃的`registry.py`、`yaml_loader.py`和`yamlrun.py`模块 4. 清理项目依赖，移除PyYAML相关包 5. 更新文档与测试用例适配新架构	2026-07-06 13:04:57 +08:00
zhou	6da42ec5ff	refactor: 移除YAML配置，统一使用@px.tool装饰器实现CLI工具 ... 1. 新增tools.py模块实现@px.tool装饰器与工具注册表 2. 将所有configs下的YAML工具迁移为ops/xxx.py模块形式 3. 重构cli路由逻辑，优先加载Python工具实现回退YAML 4. 删除所有YAML配置文件与旧的yaml_loader相关代码 5. 调整__init__.py导出API，移除YAML相关依赖	2026-07-06 07:53:22 +08:00
zhou	c55a37173a	test: 新增 YamlCliRunner 错误分支测试使覆盖率达标 95%	2026-07-05 22:25:15 +08:00
zhou	960b8672f4	test: 新增截图、PDF工具相关的单元测试 ... 1. 新增Linux平台下截图工具回退到scrot的测试用例 2. 新增pdf加密、解密、重排、PDF转图片的完整测试用例 3. 补充各PDF工具未安装依赖时的分支测试	2026-07-05 22:21:47 +08:00
zhou	4fd1d70b58	test: 修复跨平台路径断言不兼容问题 ... 1. 调整测试用例中的路径比较逻辑，统一替换反斜杠为正斜杠适配Windows平台 2. 将原生echo/true/false命令替换为跨平台的python执行命令，避免环境依赖问题	2026-07-05 22:18:16 +08:00
zhou	1f7127357e	refactor: 将 cli/system、cli/llm、cli/dev 脚本迁移为 YAML 配置 + register_fn 模式 ... 删除 cli/system (clearscreen/taskkill/which)、cli/llm (msdownload/sglang)、cli/dev (dockercmd/envdev) 三个目录; 新增 7 个 YAML 配置; 新增 ops/llm.py 模块; 扩展 ops/system.py 和 ops/dev.py; pf.py 添加工具别名; 删除 examples/ 目录	2026-07-05 21:12:41 +08:00
zhou	9a96e5d052	fix: 修复 bump_project_version 版本号不同步跳号 bug 并抽离到独立模块 ... 原实现对每个文件独立 +1, 文件版本号不同步时跳号; 改为先读取所有文件取 max 作为基准再统一写入. 同时修复 git add . 违规 (改按文件名) 与 check=False 吞错误. bumpversion 从 ops/dev.py 抽离到 ops/bumpversion.py, 测试简化为 16 个核心场景.	2026-07-05 19:34:44 +08:00
zhou	c498d9b1c9	feat: 实现方向 B 聚合 job 并消除 pymake/reseticoncache CLI 入口 ... 放宽 yaml_loader 校验允许有 needs 无 cmd/fn 的聚合 job, 完善 pymake.yaml 覆盖原 pymake.py 所有别名, 新增 reset_icon_cache_run fn 与 reseticoncache.yaml, 删除 pymake.py/reseticoncache.py 及对应 scripts 入口, 修复 --list 在 subcommands 模式下的可达性 bug.	2026-07-05 18:12:59 +08:00
zhou	d93da0d8b4	refactor: 迁移 cli/_ops/ 到 ops/, 按类别保持 dev/files/media/system 分类 ... 将 src/pyflowx/cli/_ops/ 整体迁移至 src/pyflowx/ops/, 与 cli/ 平级 (工具函数非 CLI 专属, 可被 YAML 任务编排通用引用). 分类保持不变: dev (git/pip/bump/autofmt), files (date/level/back/zip), media (pdf/screenshot), system (ls/pack/ssh). 同步更新 15 个引用文件 (yaml_loader + 14 个测试) 的 import 路径, README 模块结构表与 test_registry docstring.	2026-07-05 17:30:35 +08:00
zhou	32ca8c1208	docs: 搭建 Sphinx 文档站并清理死代码 ... 1. 新建 docs/ Sphinx 文档结构 (conf.py + 8 个 rst 章节), napoleon 支持 Google/NumPy docstring, rtd 主题, 自动生成 API 参考与错误家族文档 2. 新建 .readthedocs.yaml 配置, pyproject.toml 加 docs 依赖 3. 删除 runner.py 的 _apply_verbose_to_graph 死代码及对应测试 (功能已移入 executors.run 统一处理) 4. 更新 README: CLI 示例改为 pf 统一入口, 模块结构表补全 cli/pf.py/cli/configs/cli/_ops 等模块 5. 修复版本不一致 (pyproject.toml 0.3.5 → 0.4.5) 6. 加文档徽章链接到 ReadTheDocs	2026-07-05 12:17:10 +08:00
zhou	de368ea810	refactor: 删除冗余 cli 入口脚本, gittool 用数组配置 clean excludes ... 1. 删除 13 个已有 YAML 配置的 cli .py 入口脚本, 统一通过 pf 调用 2. gittool.yaml 用 CLEAN_EXCLUDES 数组变量配置 git clean 的 -e 参数, 保留 .venv/.tox/node_modules/.idea 等目录避免误删 3. run_cli 执行前打印调用信息: [gittool] 执行: c 4. 更新 pyproject.toml 移除 13 个冗余 entry points, 仅保留 pf 5. 清理测试文件中的 TestMain 类 (测 _ops 模块的测试保留)	2026-07-05 08:39:20 +08:00
zhou	12d9f2f647	fix: 恢复 gittool 条件逻辑,修复 has_files 检查 git status ... 将 gitt a/i 命令改用 fn job 包装(git_add_commit/git_init_add_commit), 内部检查 has_files() 和 not_has_git_repo() 条件,避免无更改时 git commit 报错。修正 has_files() 实现为检查 git status --porcelain 而非目录文件。	2026-07-04 20:00:25 +08:00
zhou	52e20e3f93	style: 统一调整代码格式，将单行列表展开为多行缩进格式	2026-07-04 19:49:10 +08:00
zhou	3f966a230e	refactor: 简化 CLI 工具入口为 YAML 加载器 ... 将 13 个工具入口文件重构为通过 px.run_yaml 调用 YAML 配置, 辅助函数移至 _ops 模块。新增 run_yaml 便捷函数支持 job 选择 和传递依赖收集,修复 _build_cmd 列表变量展开,新增 bump_project_version 高层函数封装版本号更新+git 提交流程。	2026-07-04 19:35:08 +08:00
zhou	5d0b211a44	feat: 新增 13 个 CLI 工具的 YAML 配置并修复 _ops 函数注册 ... - 在 cli/configs/ 下创建 13 个 YAML 工作流配置, 覆盖 filedate/filelevel/folderback/ folderzip/autofmt/bumpversion/piptool/gittool/pdftool/screenshot/lscalc/ sshcopyid/packtool 工具, 共 51 个 job (cmd 与 fn 混合) - yaml_loader 模块级导入 _ops 子模块, 使 YAML fn 字段可引用注册函数, try/except 守卫避免最小安装场景下的 ImportError - 修复 test_registry 的 clear_registry fixture: 保存/恢复 _REGISTRY 原始状态, 避免 teardown 清空 _ops 自动注册的函数导致 TestOpsModules 失败	2026-07-04 18:35:20 +08:00
zhou	6931f36fd1	feat: 新增函数注册机制与 CLI 工具函数模块 ... - 新增 registry.py 提供 register_fn/get_fn/has_fn 函数注册机制, 支持 @register_fn 和 @register_fn("name") 两种用法 - 新增 cli/_ops 包 (files/dev/media/system 四个子模块), 聚合 59 个可复用函数供 YAML fn 字段引用 - 扩展 yaml_loader 支持 fn 字段、args/kwargs 传参、${VAR} 变量占位符 - 新增 test_registry.py (20 个测试) 和扩展 test_yaml_loader.py - 更新自驱动规则: 自动 commit+push, 删除需要用户明确指示的步骤	2026-07-04 18:24:52 +08:00
zhou	db02443463	feat: 新增 YAML 任务编排功能 ... 1. 新增 yaml_loader 模块，支持加载 GitHub Actions 风格的 YAML 任务图 2. 新增 Graph.from_yaml 静态方法，支持从 YAML 文件构建任务图 3. 新增 yamlrun CLI 工具，支持执行、预览 YAML 任务流水线 4. 添加 pyyaml 运行时依赖与 types-PyYAML 开发依赖 5. 更新 README 文档与对外暴露的 API 接口	2026-07-04 16:00:04 +08:00
zhou	f699bb9167	chore: 升级pyflowx版本到0.3.2	2026-07-04 10:50:50 +08:00
zhou	85793ff9d5	test(cli): 为文件写入错误测试添加root权限跳过逻辑	2026-07-04 10:22:35 +08:00
zhou	43e1aad1fe	chore: 发布版本0.2.13并完善任务执行环境配置 ... 本次提交更新了版本号至0.2.13，同时完成多项改进： 1. 在.gitignore中新增忽略性能分析文件*_profile.html 2. 修复测试用例中echo命令在Windows下无法被正确检测的问题，改用python命令 3. 优化测试用例确保性能统计数据有效，添加耗时模拟函数 4. 为所有CLI任务统一配置项目根目录作为工作目录，解决跨平台执行路径问题 5. 新增测试验证所有任务的cwd配置正确性	2026-06-28 21:38:18 +08:00
zhou	ce31f60441	feat(cli): add pxp performance profiler command ... 1. 新增pxp CLI工具用于分析PyFlowX脚本生成性能报告 2. 新增ProfileReport.to_html方法生成自包含HTML报告 3. 新增完整的profiler功能测试用例 4. 更新pyproject.toml添加pxp入口点 5. 版本升级至0.2.12	2026-06-28 20:30:17 +08:00
zhou	3d6d769685	feat(profiling): 添加工作流性能分析模块与测试用例 ... 新增了性能剖面分析能力，支持从运行报告生成任务级、图级性能指标，包括关键路径、并行度分析和瓶颈识别，同时补充了完整的单元测试覆盖。	2026-06-28 19:59:25 +08:00
zhou	abc1152538	refactor(cli): 统一使用@px.task装饰器定义任务，重构任务注册和别名管理 ... 1. 将folderzip/folderback/gittool中的旧TaskSpec定义替换为@px.task装饰器 2. 重构pymake模块，将maturin_build_cmd转为常量定义，合并别名配置 3. 精简测试文件中的冗余测试用例	2026-06-28 18:12:30 +08:00
zhou	5e561b4b3a	refactor: 重构CliRunner，新增cmd工厂函数优化任务定义 ... 1. 新增cmd工厂函数，简化TaskSpec创建并自动推导名称 2. 重构CliRunner，将graphs参数替换为tasks+aliases，支持扁平任务注册与别名映射 3. 替换所有cli工具中的旧版任务定义方式，使用新API简化代码 4. 补充对应测试用例，适配新的运行器API	2026-06-28 17:52:52 +08:00
zhou	40f641611b	feat: 新增多项核心功能并优化默认执行策略 ... 1. 将CliRunner默认执行策略从sequential改为dependency 2. 新增RunReport的任务状态查询和时长统计方法 3. 实现task装饰器并补充executor参数文档 4. 新增进程池执行器支持CPU密集型任务 5. 新增Graph.chain链式构建和add_subgraph子图合并功能 6. 新增流式任务传递、进程池执行、命名空间等多类测试用例 7. 补充tests目录路径导入配置	2026-06-28 15:10:15 +08:00
zhou	232e7293d9	refactor(system): 简化write_file实现，使用pathlib替代手动文件操作。	2026-06-28 11:20:58 +08:00
zhou	9999071119	refactor(executors): 重构执行器逻辑，移除重复mixin并优化分层排序 ... 主要变更： 1. 将任务跳过/重试逻辑从类mixin改为模块级函数，减少代码重复 2. 优化_graph.layers()的前置校验逻辑，统一在run入口执行 3. 重构存储过期检查API，移除废弃的_expired方法 4. 优化TaskSpec.cache_key异常处理，增加指定异常捕获并记录警告 5. 修复verbose模式下的事件回调逻辑，正确触发RUNNING事件 6. 调整测试用例以适配新的API和行为变更	2026-06-28 08:25:15 +08:00
zhou	bdd70e9c43	refactor: 重构项目代码结构，拆分职责模块 ... 1. 抽离图组合逻辑到pyflowx.compose，原graph.py仅保留单图DAG逻辑 2. 抽离命令执行逻辑到pyflowx.command，移除task.py内的_run_command 3. 重构上下文签名缓存，优化性能 4. 移除废弃的utils.perf_timer相关代码 5. 为JSONBackend添加batch批量落盘优化 6. 调整导入路径与公开API，更新测试用例 7. 简化条件判断逻辑，移除冗余代码	2026-06-28 02:28:38 +08:00
zhou	7d4e8a40ce	refactor(cli): 重构CLI模块结构，整理系统工具与开发工具 ... 1. 将原cli根目录下的clearscreen、taskkill、which工具迁移到cli/system子目录 2. 新增cli/dev子目录并添加envdev环境配置工具 3. 更新pyproject.toml中的脚本入口点映射 4. 调整tests/cli下的测试文件导入路径 5. 整理tasks/system.py的__all__导出顺序	2026-06-27 22:01:02 +08:00
zhou	df890f0f16	chore: 移除独立的envpy和envrs命令，合并功能到envdev ... 将原来envpy和envrs的环境配置功能整合到envdev命令中，删除了冗余的独立CLI模块和测试文件，统一管理Python、Conda和Rust的环境配置。	2026-06-27 21:22:36 +08:00
zhou	b62a544569	chore: 调整Python版本与依赖适配，新增性能报告测试与工具函数 ... 1. 将Python版本从3.13降级到3.11 2. 为typing-extensions添加版本适配标记 3. 简化dev依赖组，移除pysnooper 4. 重构perf_timer，提取_generate_report独立函数 5. 新增性能报告生成与测试用例	2026-06-27 20:47:29 +08:00
zhou	d58fc5536e	chore: 发布 pyflowx 0.2.10，新增性能计时器与多项重构 ... 1. 新增 perf_timer 工具与配套测试用例 2. 重构任务条件跳过逻辑，优化失败条件展示 3. 重构 Graph 子图生成逻辑，提取公共依赖修剪函数 4. 重构条件模块，统一条件名称与失败原因获取逻辑 5. 重构存储后端，提取 TTL 共享逻辑并优化实现 6. 重构执行器模块，使用 Mixin 复用代码，拆分任务与层执行逻辑 7. 删除冗余的 which 命令测试文件 8. 更新依赖锁文件	2026-06-27 20:15:35 +08:00
zhou	65dcbcbf62	bump version to 0.2.9	2026-06-27 16:42:10 +08:00
zhou	7fa97a01e3	test(executors): add future annotations import to edge case test file ... 为测试文件添加from __future__ import annotations以支持更规范的类型注解写法	2026-06-27 16:33:24 +08:00
zhou	83da5135d0	test: add tests for graph all_deps and defaults inheritance ... - add test_all_deps_combines_hard_and_soft to verify all_deps returns correct hard+soft deps in order - add multiple tests for GraphDefaults field inheritance, including normal inheritance and non-override of custom values	2026-06-27 16:32:34 +08:00
zhou	7463a60649	test: 修复代码检查警告并优化测试用例 ... 1. 为测试代码添加pyrefly忽略注释解决类型检查警告 2. 优化lambda参数命名为通配符符合PEP8规范 3. 增加断言检查任务函数非空并修正参数传递 4. 统一环境变量测试的命名和清理逻辑	2026-06-27 16:26:56 +08:00
zhou	87dd010342	test: add multiple new test cases and update python version ... 1. update .python-version from 3.11 to 3.13 2. add tests for IS_RUNNING and DIR_EXISTS conditions 3. add graph-related tests including string ref parsing, mermaid output, GraphComposer and compose function 4. add storage backend TTL tests for both MemoryBackend and JSONBackend 5. add new system task tests for clr, reset_icon_cache, setenv and which 6. add comprehensive task spec tests including soft dependencies, retry policy, context managers and task template 7. add executor edge case tests for various scenarios	2026-06-27 16:17:05 +08:00
zhou	a7b7a82dff	ci: 完善CI/CD流程，添加测试覆盖率与并行测试配置 ... 1. 为tox测试命令添加并行执行、覆盖率报告和JUnit结果输出 2. 拆分CI工作流为lint、格式检查、类型检查、安全审计、多矩阵测试和覆盖率汇总 3. 新增release前的预测试步骤，让build依赖测试通过 4. 移除低效的依赖策略测速测试用例 5. 配置多Python版本跨平台测试矩阵并上传测试 artifacts	2026-06-27 15:53:08 +08:00
zhou	2b3f4b82d3	bump version to 0.2.7	2026-06-27 15:23:48 +08:00
zhou	5c8ec281ff	refactor: 重构重试策略、条件函数与上下文注入逻辑 ... 主要变更： 1. 替换旧retries参数为RetryPolicy配置 2. 重构条件函数，支持上下文参数与动态依赖判断 3. 更新上下文注入逻辑，支持软依赖与更清晰的注入描述 4. 新增sglang CLI命令与相关配置 5. 格式化代码统一列表与参数写法 6. 更新文档与测试用例适配新API	2026-06-27 14:33:54 +08:00
zhou	bcd189ae60	refactor(graph,runner): 重构引用解析逻辑，拆分GraphComposer ... 1. 抽离CliRunner中的引用解析逻辑为GraphComposer类，分离图数据与组合职责 2. 取消Graph的frozen修饰，简化内部属性修改逻辑 3. 重构任务执行与跳过逻辑，合并重复代码并优化条件求值时机 4. 调整TaskSpec为普通dataclass，移除不必要的replace重建 5. 修复测试用例中skip_if_missing的断言值 6. 重构命令执行逻辑，抽离为模块级函数避免闭包捕获参数	2026-06-27 10:13:52 +08:00
zhou	20c4fb87c5	feat: 添加上游任务跳过豁免、进程检查条件及相关优化 ... 1. 新增allow_upstream_skip参数支持任务不跟随上游跳过 2. 新增IS_RUNNING内置条件检查进程运行状态 3. 调整skip_if_missing默认值为False 4. 补充跳过任务的事件上报和verbose打印 5. 优化reset_icon_cache示例任务使用新特性 6. 更新测试用例匹配默认参数变更	2026-06-27 09:24:22 +08:00
zhou	f15f235ecf	chore: 发布v0.2.6版本，新增重置图标缓存工具 ... 1. 新增reseticon命令行工具用于重置Windows图标缓存 2. 重构平台常量导出逻辑，移除顶层直接导出的IS_*变量 3. 为系统任务相关的TaskSpec添加verbose输出 4. 优化测试用例的列表格式和平台条件写法 5. 更新依赖锁定文件和项目配置	2026-06-27 08:45:48 +08:00
zhou	10bbc07118	refactor(cli): 重构清屏和which命令实现 ... 1. 提取清屏、设置环境变量、命令查找逻辑到system任务模块 2. 统一命令行工具的任务实现方式，减少重复代码 3. 修正pyproject.toml中的cli命令名拼写错误 4. 移除过时的测试用例代码	2026-06-26 23:27:45 +08:00
zhou	22ac9fc4dd	test: 完善多份测试用例的类型标注与校验逻辑 ... 1. 为多个测试函数补充pytest.CaptureFixture[str]类型注解 2. 为graphlib类型声明文件补全方法参数类型 3. 为pdftool测试的mock函数添加Any类型标注 4. 新增数据库连接非空校验断言 5. 优化emlmanager测试的字典展开格式与修复decode测试bug 6. 为gittool测试添加命令类型列表校验 7. 为envrs测试添加pyrefly忽略注释	2026-06-26 21:57:44 +08:00