celestialflow 3.0.9__tar.gz → 3.1.1__tar.gz

{celestialflow-3.0.9 → celestialflow-3.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: celestialflow
-Version: 3.0.9
+Version: 3.1.1
 Summary: A flexible GRAPH-based task orchestration framework.
 Author-email: Mr-xiaotian <mingxiaomingtian@gmail.com>
 License: MIT
@@ -49,16 +49,16 @@ Requires-Dist: celestialtree
 - 相比 Airflow/Dagster 更轻、更快开始
 - 相比 multiprocessing/threading 更结构化，可直接表达 loop / complete graph 等复杂依赖模式
 
-框架的基本单元为 **TaskManager**，可独立运行，并支持四种执行模式：
+框架的基本单元为 **TaskExecutor**，可独立运行，并支持四种执行模式：
 
 * **线性（serial）**
 * **多线程（thread）**
 * **多进程（process）**
 * **协程（async）**
 
-TaskManager 实现了对任务的结果缓存，任务去重，进度条显示，多执行模式比较等功能，单独使用也很好用。
+TaskExecutor 实现了对任务的结果缓存，任务去重，进度条显示，多执行模式比较等功能，单独使用也很好用。
 
-但除去直接使用 TaskManager，更重要的是使用其子类**TaskStage**。TaskStage 可以互相连接，形成具有上游与下游依赖关系的任务图（**TaskGraph**）。下游 stage 会自动接收上游执行完成的结果作为输入，从而形成明确的数据流。
+但除去直接使用 TaskExecutor，更重要的是使用其子类**TaskStage**。TaskStage 可以互相连接，形成具有上游与下游依赖关系的任务图（**TaskGraph**）。下游 stage 会自动接收上游执行完成的结果作为输入，从而形成明确的数据流。
 
 TaskStage 的任务执行模式只有两种：
 
@@ -130,13 +130,17 @@ flowchart LR
 安装 CelestialFlow:
 
 ```bash
-pip install celestialflow
+# 推荐使用 `uv` 管理依赖与环境
+uv pip install celestialflow
+
+# 不过也可以直接使用 `pip`
+uv pip install celestialflow
 ```
 
 一个简单的可运行代码:
 
 ```python
-from celestialflow import TaskManager, TaskGraph
+from celestialflow import TaskStage, TaskGraph
 
 def add(x, y): 
     return x + y
@@ -146,8 +150,8 @@ def square(x):
 
 if __name__ == "__main__":
     # 定义两个任务节点
-    stage1 = TaskManager(add, execution_mode="thread", unpack_task_args=True)
-    stage2 = TaskManager(square, execution_mode="thread")
+    stage1 = TaskStage(add, execution_mode="thread", unpack_task_args=True)
+    stage2 = TaskStage(square, execution_mode="thread")
 
     # 构建任务图结构
     stage1.set_graph_context([stage2], stage_mode="process", stage_name="Adder")
@@ -172,8 +176,9 @@ if __name__ == "__main__":
 
 若你想了解框架的整体结构与核心组件，下面的参考文档会对你有帮助：
 
-- [🔧TaskManage/TaskStage概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_manage.md)
-- [🌐TaskGrapg概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_graph.md)
+- [🔧TaskExecutor概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_executor.md)
+- [🔧TaskStage概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_stage.md)
+- [🌐TaskGraph概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_graph.md)
 - [📚Go Worker概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/go_worker.md)
 
 推荐阅读顺序:
@@ -182,7 +187,7 @@ if __name__ == "__main__":
 flowchart TD
     classDef whiteNode fill:#ffffff,stroke:#000000,color:#000000;
 
-    TM[TaskManage.md] --> TS[TaskStage.md] --> TG[TaskGraph.md]
+    TM[TaskExecutor.md] --> TS[TaskStage.md] --> TG[TaskGraph.md]
     TM --> TP[TaskProgress.md]
 
     TG --> TQ[TaskQueue.md]
@@ -201,6 +206,7 @@ flowchart TD
 - [TaskTools](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_tools.md)
 - [TaskTypes](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_types.md)
 - [TaskLogging](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_logging.md)
+- [TaskErrors](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_errors.md)
 
 如果你更喜欢通过完整案例理解框架的运行方式，可以参考这篇从零开始构建 TaskGraph 的教程：
 
@@ -230,100 +236,13 @@ flowchart TD
 
 ## 文件结构（File Structure）
 
-```
-📁 CelestialFlow	(224MB 407KB 500B)
-    📁 docs         	(34KB 944B)
-        📁 reference	(29KB 995B)
-            📝 ctree_client.md  	(6KB 997B)
-            📝 go_worker.md     	(6KB 378B)
-            📝 task_graph.md    	(4KB 989B)
-            📝 task_logging.md  	(0B)
-            📝 task_manage.md   	(7KB 499B)
-            📝 task_nodes.md    	(4KB 68B)
-            📝 task_progress.md 	(0B)
-            📝 task_queue.md    	(0B)
-            📝 task_report.md   	(0B)
-            📝 task_stage.md    	(0B)
-            📝 task_structure.md	(112B)
-            📝 task_tools.md    	(0B)
-            📝 task_types.md    	(0B)
-            📝 task_web.md      	(0B)
-        📝 quick_start.md	(4KB 973B)
-        📝 tutorial.md   	(0B)
-    📁 experiments  	(15KB 111B)
-        🐍 benchmark_datastructures.py	(6KB 52B)
-        🐍 benchmark_hash.py          	(1KB 284B)
-        🐍 benchmark_queue.py         	(5KB 504B)
-        🐍 benchmark_tqdm.py          	(1KB 160B)
-        🐍 experiment_tqdm.py         	(1KB 135B)
-    📁 go_worker    	(6MB 968KB 38B)
-        📁 worker	(5KB 746B)
-            🌀 parser.go   	(394B)
-            🌀 processor.go	(2KB 612B)
-            🌀 types.go    	(299B)
-            🌀 worker.go   	(2KB 465B)
-        ❓ go.mod       	(292B)
-        ❓ go.sum       	(1KB 68B)
-        ❓ go_worker.exe	(6MB 960KB)
-        🌀 main.go      	(980B)
-    📁 img          	(4MB 700KB 695B)
-        📷 logo(old).png  	(836KB 542B)
-        📷 logo.png       	(122KB 747B)
-        📷 web_display.png	(129KB 545B)
-        🎞️ web_ui.gif     	(3MB 635KB 909B)
-    📁 src          	(1MB 929KB 111B)
-        📁 celestialflow         	(1MB 911KB 486B)
-            📁 static     	(1MB 417KB 367B)
-                📁 css	(31KB 621B)
-                    🎨 base.css     	(6KB 181B)
-                    🎨 dashboard.css	(7KB 414B)
-                    🎨 errors.css   	(5KB 216B)
-                    🎨 inject.css   	(12KB 834B)
-                📁 js 	(33KB 672B)
-                    📜 main.js          	(5KB 65B)
-                    📜 task_errors.js   	(4KB 595B)
-                    📜 task_injection.js	(8KB 484B)
-                    📜 task_statuses.js 	(8KB 51B)
-                    📜 task_structure.js	(4KB 709B)
-                    📜 task_topology.js 	(1KB 375B)
-                    📜 utils.js         	(1KB 441B)
-                ❓ favicon.ico	(1MB 352KB 98B)
-            📁 templates  	(13KB 174B)
-                🌐 index.html	(13KB 174B)
-            📁 [1项排除的目录]	(339KB 553B)
-            🐍 task_graph.py    	(26KB 700B)
-            🐍 task_logging.py  	(10KB 282B)
-            🐍 task_manage.py   	(36KB 110B)
-            🐍 task_nodes.py    	(10KB 814B)
-            🐍 task_progress.py 	(1KB 477B)
-            🐍 task_queue.py    	(10KB 948B)
-            🐍 task_report.py   	(4KB 828B)
-            🐍 task_stage.py    	(6KB 577B)
-            🐍 task_structure.py	(7KB 255B)
-            🐍 task_tools.py    	(17KB 19B)
-            🐍 task_types.py    	(2KB 269B)
-            🐍 task_web.py      	(6KB 235B)
-            🐍 __init__.py      	(1KB 22B)
-        📁 [1项排除的目录]	(17KB 649B)
-    📁 tests        	(126KB 724B)
-        📁 [1项排除的目录]	(90KB 464B)
-        🐍 conftest.py      	(49B)
-        📝 README.md        	(6KB 324B)
-        🐍 test_graph.py    	(5KB 547B)
-        🐍 test_manage.py   	(3KB 90B)
-        🐍 test_nodes.py    	(11KB 218B)
-        🐍 test_structure.py	(10KB 56B)
-    📁 [6项排除的目录]	(210MB 685KB 450B)
-    ❓ .env          	(88B)
-    ❓ .gitignore    	(272B)
-    ❓ LICENSE       	(1KB 65B)
-    ❓ Makefile      	(501B)
-    ❓ pyproject.toml	(1KB 594B)
-    📝 README.md     	(16KB 3B)
-(celestial-flow 3.0.9)
-```
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Mr-xiaotian/CelestialFlow/main/img/file_structure.svg" alt="FileStructure" />
+  <br/>
+  <em>celestial-flow 3.1.1</em>
+</p>
 
-(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file.FileTree.print_tree()生成。)
+(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file.FileTree.print_tree()生成。转换为图片则借助[Carbon](https://carbon.now.sh)。)
 
 ## 更新日志（Change Log）
 
@@ -342,17 +261,35 @@ flowchart TD
 - 3.0.4: 新增一个抽象结构TaskQueue, 用于表示节点的所有"入边"与"出边"; 恢复未消费任务的保存功能
 - 3.0.5: 删除原有的TaskRedisTransfer节点, 并增添三种新的redis交互节点TaskRedisSink TaskRedisSource TaskRedisAck, 用于跨语言 跨进程 跨设备处理任务; 并在Web页面添加展示拓扑信息的卡片
 - 3.0.6: 添加对[CelestialTree](https://github.com/Mr-xiaotian/CelestialTree)系统的支持, 现在可以追踪单个任务的流向
-- 3.0.7: 将TaskStage从TaskManager中单独抽出来作为一个子类; 增加新节点TaskRouter, 可以将传入的任务选择的传给不同的下游节点, 而不是进行广播
+- 3.0.7: 将TaskStage从TaskExecutor中单独抽出来作为一个子类; 增加新节点TaskRouter, 可以将传入的任务选择的传给不同的下游节点, 而不是进行广播
 - 3.0.8: 在ctree逻辑上将"任务重试"事件后的"任务成功/失败/重试"事件视为因果关系, 而非之前的并行关系; 重构错误搜集部分逻辑; 修复大量3.0.6与3.07版本引入的bug; 优化部分log表现
-- 3.0.9: 1/23/2026
+- 3.0.9: 
   - 更新前端mermaid显示中部分节点图标; 
-  - 对ctree_client的大量修改; 
+  - 对ctree_client进行匹配CelestialTree的大量修改; 
   - 将ctree_client移出为单独的project; 
   - 在前端中添加error_id的显示, 为之后显示provenance_tree做准备; 
   - 增加大量warning与error, 用于提醒不规范设置; 
   - 优化前后端中错误数据的传输方式, 在大量错误数据时减少内存消耗; 
   - 优化TaskLogger中log队列的准入机制; 
-  - 修改部分Bug
+  - 修改部分Bug;
+- 3.1.0:
+  - 新增:
+    - 优化web端仪表盘页面的"总体状态摘要"卡片, 新增"总重复任务"与"总剩余市场", 后者由节点间拓扑关系计算而成, 后续还需要优化;
+  - 修复:
+    - 3.0.9版本下当web端与celestialflow运行端不同时, error数据无法传递的问题;
+    - 修复NullTaskReporter使用问题;
+- 3.1.1:
+  - 新增:
+    - [Important] CelestialTree中引入grpc, 这大大减少了emit操作的耗时;
+    - [Important] 为TerminationSignal添加id, 并可以像task一样通过CelestialTree进行跟踪;
+    - 优化task_graph与task_executor的log分级, 现在默认为"SUCCESS"级;
+    - 将go_worker部分分离为单独project: [celestialflow-goworker]https://github.com/Mr-xiaotian/celestialflow-goworker
+    - 在readme中使用svg图片来展示文件夹结构;
+    - 优化全局剩余时间的计算;
+    - 优化部分代码结构;
+  - 修复:
+    - 修复节点剩余时间在小于1s时显示0的问题(这很影响判断);
+    - 在task_graph中使用"staged"模式时会报错的问题;
 
 ## Star 历史趋势（Star History）
 

{celestialflow-3.0.9 → celestialflow-3.1.1}/README.md

@@ -23,16 +23,16 @@
 - 相比 Airflow/Dagster 更轻、更快开始
 - 相比 multiprocessing/threading 更结构化，可直接表达 loop / complete graph 等复杂依赖模式
 
-框架的基本单元为 **TaskManager**，可独立运行，并支持四种执行模式：
+框架的基本单元为 **TaskExecutor**，可独立运行，并支持四种执行模式：
 
 * **线性（serial）**
 * **多线程（thread）**
 * **多进程（process）**
 * **协程（async）**
 
-TaskManager 实现了对任务的结果缓存，任务去重，进度条显示，多执行模式比较等功能，单独使用也很好用。
+TaskExecutor 实现了对任务的结果缓存，任务去重，进度条显示，多执行模式比较等功能，单独使用也很好用。
 
-但除去直接使用 TaskManager，更重要的是使用其子类**TaskStage**。TaskStage 可以互相连接，形成具有上游与下游依赖关系的任务图（**TaskGraph**）。下游 stage 会自动接收上游执行完成的结果作为输入，从而形成明确的数据流。
+但除去直接使用 TaskExecutor，更重要的是使用其子类**TaskStage**。TaskStage 可以互相连接，形成具有上游与下游依赖关系的任务图（**TaskGraph**）。下游 stage 会自动接收上游执行完成的结果作为输入，从而形成明确的数据流。
 
 TaskStage 的任务执行模式只有两种：
 
@@ -104,13 +104,17 @@ flowchart LR
 安装 CelestialFlow:
 
 ```bash
-pip install celestialflow
+# 推荐使用 `uv` 管理依赖与环境
+uv pip install celestialflow
+
+# 不过也可以直接使用 `pip`
+uv pip install celestialflow
 ```
 
 一个简单的可运行代码:
 
 ```python
-from celestialflow import TaskManager, TaskGraph
+from celestialflow import TaskStage, TaskGraph
 
 def add(x, y): 
     return x + y
@@ -120,8 +124,8 @@ def square(x):
 
 if __name__ == "__main__":
     # 定义两个任务节点
-    stage1 = TaskManager(add, execution_mode="thread", unpack_task_args=True)
-    stage2 = TaskManager(square, execution_mode="thread")
+    stage1 = TaskStage(add, execution_mode="thread", unpack_task_args=True)
+    stage2 = TaskStage(square, execution_mode="thread")
 
     # 构建任务图结构
     stage1.set_graph_context([stage2], stage_mode="process", stage_name="Adder")
@@ -146,8 +150,9 @@ if __name__ == "__main__":
 
 若你想了解框架的整体结构与核心组件，下面的参考文档会对你有帮助：
 
-- [🔧TaskManage/TaskStage概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_manage.md)
-- [🌐TaskGrapg概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_graph.md)
+- [🔧TaskExecutor概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_executor.md)
+- [🔧TaskStage概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_stage.md)
+- [🌐TaskGraph概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_graph.md)
 - [📚Go Worker概念](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/go_worker.md)
 
 推荐阅读顺序:
@@ -156,7 +161,7 @@ if __name__ == "__main__":
 flowchart TD
     classDef whiteNode fill:#ffffff,stroke:#000000,color:#000000;
 
-    TM[TaskManage.md] --> TS[TaskStage.md] --> TG[TaskGraph.md]
+    TM[TaskExecutor.md] --> TS[TaskStage.md] --> TG[TaskGraph.md]
     TM --> TP[TaskProgress.md]
 
     TG --> TQ[TaskQueue.md]
@@ -175,6 +180,7 @@ flowchart TD
 - [TaskTools](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_tools.md)
 - [TaskTypes](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_types.md)
 - [TaskLogging](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_logging.md)
+- [TaskErrors](https://github.com/Mr-xiaotian/CelestialFlow/blob/main/docs/reference/task_errors.md)
 
 如果你更喜欢通过完整案例理解框架的运行方式，可以参考这篇从零开始构建 TaskGraph 的教程：
 
@@ -204,100 +210,13 @@ flowchart TD
 
 ## 文件结构（File Structure）
 
-```
-📁 CelestialFlow	(224MB 407KB 500B)
-    📁 docs         	(34KB 944B)
-        📁 reference	(29KB 995B)
-            📝 ctree_client.md  	(6KB 997B)
-            📝 go_worker.md     	(6KB 378B)
-            📝 task_graph.md    	(4KB 989B)
-            📝 task_logging.md  	(0B)
-            📝 task_manage.md   	(7KB 499B)
-            📝 task_nodes.md    	(4KB 68B)
-            📝 task_progress.md 	(0B)
-            📝 task_queue.md    	(0B)
-            📝 task_report.md   	(0B)
-            📝 task_stage.md    	(0B)
-            📝 task_structure.md	(112B)
-            📝 task_tools.md    	(0B)
-            📝 task_types.md    	(0B)
-            📝 task_web.md      	(0B)
-        📝 quick_start.md	(4KB 973B)
-        📝 tutorial.md   	(0B)
-    📁 experiments  	(15KB 111B)
-        🐍 benchmark_datastructures.py	(6KB 52B)
-        🐍 benchmark_hash.py          	(1KB 284B)
-        🐍 benchmark_queue.py         	(5KB 504B)
-        🐍 benchmark_tqdm.py          	(1KB 160B)
-        🐍 experiment_tqdm.py         	(1KB 135B)
-    📁 go_worker    	(6MB 968KB 38B)
-        📁 worker	(5KB 746B)
-            🌀 parser.go   	(394B)
-            🌀 processor.go	(2KB 612B)
-            🌀 types.go    	(299B)
-            🌀 worker.go   	(2KB 465B)
-        ❓ go.mod       	(292B)
-        ❓ go.sum       	(1KB 68B)
-        ❓ go_worker.exe	(6MB 960KB)
-        🌀 main.go      	(980B)
-    📁 img          	(4MB 700KB 695B)
-        📷 logo(old).png  	(836KB 542B)
-        📷 logo.png       	(122KB 747B)
-        📷 web_display.png	(129KB 545B)
-        🎞️ web_ui.gif     	(3MB 635KB 909B)
-    📁 src          	(1MB 929KB 111B)
-        📁 celestialflow         	(1MB 911KB 486B)
-            📁 static     	(1MB 417KB 367B)
-                📁 css	(31KB 621B)
-                    🎨 base.css     	(6KB 181B)
-                    🎨 dashboard.css	(7KB 414B)
-                    🎨 errors.css   	(5KB 216B)
-                    🎨 inject.css   	(12KB 834B)
-                📁 js 	(33KB 672B)
-                    📜 main.js          	(5KB 65B)
-                    📜 task_errors.js   	(4KB 595B)
-                    📜 task_injection.js	(8KB 484B)
-                    📜 task_statuses.js 	(8KB 51B)
-                    📜 task_structure.js	(4KB 709B)
-                    📜 task_topology.js 	(1KB 375B)
-                    📜 utils.js         	(1KB 441B)
-                ❓ favicon.ico	(1MB 352KB 98B)
-            📁 templates  	(13KB 174B)
-                🌐 index.html	(13KB 174B)
-            📁 [1项排除的目录]	(339KB 553B)
-            🐍 task_graph.py    	(26KB 700B)
-            🐍 task_logging.py  	(10KB 282B)
-            🐍 task_manage.py   	(36KB 110B)
-            🐍 task_nodes.py    	(10KB 814B)
-            🐍 task_progress.py 	(1KB 477B)
-            🐍 task_queue.py    	(10KB 948B)
-            🐍 task_report.py   	(4KB 828B)
-            🐍 task_stage.py    	(6KB 577B)
-            🐍 task_structure.py	(7KB 255B)
-            🐍 task_tools.py    	(17KB 19B)
-            🐍 task_types.py    	(2KB 269B)
-            🐍 task_web.py      	(6KB 235B)
-            🐍 __init__.py      	(1KB 22B)
-        📁 [1项排除的目录]	(17KB 649B)
-    📁 tests        	(126KB 724B)
-        📁 [1项排除的目录]	(90KB 464B)
-        🐍 conftest.py      	(49B)
-        📝 README.md        	(6KB 324B)
-        🐍 test_graph.py    	(5KB 547B)
-        🐍 test_manage.py   	(3KB 90B)
-        🐍 test_nodes.py    	(11KB 218B)
-        🐍 test_structure.py	(10KB 56B)
-    📁 [6项排除的目录]	(210MB 685KB 450B)
-    ❓ .env          	(88B)
-    ❓ .gitignore    	(272B)
-    ❓ LICENSE       	(1KB 65B)
-    ❓ Makefile      	(501B)
-    ❓ pyproject.toml	(1KB 594B)
-    📝 README.md     	(16KB 3B)
-(celestial-flow 3.0.9)
-```
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Mr-xiaotian/CelestialFlow/main/img/file_structure.svg" alt="FileStructure" />
+  <br/>
+  <em>celestial-flow 3.1.1</em>
+</p>
 
-(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file.FileTree.print_tree()生成。)
+(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file.FileTree.print_tree()生成。转换为图片则借助[Carbon](https://carbon.now.sh)。)
 
 ## 更新日志（Change Log）
 
@@ -316,17 +235,35 @@ flowchart TD
 - 3.0.4: 新增一个抽象结构TaskQueue, 用于表示节点的所有"入边"与"出边"; 恢复未消费任务的保存功能
 - 3.0.5: 删除原有的TaskRedisTransfer节点, 并增添三种新的redis交互节点TaskRedisSink TaskRedisSource TaskRedisAck, 用于跨语言 跨进程 跨设备处理任务; 并在Web页面添加展示拓扑信息的卡片
 - 3.0.6: 添加对[CelestialTree](https://github.com/Mr-xiaotian/CelestialTree)系统的支持, 现在可以追踪单个任务的流向
-- 3.0.7: 将TaskStage从TaskManager中单独抽出来作为一个子类; 增加新节点TaskRouter, 可以将传入的任务选择的传给不同的下游节点, 而不是进行广播
+- 3.0.7: 将TaskStage从TaskExecutor中单独抽出来作为一个子类; 增加新节点TaskRouter, 可以将传入的任务选择的传给不同的下游节点, 而不是进行广播
 - 3.0.8: 在ctree逻辑上将"任务重试"事件后的"任务成功/失败/重试"事件视为因果关系, 而非之前的并行关系; 重构错误搜集部分逻辑; 修复大量3.0.6与3.07版本引入的bug; 优化部分log表现
-- 3.0.9: 1/23/2026
+- 3.0.9: 
   - 更新前端mermaid显示中部分节点图标; 
-  - 对ctree_client的大量修改; 
+  - 对ctree_client进行匹配CelestialTree的大量修改; 
   - 将ctree_client移出为单独的project; 
   - 在前端中添加error_id的显示, 为之后显示provenance_tree做准备; 
   - 增加大量warning与error, 用于提醒不规范设置; 
   - 优化前后端中错误数据的传输方式, 在大量错误数据时减少内存消耗; 
   - 优化TaskLogger中log队列的准入机制; 
-  - 修改部分Bug
+  - 修改部分Bug;
+- 3.1.0:
+  - 新增:
+    - 优化web端仪表盘页面的"总体状态摘要"卡片, 新增"总重复任务"与"总剩余市场", 后者由节点间拓扑关系计算而成, 后续还需要优化;
+  - 修复:
+    - 3.0.9版本下当web端与celestialflow运行端不同时, error数据无法传递的问题;
+    - 修复NullTaskReporter使用问题;
+- 3.1.1:
+  - 新增:
+    - [Important] CelestialTree中引入grpc, 这大大减少了emit操作的耗时;
+    - [Important] 为TerminationSignal添加id, 并可以像task一样通过CelestialTree进行跟踪;
+    - 优化task_graph与task_executor的log分级, 现在默认为"SUCCESS"级;
+    - 将go_worker部分分离为单独project: [celestialflow-goworker]https://github.com/Mr-xiaotian/celestialflow-goworker
+    - 在readme中使用svg图片来展示文件夹结构;
+    - 优化全局剩余时间的计算;
+    - 优化部分代码结构;
+  - 修复:
+    - 修复节点剩余时间在小于1s时显示0的问题(这很影响判断);
+    - 在task_graph中使用"staged"模式时会报错的问题;
 
 ## Star 历史趋势（Star History）
 

{celestialflow-3.0.9 → celestialflow-3.1.1}/pyproject.toml

@@ -1,60 +1,66 @@
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "celestialflow"                   
-version = "3.0.9"                         
-description = "A flexible GRAPH-based task orchestration framework."
-readme = "README.md"               
-license = { text = "MIT" }    
-authors = [{ name = "Mr-xiaotian", email = "mingxiaomingtian@gmail.com" }]
-keywords = ["workflow", "task", "graph", "async", "CelestialFlow"]
-requires-python = ">=3.8"
-
-dependencies = [
-    "tqdm",
-    "loguru",
-    "fastapi",
-    "uvicorn",
-    "requests",
-    "networkx",
-    "redis",
-    "jinja2",
-    "celestialtree",
-]
-
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Framework :: FastAPI",
-    "Topic :: Software Development :: Libraries",
-]
-
-[project.urls]
-"Homepage" = "https://github.com/Mr-xiaotian/CelestialFlow"
-"Bug Tracker" = "https://github.com/Mr-xiaotian/CelestialFlow/issues"
-
-[project.scripts]
-celestialflow-web = "celestialflow.task_web:main_entry"
-
-[tool.setuptools]
-license-files = []
-
-[tool.setuptools.package-data]
-"celestialflow" = ["templates/*.html", "static/**/*"]
-
-[tool.pytest.ini_options]
-addopts = "-s"
-log_cli = true
-log_cli_level = "INFO"
-log_cli_format = "%(asctime)s [%(levelname)s] %(message)s"
-log_cli_date_format = "%Y-%m-%d %H:%M:%S"
-
-filterwarnings = [
-    "ignore::DeprecationWarning",
-    "ignore::pytest.PytestDeprecationWarning",
-]
-
-asyncio_default_fixture_loop_scope = "function"
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "celestialflow"                   
+version = "3.1.1"                         
+description = "A flexible GRAPH-based task orchestration framework."
+readme = "README.md"               
+license = { text = "MIT" }    
+authors = [{ name = "Mr-xiaotian", email = "mingxiaomingtian@gmail.com" }]
+keywords = ["workflow", "task", "graph", "async", "CelestialFlow"]
+requires-python = ">=3.8"
+
+dependencies = [
+    "tqdm",
+    "loguru",
+    "fastapi",
+    "uvicorn",
+    "requests",
+    "networkx",
+    "redis",
+    "jinja2",
+    "celestialtree",
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Framework :: FastAPI",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/Mr-xiaotian/CelestialFlow"
+"Bug Tracker" = "https://github.com/Mr-xiaotian/CelestialFlow/issues"
+
+[project.scripts]
+celestialflow-web = "celestialflow.task_web:main_entry"
+
+[tool.setuptools]
+license-files = []
+
+[tool.setuptools.package-data]
+"celestialflow" = ["templates/*.html", "static/**/*"]
+
+[tool.pytest.ini_options]
+addopts = "-s"
+log_cli = true
+log_cli_level = "INFO"
+log_cli_format = "%(asctime)s [%(levelname)s] %(message)s"
+log_cli_date_format = "%Y-%m-%d %H:%M:%S"
+
+filterwarnings = [
+    "ignore::DeprecationWarning",
+    "ignore::pytest.PytestDeprecationWarning",
+]
+
+asyncio_default_fixture_loop_scope = "function"
+
+[dependency-groups]
+dev = [
+    "build>=1.2.2.post1",
+    "twine>=6.1.0",
+]

{celestialflow-3.0.9 → celestialflow-3.1.1}/src/celestialflow/__init__.py

@@ -1,5 +1,5 @@
 from .task_graph import TaskGraph
-from .task_manage import TaskManager
+from .task_executor import TaskExecutor
 from .task_stage import TaskStage
 from .task_nodes import (
     TaskSplitter,
@@ -34,7 +34,7 @@ __all__ = [
     "TaskComplete",
     "TaskWheel",
     "TaskGrid",
-    "TaskManager",
+    "TaskExecutor",
     "TaskStage",
     "TaskSplitter",
     "TaskRedisSink",

{celestialflow-3.0.9 → celestialflow-3.1.1}/src/celestialflow/static/css/base.css

@@ -10,6 +10,40 @@
   --gray-medium: #9ca3af;
   --gray-dark: #4b5563;
   --gray-slate: #6b7280;
+
+    /* ================================
+     Summary palette (light mode)
+  ================================ */
+  --summary-blue-bg: #dbeafe;
+  --summary-orange-bg: #fed7aa;
+  --summary-yellow-bg: #fef3c7;
+  --summary-red-bg: #fee2e2;
+  --summary-green-bg: #d1fae5;
+  --summary-purple-bg: #e9d5ff;
+
+  --summary-blue-value: #2563eb;
+  --summary-orange-value: #ea580c;
+  --summary-yellow-value: #d97706;
+  --summary-red-value: #dc2626;
+  --summary-green-value: #059669;
+  --summary-purple-value: #7c3aed;
+
+  /* ================================
+     Summary palette (dark mode)
+  ================================ */
+  --summary-blue-bg-dark: #1e3a8a;
+  --summary-orange-bg-dark: #7c2d12;
+  --summary-yellow-bg-dark: #78350f;
+  --summary-red-bg-dark: #7f1d1d;
+  --summary-green-bg-dark: #14532d;
+  --summary-purple-bg-dark: #4c1d95;
+
+  --summary-blue-value-dark: #60a5fa;
+  --summary-orange-value-dark: #fdba74;
+  --summary-yellow-value-dark: #facc15;
+  --summary-red-value-dark: #f87171;
+  --summary-green-value-dark: #34d399;
+  --summary-purple-value-dark: #c4b5fd;
 }
 
 /* ================================