wip: 增加了一些文档

This commit is contained in:
朝夕 2026-04-19 20:07:39 +08:00
parent 7573ce4ea7
commit 43135e47c8
3 changed files with 42 additions and 42 deletions

View File

@ -12,6 +12,7 @@
---
**Pretor** 是一款基于 **Ray** 构建的下一代分布式多 Agent 协作系统。项目采用“中心监管 + 边缘执行”的异构集群模式,通过大参数 MoE 模型进行高层逻辑推理,并协同微调后的轻量化模型高效完成具体任务。借助 **Pydantic-AI** 提供的强类型约束与 FastAPI 异步网关Pretor 实现了任务从需求拆解、资源调度到自动化执行的全链路闭环,为个人提供可靠的人工智能助手服务。
---
## 特别之处?
@ -24,3 +25,33 @@
---
## 快速开始
本项目正在开发中...
---
## 项目子项目
#### pretor-viceroy:
**项目名称** : 总督
**github网址** :https://github.com/zhaoxi826/viceroy
**功能** :pretor的资源管理工具
**目前实现** :
- 对于skill的安装与解析
#### pretor-domain
**项目名称** : 域
**github网址** :(暂无)
**功能** : 轻量化沙箱
**目前实现** :
(规划中)
#### pretor-explorer
**项目名称** : 探索者
**github网址** :(暂无)
**功能** : 自动爬虫
**目前实现** :
(规划中)
#### pretor-pioneer
**项目名称** : 先驱者
**github网址** :(暂无)
**功能** : RAG检索增强生成
**目前实现** :
(规划中)

View File

@ -10,11 +10,15 @@
#### ⚡ 性能与资源优化 (Performance & Scalability)
- [ ] 增加对应全workflow的情况追踪使得在任务运行中人机交互更加自然方便
- [ ] 优化import
#### 🏗️ 架构演进 (Architecture & Refactoring)
- [ ] 使用fastapi-users完善用户系统
- [x] /pretor/api的接口函数进行重构
- [ ] /dockerfile待完善
- - [ ] 完善沙箱功能
- [ ] 完善爬虫功能
- [ ] 对接更多的provider
---
## 日志
@ -28,4 +32,10 @@
#### 2026/4/16
- [ ] 发布v0.1.0正式版
- [ ] 增加对应全workflow的情况追踪使得在任务运行中人机交互更加自然方便
- [ ] 使用fastapi-users完善用户系统
- [ ] 使用fastapi-users完善用户系统
#### 2026/4/19
- [ ] 完善沙箱功能
- [ ] 完善爬虫功能
- [ ] 对接更多的provider
- [ ] 优化import

View File

@ -1,41 +0,0 @@
██████╗ ██████╗ ███████╗████████╗ ██████╗ ██████╗
██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗
██████╔╝██████╔╝█████╗ ██║ ██║ ██║██████╔╝
██╔═══╝ ██╔══██╗██╔══╝ ██║ ██║ ██║██╔══██╗
██║ ██║ ██║███████╗ ██║ ╚██████╔╝██║ ██║
╚═╝ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
========================================
🚀 Multi-Agent Orchestration Platform
📦 Version: v0.1
👤 Author: zhaoxi826
📜 License: Apache 2.0
🐙 github: https://github.com/zhaoxi826/pretor
========================================
2026-04-19 09:55:24,439 INFO worker.py:2003 -- Started a local Ray instance. View the dashboard at http://127.0.0.1:8265 
2026-04-19 09:55:24,445 WARNING working_dir.py:86 -- Directory '.git' is now ignored by default when packaging the working directory. To disable this behavior, set the `RAY_OVERRIDE_RUNTIME_ENV_DEFAULT_EXCLUDES=''` environment variable.
2026-04-19 09:55:24,448 WARNING working_dir.py:86 -- Directory '.venv' is now ignored by default when packaging the working directory. To disable this behavior, set the `RAY_OVERRIDE_RUNTIME_ENV_DEFAULT_EXCLUDES=''` environment variable.
2026-04-19 09:55:24,450 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.gitignore')]
2026-04-19 09:55:24,483 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.venv/.gitignore')]
2026-04-19 09:55:24,488 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/frontend/.gitignore')]
2026-04-19 09:55:24,502 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.pytest_cache/.gitignore')]
2026-04-19 09:55:24,507 INFO packaging.py:691 -- Creating a file package for local module '/app'.
2026-04-19 09:55:24,508 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.gitignore')]
2026-04-19 09:55:24,539 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.venv/.gitignore')]
2026-04-19 09:55:24,542 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/frontend/.gitignore')]
2026-04-19 09:55:24,556 INFO packaging.py:392 -- Ignoring upload to cluster for these files: [PosixPath('/app/.pytest_cache/.gitignore')]
2026-04-19 09:55:24,561 INFO packaging.py:463 -- Pushing file package 'gcs://_ray_pkg_7bb333ffc9dc3153.zip' (1.19MiB) to Ray cluster...
2026-04-19 09:55:24,624 INFO packaging.py:476 -- Successfully pushed file package 'gcs://_ray_pkg_7bb333ffc9dc3153.zip'.
/app/.venv/lib/python3.13/site-packages/ray/_private/worker.py:2051: FutureWarning: Tip: In future versions of Ray, Ray will no longer override accelerator visible devices env var if num_gpus=0 or num_gpus=None (default). To enable this behavior and turn off this error message, set RAY_ACCEL_ENV_VAR_OVERRIDE_ON_ZERO=0
warnings.warn(
(raylet) warning: `VIRTUAL_ENV=/app/.venv` does not match the project environment path `.venv` and will be ignored; use `--active` to target the active environment instead
(raylet) Using CPython 3.13.12
(raylet) Creating virtual environment at: .venv
(raylet) Installed 184 packages in 5.67s
(raylet) warning: `VIRTUAL_ENV=/app/.venv` does not match the project environment path `.venv` and will be ignored; use `--active` to target the active environment instead
(PretorGateway pid=484332) INFO: Started server process [484332]
(PretorGateway pid=484332) INFO: Waiting for application startup.
(PretorGateway pid=484332) INFO: Application startup complete.
(PretorGateway pid=484332) INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
(raylet) warning: `VIRTUAL_ENV=/app/.venv` does not match the project environment path `.venv` and will be ignored; use `--active` to target the active environment instead [repeated 5x across cluster] (Ray deduplicates logs by default. Set RAY_DEDUP_LOGS=0 to disable log deduplication, or see https://docs.ray.io/en/master/ray-observability/user-guides/configure-logging.html#log-deduplication for more options.)