style: 项目重构

1.项目改名为kilostar（千星） 2.后端部分进行大规模重构 3.node功能进行大规模重新设计
2026-05-11 15:29:16 +00:00
parent 2d8571dee3
commit ee9bbbf676
134 changed files with 2190 additions and 2503 deletions
@@ -0,0 +1,128 @@
+#  Copyright 2026 zhaoxi826
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+
+from kilostar.utils.ray_hook import ray_actor_hook
+from fastapi import APIRouter, Request, HTTPException
+from fastapi.responses import StreamingResponse
+import asyncio
+
+workflow_router = APIRouter(prefix="/api/v1/workflow", tags=["workflow"])
+
+
+@workflow_router.get("/list")
+async def get_workflow_list():
+    """处理针对 get workflow list 相关的 HTTP API 请求。
+    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
+    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    global_workflow_manager = ray_actor_hook(
+        "global_workflow_manager"
+    ).global_workflow_manager
+    events = await global_workflow_manager.list_events.remote()
+    return events
+
+
+@workflow_router.get("/{trace_id}")
+async def get_workflow_detail(trace_id: str):
+    """处理针对 get workflow detail 相关的 HTTP API 请求。
+    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
+    Args:        trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 trace 实例。
+    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    global_workflow_manager = ray_actor_hook(
+        "global_workflow_manager"
+    ).global_workflow_manager
+    event = await global_workflow_manager.get_event.remote(trace_id)
+    if not event:
+        raise HTTPException(status_code=404, detail="Workflow not found")
+
+    workflow = event.workflow
+    if not workflow:
+        return {
+            "event_id": trace_id,
+            "workflow_title": None,
+            "status": "waiting",
+            "user_name": event.user_name,
+            "message": event.message,
+            "create_time": event.create_time,
+            "steps": [],
+        }
+
+    steps = []
+    for step in workflow.work_link:
+        steps.append(
+            {
+                "step": step.step,
+                "name": step.name,
+                "node": step.node,
+                "action": step.action,
+                "desc": step.desc,
+                "status": step.status,
+                "agent_id": step.agent_id,
+            }
+        )
+    return {
+        "event_id": trace_id,
+        "workflow_title": workflow.title,
+        "status": workflow.status.status,
+        "command": workflow.command,
+        "current_step": workflow.status.step,
+        "user_name": event.user_name,
+        "message": event.message,
+        "create_time": event.create_time,
+        "steps": steps,
+    }
+
+
+@workflow_router.get("/sse/{trace_id}")
+async def get_workflow_sse(trace_id: str, request: Request):
+    """处理针对 get workflow sse 相关的 HTTP API 请求。
+    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
+    Args:        trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 trace 实例。        request (Request): FastAPI 框架注入的原生 HTTP 请求对象，包含了完整的 Header 标头、查询参数和正文流。
+    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    global_workflow_manager = ray_actor_hook(
+        "global_workflow_manager"
+    ).global_workflow_manager
+
+    async def event_generator():
+        """执行与 event generator 相关的核心业务流转操作。
+        该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。"""
+        try:
+            while True:
+                if await request.is_disconnected():
+                    break
+
+                # You might also want to send the workflow state periodically or when updated
+                # Here we just wait for pending messages and send them
+                message = await global_workflow_manager.get_pending.remote(trace_id)
+                # Ensure the message is formatted as SSE
+                yield f"data: {message}\n\n"
+        except asyncio.CancelledError:
+            pass
+
+    return StreamingResponse(event_generator(), media_type="text/event-stream")
+
+
+@workflow_router.post("/reply/{trace_id}")
+async def post_workflow_reply(trace_id: str, request: Request):
+    """处理针对 post workflow reply 相关的 HTTP API 请求。
+    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
+    Args:        trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 trace 实例。        request (Request): FastAPI 框架注入的原生 HTTP 请求对象，包含了完整的 Header 标头、查询参数和正文流。
+    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    data = await request.json()
+    reply_msg = data.get("message", "")
+    global_workflow_manager = ray_actor_hook(
+        "global_workflow_manager"
+    ).global_workflow_manager
+    await global_workflow_manager.put_received.remote(trace_id, reply_msg)
+    return {"status": "ok"}