143 lines
5.0 KiB
Markdown
143 lines
5.0 KiB
Markdown
# EXE-Engine · 自研执行引擎
|
||
|
||
> **项目编号**：PRJ-EXE-001
|
||
> **版权**：国作登字-2026-A-00037559
|
||
> **阶段**：Phase 0 · 基础建设
|
||
|
||
---
|
||
|
||
## 本体论锚定 [ONT-PATCH-005]
|
||
|
||
**AGE OS = 笔** · **算力 = 墨水** · **用户 = 写字的人**
|
||
|
||
AGE OS 是一支智能的、有生命的笔。它不制造墨水（不拥有算力），它使用墨水。
|
||
用户可以自带墨水（BYOK），也可以从 AGE OS 的墨水池里取用（资源池）。
|
||
|
||
---
|
||
|
||
## 系统架构
|
||
|
||
```
|
||
┌──────────────────────────────────────────────┐
|
||
│ 用户层 │
|
||
│ 用户 / 开发者 / Agent │
|
||
└───────────────────┬──────────────────────────┘
|
||
│
|
||
┌───────────────────▼──────────────────────────┐
|
||
│ AGE-Router 路由网关 │
|
||
│ 鉴权 → 分类 → 模型选择 → 限流降级 │
|
||
└───────────────────┬──────────────────────────┘
|
||
│
|
||
┌───────────────────▼──────────────────────────┐
|
||
│ LoadBalancer 负载均衡器 │
|
||
│ cost / balanced / quality 策略 │
|
||
│ 故障转移 · 并发控制 │
|
||
└──────┬────────────┬──────────────┬───────────┘
|
||
│ │ │
|
||
┌──────▼───┐ ┌─────▼────┐ ┌─────▼────┐
|
||
│DeepSeek │ │ Qwen │ │ Other │
|
||
│Adapter │ │ Adapter │ │ Adapter │
|
||
└──────┬───┘ └─────┬────┘ └─────┬────┘
|
||
│ │ │
|
||
┌──────▼────────────▼──────────────▼───────────┐
|
||
│ ResourceMeter 资源计量器 │
|
||
│ token 消耗 · 成本计算 · 数据回流 DC v1.0 │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
exe-engine/
|
||
├── package.json
|
||
├── README.md
|
||
├── config/
|
||
│ ├── models.json # 模型配置（端点、成本、能力）
|
||
│ └── resource-pools.json # 资源池配置
|
||
├── src/
|
||
│ ├── index.js # 主入口 + createEngine()
|
||
│ ├── router/
|
||
│ │ └── age-router.js # AGE-Router 路由网关
|
||
│ ├── adapters/
|
||
│ │ ├── base-adapter.js # EXEModelAdapter 基类
|
||
│ │ ├── deepseek-adapter.js # DeepSeek-V3/R1 适配器
|
||
│ │ └── qwen-adapter.js # Qwen-Max/Coder 适配器
|
||
│ ├── balancer/
|
||
│ │ └── load-balancer.js # 负载均衡器
|
||
│ ├── meter/
|
||
│ │ └── resource-meter.js # 资源计量器
|
||
│ ├── cache/
|
||
│ │ └── context-cache.js # 上下文缓存
|
||
│ └── controller/
|
||
│ └── agent-controller.js # Agent 调度器
|
||
├── docs/
|
||
│ └── architecture.md # 详细架构文档
|
||
└── tests/
|
||
└── smoke/
|
||
└── exe-engine.test.js # 冒烟测试
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 查看引擎状态
|
||
node exe-engine/src/index.js status
|
||
|
||
# 运行冒烟测试
|
||
node exe-engine/tests/smoke/exe-engine.test.js
|
||
```
|
||
|
||
## API 接口
|
||
|
||
### POST /api/exe/v1/execute
|
||
|
||
```json
|
||
{
|
||
"agentId": "AG-ZY-01",
|
||
"taskType": "code_generation",
|
||
"prompt": "...",
|
||
"context": { "repo": "...", "branch": "..." },
|
||
"preferences": {
|
||
"model": "auto",
|
||
"priority": "balanced",
|
||
"maxTokens": 4096
|
||
},
|
||
"resourcePool": "default"
|
||
}
|
||
```
|
||
|
||
### 响应
|
||
|
||
```json
|
||
{
|
||
"requestId": "exe-xxxxx",
|
||
"model": "deepseek-v3",
|
||
"output": "...",
|
||
"usage": {
|
||
"inputTokens": 1200,
|
||
"outputTokens": 800,
|
||
"cost": 0.0012,
|
||
"unit": "CNY"
|
||
},
|
||
"latency": 2340,
|
||
"status": "success"
|
||
}
|
||
```
|
||
|
||
## 接入模式
|
||
|
||
| 模式 | 说明 | 适用 |
|
||
|------|------|------|
|
||
| BYOK | 用户自带 API Key | 有自己 API 账户的开发者 |
|
||
| 资源池 | AGE OS 统一资源池 | 轻量用户 |
|
||
| 混合 | BYOK + 资源池 fallback | 企业用户 |
|
||
|
||
## Phase 路线
|
||
|
||
| Phase | 目标 | 状态 |
|
||
|-------|------|------|
|
||
| P0 基础建设 | Router + DeepSeek Adapter + Meter | 🟢 当前 |
|
||
| P1 影子模式 | Qwen Adapter + LoadBalancer + 并行验证 | ⚪ 待开始 |
|
||
| P2 灰度切换 | Agent Controller 双轨 + BYOK + 计费 | ⚪ 待开始 |
|
||
| P3 全面切换 | 完全替代 Copilot | ⚪ 待开始 |
|