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/provider.py

@@ -0,0 +1,54 @@
+#  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
+from pydantic import BaseModel
+from typing import Literal
+from pretor.utils.access import TokenData, Accessor
+from pretor.utils.check_user.role_check import RoleChecker
+from pretor.core.database.table.user import UserAuthority
+from typing import Dict
+from pretor.core.global_state_machine.model_provider.base_provider import Provider
+from pretor.utils.ray_hook import ray_actor_hook
+
+provider_router = APIRouter(prefix="/api/v1/provider", tags=["provider"])
+
+class ProviderRegister(BaseModel):
+    provider_type: Literal["openai", "claude", "deepseek"]
+    provider_title: str
+    provider_url: str
+    provider_apikey: str
+
+@provider_router.post("")
+async def create_provider(provider_register: ProviderRegister,
+                          token_data: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER))) -> None:
+    global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
+    await global_state_machine.add_provider_wrap.remote(provider_type=provider_register.provider_type,
+                                                        provider_title=provider_register.provider_title,
+                                                        provider_url=provider_register.provider_url,
+                                                        provider_apikey=provider_register.provider_apikey,
+                                                        provider_owner=token_data.user_id)
+
+
+@provider_router.get("/list")
+async def get_provider_list(_: TokenData = Depends(Accessor.get_current_user)) -> Dict[str, Dict[str, Provider]]:
+    global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
+    provider_list: Dict[str, Provider] = await global_state_machine.get_provider_list.remote()
+    return {"provider_list": provider_list}
+
+@provider_router.delete("/{provider_title}")
+async def delete_provider(provider_title: str, _: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.SUPER_ADMINISTRATOR))) -> dict:
+    global_state_machine = ray_actor_hook("global_state_machine").global_state_machine
+    await global_state_machine.delete_provider.remote(provider_title=provider_title)
+    return {"message": "success"}