61 lines
1.6 KiB
Markdown
61 lines
1.6 KiB
Markdown
|
# 架构总览（落地态）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. 仓库分层
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
apps/web/ 表现层 React：对话 / 视口 / 项目壳 / 治理台
|
|||
|
|
server/gateway/ HTTP + SSE 接入
|
|||
|
|
server/agent_core/ 意图、门禁、审计、Provider、模块扫描
|
|||
|
|
server/aps_domain/ 工作流编排、视图投影、沙盒、报告
|
|||
|
|
server/engines/ 排产引擎（当前 RULE 真实现）
|
|||
|
|
server/knowledge/ 资产 / 检索 / 偏好
|
|||
|
|
server/state/ 世界状态 + 检查点 + 种子
|
|||
|
|
shared/schemas/ 跨语言 JSON Schema 契约
|
|||
|
|
tests/golden/ 黄金回归
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. 请求主链路
|
|||
|
|
|
|||
|
|
```mermaid
|
|||
|
|
flowchart TB
|
|||
|
|
UI[Web Shell] --> GW[Gateway]
|
|||
|
|
GW --> INT[Intent 两级管线]
|
|||
|
|
INT --> WF[Workflow]
|
|||
|
|
WF --> H[Harness 权力判定]
|
|||
|
|
H -->|P0/P1| EXE[执行器]
|
|||
|
|
H -->|P2| CARD[确认卡暂存]
|
|||
|
|
CARD -->|用户批准| EXE
|
|||
|
|
EXE --> ENG[Engines / Knowledge / State]
|
|||
|
|
EXE --> AUD[Audit 哈希链]
|
|||
|
|
ENG --> VIEW[Views 投影]
|
|||
|
|
VIEW --> UI
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. 关键不变量
|
|||
|
|
|
|||
|
|
1. **写主干必过 Harness**；P2 唯一确认通道。
|
|||
|
|
2. **Explore 沙盒**不得写主干（`scenario.compare`）。
|
|||
|
|
3. **报告数字**只允许来自冻结快照字段。
|
|||
|
|
4. **可重生模块**带 `moduleId` 头声明，重生中心可扫描。
|
|||
|
|
5. **文档与代码同轮**：见 [../README.md](../README.md) 铁律。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. 技术选型（已锁定）
|
|||
|
|
|
|||
|
|
| 项 | 选择 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 后端 | Python FastAPI |
|
|||
|
|
| 前端 | React 18 + Vite + TS |
|
|||
|
|
| 求解 | 现阶段 RULE；OR-Tools 规划 M5 |
|
|||
|
|
| LLM | DeepSeek / KIMI（OpenAI 兼容），可降级 |
|
|||
|
|
| 桌面 | Tauri（后期） |
|
|||
|
|
|
|||
|
|
细节与里程碑叙事见 `plan.md`；接口清单见 [harness.md](./harness.md)。
|