25 Commits

Author	SHA1	Message	Date
zhou	8b8598fa41	perf: P8 性能优化 — 自实现 Kahn 拓扑排序替换 graphlib(diamond-1000 1.62x)、_json.py 抽象层支持 orjson 可选加速、dataclass slots=True 内存优化(TaskSpec 15.5% 减少)、线程池跨层复用与 get_running_loop 兼容 3.12+；iter-16~20 归档到 skills	2026-07-07 17:11:34 +08:00
zhou	a9f15e236d	feat: P7 功能增强 — 通知器扩展(Slack/Discord/Telegram)、HTML 报告导出(to_html)、YAML 增强(matrix include-exclude/条件依赖/outputs)、缓存增强(invalidate 单键失效/MemoryBackend LRU 驱逐)	2026-07-07 16:26:46 +08:00
zhou	9573f1f2a2	refactor: 质量收尾 — diagnostics.py pragma 清理（4 处：1 激活 3 删除）、context.py 与 reseticoncache.py 覆盖率提升至 100%、README 同步 pyrefly、iter-06~15 归档到 skills/pyflowx-development/SKILL.md。	2026-07-07 15:45:21 +08:00
zhou	02ef858718	feat: CLI 体验增强 — yamlrun --list 过滤, graph --color-by tag 着色, pf info 工具详情, pf completion shell 补全	2026-07-07 14:35:16 +08:00
zhou	5e6daa554f	feat: 观测性增强 — RunReport.run_id 贯穿日志/序列化, 结构化 extra 字段, profile() 便捷方法	2026-07-07 14:08:18 +08:00
zhou	520694f2df	feat: 失败诊断增强 — RunReport.diagnose() 根因分析与依赖链回溯 ... 新增 diagnostics 模块：根因识别、依赖链 BFS 回溯、相似失败聚类、 常见异常可操作建议；TaskFailedError 携带 report 供 CLI 打印诊断摘要。	2026-07-07 13:52:43 +08:00
zhou	8d626f606e	feat: 新增 pf graph 终端 DAG 可视化命令与 yamlrun --progress 选项 ... pf graph 支持 ASCII 分层树/Mermaid/list/deps 四种输出格式； yaml_loader._safe_load 包装 YAMLError 为 ValueError 统一错误处理。	2026-07-07 12:58:44 +08:00
zhou	6499210dc9	feat: RunReport 结果序列化支持 to_json/to_dict/to_csv/from_json ... 新增 RunReport 序列化方法，支持 JSON/dict/CSV 多格式导出与反序列化重建； 非 JSON 可序列化值默认回退到 repr，可通过 value_serializer 自定义。	2026-07-07 12:51:06 +08:00
zhou	7b5e4864c2	feat: 新增子图执行 — Graph.subgraph_with_deps 计算传递闭包, run(only=/tags=) 按名称或标签运行图子集, yamlrun CLI 支持 --only/--tags; 修复 test_executors.py 中 TaskStatus 缺少 px. 前缀的预存问题	2026-07-07 12:44:50 +08:00
zhou	6614dc5a8d	feat(cancellation): 新增任务取消与优雅停止 — CancelToken 线程安全取消令牌, run(cancel_event=) 支持外部取消与 KeyboardInterrupt 优雅停止; 各策略在层/任务边界检查取消信号, 待运行任务标记 SKIPPED; 提取 _dispatch_strategy 辅助函数控制 run() PLR0912 分支数	2026-07-07 11:53:27 +08:00
zhou	9f50bb3e7c	feat: 实现 GitHub Actions 风格 YAML 任务编排 ... 新增 yaml_loader 模块支持 jobs/needs/strategy.matrix/if 条件/env/defaults 等 CI/CD 概念， Graph.from_yaml classmethod 与 pf yamlrun CLI 命令；矩阵笛卡尔积展开与依赖自动展开， ${{ matrix.key }} 占位符替换，字段名 hyphen/underscore 兼容。	2026-07-07 11:27:16 +08:00
zhou	8cfdef7516	docs: 对齐 README 与实际代码状态, 清理过期文档 — 移除未实现的 YAML 编排特性声明与整章, 修正覆盖率徽章 100%→97%, 修正依赖描述(实际 rich+typer+typing-extensions, 无 PyYAML), 修正 CLI 模块路径(profiler/emlmanager 已迁至 cli/legacy/); 归档 iter-01~05 迭代记录(设计决策已存 project_memory.md), 删除过期重构计划文档; 保留 typing_extensions 守卫(3.12/3.13 前向兼容非 3.8 死代码)	2026-07-07 11:11:04 +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	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	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	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	d0ff7d7b4d	docs: 更新 README 与新增 Python 开发规范文档 ... 本次提交大幅完善了 PyFlowX 的 README 文档，新增了四种执行策略、软依赖、并发限制、任务钩子等多项特性说明，补充了任务模板、图组合、缓存键等新功能的使用示例，同时更新了执行参数、执行策略对照表与模块结构文档。另外新增了 .trae/rules/python-standards.md 规范文档，统一了项目的代码风格、类型检查、测试编写等开发标准。	2026-06-28 09:34:45 +08:00
zhou	af8a074484	chore: add LICENSE file and format README.md ... - add MIT LICENSE file for the project - reformat README.md code block indentation for better readability	2026-06-21 19:15:39 +08:00
zhou	ea591d1088	feat: 新增skip_if_missing特性，支持命令不存在时自动跳过任务 ... 本次提交实现了命令任务的自动跳过功能： 1. 为TaskSpec新增skip_if_missing参数，默认开启，仅对list[str]类型cmd生效 2. 通过shutil.which检查命令是否存在，不存在则标记任务为SKIPPED而非失败 3. 重构should_execute方法，整合条件检查与命令可用性检查 4. 更新文档与示例代码，添加该参数的使用说明 5. 移除cli/pymake.py中的冗余check辅助函数，改用内置特性 6. 为所有内置任务添加skip_if_missing=True配置 7. 修复线程并行测试的超时阈值，放宽到1.0秒 8. 优化代码格式与压缩单行表达式 9. 新增完整的单元测试覆盖该特性的各种场景	2026-06-21 18:55:24 +08:00
zhou	cae51856d2	~CI config	2026-06-21 18:20:48 +08:00
zhou	be03662e4c	更新CI	2026-06-21 18:17:28 +08:00
zhou	7de55614a6	chore: 提高测试覆盖率.	2026-06-21 15:31:53 +08:00
zhou	0b995d66c3	refactor: 重构代码风格与配置，完善文档与CI ... 1. 移除冗余导入与简化代码写法 2. 更新coverage配置与pre-commit钩子 3. 重构CI流程，拆分lint/typecheck/test任务 4. 汉化项目文档与注释 5. 修正graphlib导入的类型忽略注释	2026-06-20 13:39:03 +08:00
zhou	70f3c03986	init commit	2026-06-20 09:33:53 +08:00