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