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/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="文件上传失败")