# agent-os

**Repository Path**: 7474748g/agent-os

## Basic Information

- **Project Name**: agent-os
- **Description**: Agent OS — Enterprise Agent Operating System
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent OS — 企业级 Agent 操作系统

> **AI Agent 全生命周期管理平台**：构建 → 编排 → 运维，一站式闭环。

[![Gitee](https://img.shields.io/badge/Gitee-MAWEIYUN%2Fagent--os-blue?logo=gitee)](https://gitee.com/MAWEIYUN/agent-os)
[![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=next.js)](https://nextjs.org)
[![React](https://img.shields.io/badge/React-19-61dafb?logo=react)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6?logo=typescript)](https://www.typescriptlang.org)
[![Prisma](https://img.shields.io/badge/Prisma-6-2d3748?logo=prisma)](https://www.prisma.io)

## 四平台架构

```
┌──────────────┬──────────────┬──────────────┐
│  构建平台 L3   │  场景工厂 L4   │  运维平台 L5   │
│  Agent 设计    │  场景编排      │  监控治理      │
│  市场/能力体系  │  运行时/审批   │  血缘/成本     │
└──────────────┴──────────────┴──────────────┘
              ↕                ↕
        ┌──────────────────────────┐
        │      服务底座 L2           │
        │  执行引擎 · 模型路由 · 闸门  │
        │  上下文组装 · 知识 · 飞轮   │
        └──────────────────────────┘
```

| 平台 | 职责 | 页面数 | 核心能力 |
|------|------|:---:|---------|
| **Builder 构建** | Agent 设计、能力配置、市场管理 | 3 | Persona/Reasoning/Execution 三层分离、A2A Card 生成 |
| **Factory 工厂** | 场景拖拽编排、Agent 协作、审批交付 | 3 | ReactFlow DAG 编辑器、并行执行、HITL 人机协作 |
| **Ops 运维** | 仪表盘、花名册、决策血缘、成本追踪 | 4 | 实时监控、飞轮反哺、审计日志 |
| **Foundation 底座** | 引擎调度、路由、闸门、上下文组装 | — | ExecutionAdapter、HermesAdapter、EventBus |

## 技术栈

| 层 | 技术 | 版本 |
|----|------|:---:|
| 框架 | Next.js (App Router) | 16 |
| UI | React + Ant Design + Tailwind | 19 / 6 / 4 |
| 语言 | TypeScript | 5 |
| 数据库 | Prisma + SQLite (MVP) → PostgreSQL (生产) | 6 |
| 状态 | Zustand | 5 |
| 校验 | Zod | 4 |
| 流程编排 | @xyflow/react | 12 |
| 测试 | Vitest + Playwright | 4 / 1.61 |
| 动画 | Framer Motion | 12 |
| 消息 | Socket.IO + BullMQ + Redis | — |

## 快速开始

```bash
# 1. 克隆
git clone https://gitee.com/MAWEIYUN/agent-os.git
cd agent-os

# 2. 安装依赖
pnpm install

# 3. 初始化数据库
cp .env.example .env
npx prisma generate
npx prisma db push

# 4. 创建管理员
echo "admin@agentos.dev / agentos123"  # 默认登录凭证

# 5. 启动开发服务器
pnpm dev
# → http://localhost:3000
```

## MVP 当前状态

| 维度 | 指标 |
|------|------|
| **源码** | 88 文件 / ~4,300 行（8引擎 + 9API + 12页面 + 14组件） |
| **数据库** | 12 表 / 5 Agent / 12 Scene / 19 Execution |
| **需求实现** | 54/57 (94%)，P0 全部完成 |
| **TypeScript** | `tsc --noEmit` 零错误通过 |
| **CI/CD** | Gitee CI (tsc + eslint + build) |

## 项目结构

```
agent-os/
├── src/
│   ├── app/                    # Next.js App Router 页面
│   │   ├── builder/            # 构建平台 (设计/市场)
│   │   ├── factory/            # 场景工厂 (设计器/运行)
│   │   ├── ops/                # 运维平台 (仪表盘/花名册/血缘)
│   │   ├── login/              # 登录页
│   │   └── api/                # API 路由 (agents/scenes/auth/models/ops)
│   ├── lib/                    # 引擎层 (8个模块)
│   │   ├── execution-adapter.ts
│   │   ├── hermes-adapter.ts
│   │   ├── context-assembler.ts
│   │   ├── scene-engine.ts
│   │   ├── event-bus.ts
│   │   ├── model-router.ts
│   │   ├── auth.ts
│   │   └── prisma.ts
│   └── components/             # 布局组件
├── packages/ui-core/           # 14 组件设计系统
├── prisma/                     # 数据模型 (12 models)
├── docs/                       # 234 份设计文档 (L0蓝图 + L1架构 + 77 FD)
├── .design_library/agent-os/   # 设计库 (832行 CSS Token + 14组件契约)
└── scripts/                    # 工具脚本
```

## 设计文档

完整的设计文档体系（234份）在 `docs/` 下：

- **L0 蓝图** (8份): 总体蓝图 + 4平台蓝图 + 用户故事线 + 执行链路
- **L1 技术架构** (5份): 技术架构总览 + ADR + Prisma Schema + 部署 + UI 规范
- **design/** (200+份): 77 FD功能设计 + 13 SP专题方案 + 4 REQ需求清单 + 40 PT原型

## 设计系统

Agent OS 使用自研企业级设计系统（BSF DNA + TRAE 严谨性）：

- 品牌色 `#0065FD`，三体字体（Space Grotesk / Manrope / JetBrains Mono）
- 14 个核心组件（Button/Card/DataTable/AgentCard/A2ACard 等）
- 平台差异化：Builder 蓝 / Factory 青 / Ops 橙
- 所有页面通过 `globals.css` 导入设计库 CSS Token

## 开发

```bash
# 代码检查
npx tsc --noEmit
npx eslint src/ --max-warnings 0

# 测试
npx vitest run

# Prisma
npx prisma studio          # 数据库 GUI
npx prisma db push         # 同步 Schema
npx prisma generate        # 重新生成 Client

# 构建
pnpm build
```

## License

MIT