chore: 项目更名 - PIT Router → 智队中枢

This commit is contained in:
2026-03-14 21:29:56 +08:00

View File

@@ -1,10 +1,13 @@
# 智队中枢 # 智队中枢
> Personal Intelligent Team Router Service > PIT 网关路由应用 - Personal Intelligent Team Gateway Router Service
**中文名**:智队中枢
**英文名**PIT Router
## 项目概述 ## 项目概述
**智队中枢**(原 PIT Router是 PIT 系统的核心组件,负责连接用户交互层和 Agent 层实现消息路由、会话管理、Agent 调度等功能。 **智队中枢**(原 PIT Router是 PITPersonal Intelligent Team系统的核心组件,负责连接用户交互层和 Agent 层实现消息路由、会话管理、Agent 调度等功能。
### 核心目标 ### 核心目标
@@ -36,7 +39,7 @@
``` ```
用户交互层 (Clients) 用户交互层 (Clients)
↓ WebSocket / HTTP ↓ WebSocket / HTTP
PIT 网关路由应用 (Gateway Router) 智队中枢 (PIT Router)
├── 接入层 (Access Layer) ├── 接入层 (Access Layer)
│ ├── HTTP Server (Flask) │ ├── HTTP Server (Flask)
│ ├── WebSocket (SocketIO) │ ├── WebSocket (SocketIO)
@@ -64,6 +67,7 @@ pit-router/
├── app/ ├── app/
│ ├── __init__.py # Flask 应用工厂 │ ├── __init__.py # Flask 应用工厂
│ ├── config.py # 配置管理 │ ├── config.py # 配置管理
│ ├── extensions.py # Flask 扩展初始化
│ ├── models/ # 数据模型层 │ ├── models/ # 数据模型层
│ │ ├── __init__.py │ │ ├── __init__.py
│ │ ├── user.py # 用户模型 │ │ ├── user.py # 用户模型
@@ -489,9 +493,9 @@ services:
environment: environment:
- FLASK_ENV=production - FLASK_ENV=production
- SECRET_KEY=${SECRET_KEY} - SECRET_KEY=${SECRET_KEY}
- JWT_SECRET=${JWT_SECRET} - JWT_SECRET_KEY=${JWT_SECRET_KEY}
- DATABASE_URL=postgresql://user:pass@postgres:5432/pit - DATABASE_URL=postgresql://user:pass@postgres:5432/pit
- REDIS_URL=redis://redis:6379 - REDIS_URL=redis://redis:6379/0
volumes: volumes:
- pit-data:/app/data - pit-data:/app/data
- pit-logs:/app/logs - pit-logs:/app/logs
@@ -517,14 +521,14 @@ services:
postgres: postgres:
image: postgres:15-alpine image: postgres:15-alpine
environment: environment:
- POSTGRES_USER=user - POSTGRES_USER=postgres
- POSTGRES_PASSWORD=${DB_PASSWORD} - POSTGRES_PASSWORD=${DB_PASSWORD}
- POSTGRES_DB=pit - POSTGRES_DB=pit_router
volumes: volumes:
- postgres-data:/var/lib/postgresql/data - postgres-data:/var/lib/postgresql/data
restart: unless-stopped restart: unless-stopped
healthcheck: healthcheck:
test: ["CMD-SHELL", "pg_isready -U user -d pit"] test: ["CMD-SHELL", "pg_isready -U postgres -d pit_router"]
interval: 10s interval: 10s
timeout: 5s timeout: 5s
retries: 5 retries: 5
@@ -566,31 +570,31 @@ volumes:
### Phase 1: 核心功能 (3-4 天) ⭐ 调整 ### Phase 1: 核心功能 (3-4 天) ⭐ 调整
- [x] 项目结构和配置文件 - [x] 项目结构和配置文件
- [ ] 数据模型实现 (User/Session/Agent/Gateway/Message/Connection) - [x] 数据模型实现 (User/Session/Agent/Gateway/Message/Connection)
- [ ] 数据库迁移 - [x] 数据库迁移
- [ ] 认证 API (注册/登录/JWT) - [x] 认证 API (注册/登录/JWT)
- [ ] WebSocket 认证中间件 - [x] WebSocket 认证中间件
- [ ] 基础会话管理 - [x] 基础会话管理
- [ ] 消息路由基础功能 - [x] 消息路由基础功能
### Phase 2: 核心功能完善 (2-3 天) ⭐ 新增阶段 ### Phase 2: 核心功能完善 (2-3 天) ⭐ 新增阶段
- [ ] Agent 调度器实现 - [x] Agent 调度器实现
- [ ] 消息 ACK 机制 - [x] 消息 ACK 机制
- [ ] 消息持久化 - [x] 消息持久化
- [ ] Gateway 心跳管理 - [x] Gateway 心跳管理
- [ ] 错误处理和重试机制 - [x] 错误处理和重试机制
### Phase 3: 扩展功能 (2 天) ### Phase 3: 扩展功能 (2 天)
- [ ] 统计和监控接口 - [x] 统计和监控接口
- [ ] 日志系统 - [x] 日志系统
- [ ] 配置热更新 - [x] 配置热更新
- [ ] 消息历史查询 - [x] 消息历史查询
### Phase 4: 测试部署 (2-3 天) ⭐ 调整 ### Phase 4: 测试部署 (2-3 天) ⭐ 调整
- [ ] 单元测试 (pytest) - [x] 单元测试 (pytest)
- [ ] 集成测试 (WebSocket) - [ ] 集成测试 (WebSocket)
- [ ] 性能测试 - [ ] 性能测试
- [ ] Docker 部署 - [ ] Docker 部署
@@ -604,7 +608,7 @@ volumes:
### 协议兼容性 ### 协议兼容性
| PIT Channel 发送 | PIT Router 处理 | | PIT Channel 发送 | 智队中枢处理 |
|------------------|----------------| |------------------|----------------|
| `type: "request"` | 路由到对应处理器 | | `type: "request"` | 路由到对应处理器 |
| `method: "send.message"` | 转发给目标 Agent | | `method: "send.message"` | 转发给目标 Agent |
@@ -621,7 +625,7 @@ volumes:
"pit-bot": { "pit-bot": {
"enabled": true, "enabled": true,
"config": { "config": {
"routerUrl": "wss://pit-router.example.com/ws", "routerUrl": "wss://智队中枢.example.com/ws",
"authToken": "${PIT_ROUTER_TOKEN}", "authToken": "${PIT_ROUTER_TOKEN}",
"heartbeatInterval": 30000, "heartbeatInterval": 30000,
"heartbeatTimeout": 10000, "heartbeatTimeout": 10000,