chore: initial commit for Pretor v0.1.0-alpha

正式发布 Pretor 平台的首个 alpha 版本。本项目旨在构建一个基于分布式架构的多智能体协同工作流水线。

核心功能实现：
1. 建立基于 BaseIndividual 的动态插件加载机制。
2. 实现三类核心 worker_individual 子个体。
3. 集成 Ray 框架支持分布式集群调度。
4. 基于 PostgreSQL 的全量持久化存储方案。
5. 提供完整的 FastAPI 后端与 React 前端交互界面。

pretor/api/platform/__init__.py

@@ -0,0 +1,16 @@
+#  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 .frontend import client_router
+__all__ = ["client_router"]

pretor/api/platform/event.py

@@ -0,0 +1,36 @@
+#  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.
+
+import datetime
+from pydantic import BaseModel, Field, ConfigDict
+from ulid import ULID
+from typing import Any, Dict
+from pretor.core.workflow.workflow import PretorWorkflow
+import asyncio
+
+class PretorEvent(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+    trace_id: str = Field(default_factory=lambda: str(ULID()), description="事件的唯一标识符")
+    platform: str = Field(description="消息来源的平台")
+    user_id: str = Field(description="用户id")
+    user_name: str = Field(description="用户名")
+    create_time: str = Field(default_factory=lambda: str(datetime.datetime.now(datetime.timezone.utc).isoformat()),
+                             description="事件创建时间")
+    message: str = Field(description="用户发来的消息")
+    attachment: Dict[str, str] | None = Field(default=None,description="附件")
+    #--------------------------------------------------------------------------------------------------------------
+    context: Dict[str, Any] = Field(default_factory=dict, description="事件上下文内容，可包含工作流模板等信息")
+    workflow: PretorWorkflow | None = Field(default=None,description="工作流")
+    pending_queue: asyncio.Queue[str] | None= Field(default=None,description="待处理队列")
+    receive_queue: asyncio.Queue[str] | None = Field(default=None,description="待接收队列")

pretor/api/platform/frontend.py

@@ -0,0 +1,63 @@
+#  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 fastapi import APIRouter, Depends, HTTPException, status, UploadFile, File
+from pydantic import BaseModel
+from pretor.utils.access import Accessor, TokenData
+from pretor.api.platform.event import PretorEvent
+from pretor.utils.ray_hook import ray_actor_hook
+import os
+import shutil
+
+from pretor.utils.logger import get_logger
+logger = get_logger('frontend')
+client_router = APIRouter(prefix="/api/v1/adapter/client", tags=["client"])
+
+class Message(BaseModel):
+    message: str
+
+@client_router.post("")
+async def create_message(message: Message,
+                         token_data: TokenData = Depends(Accessor.get_current_user)):
+    logger.info("收到消息，来源：客户端")
+    logger.debug(f"消息内容：{message.message}")
+    event = PretorEvent(platform="client",
+                        user_id=str(token_data.user_id),
+                        user_name=token_data.username,
+                        message=message.message)
+    supervisory_node = ray_actor_hook("supervisory_node").supervisory_node
+    message = await supervisory_node.working.remote(event)
+    if message == "任务已创建":
+        return {"message": event.trace_id}
+    elif message == "未知相应类型":
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail="模型回复错误")
+    else:
+        return {"message": message}
+
+@client_router.post("/upload")
+async def upload_file(file: UploadFile = File(...),
+                      token_data: TokenData = Depends(Accessor.get_current_user)):
+    try:
+        upload_dir = "uploads"
+        os.makedirs(upload_dir, exist_ok=True)
+        file_path = os.path.join(upload_dir, file.filename)
+        with open(file_path, "wb") as buffer:
+            shutil.copyfileobj(file.file, buffer)
+        logger.info(f"用户 {token_data.username} 上传了文件: {file.filename}")
+        return {"filename": file.filename, "message": f"File {file.filename} uploaded successfully"}
+    except Exception as e:
+        logger.error(f"文件上传失败: {e}")
+        raise HTTPException(status_code=500, detail="文件上传失败")