wip: 增加了一些文档

README.md

@@ -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检索增强生成
+**目前实现** : 
+（规划中）

docs/problem.md

@@ -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

server.log

@@ -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.)