简介

Forgexa 是一个自主软件开发平台，通过编排 AI 编码 Agent 将需求转化为可工作、经过测试和评审的代码。

核心功能

1. 需求分析 — AI 分析自然语言需求，生成带验收标准的结构化规格说明
2. 方案生成 — AI 创建执行计划和工作项，将需求拆解为可执行的任务
3. 自动执行 — 13 个 Agent 集成根据 WORKFLOW.md 实现代码。Claude Code、Codex、GitHub Copilot、Gemini CLI、OpenCode 和 Kimi Code 为自动路由候选，其余 7 个需显式选择，包含仅用于 Desktop 与个人 Runtime 的 DeepSeek Harness 预览。CodeBuddy 与 Qoder 已 ready；TraeCode CLI 与 ZCode 保留 live gate，Harness 要求固定构件验收。
4. 质量保证 — 自动化测试-修复循环、Lint 检查和 7 维质量门禁评分
5. 人工评审 — 质量门禁在合并前要求人工审批，确保人在环路中

核心概念

组织（Organization）

组织是最顶层的多租户容器。管理成员、强制预算限制、定义共享配置（SMTP、集成、工作流模板、运行时），所有工作空间继承这些设置。每个组织有三种角色：Owner、Admin 和 Member。

工作空间（Workspace）

工作空间属于某个组织，是项目的运营容器。持有项目、管理独立预算、团队成员与 RBAC 角色（Owner、Admin、Developer、Viewer），可定义细粒度权限的自定义角色。

项目（Project）

每个项目有 Git 仓库、技术栈定义和 WORKFLOW.md 配置文件，用于规定 AI Agent 的工作方式。

需求（Requirement）

以自然语言提交需求，由 AI 分析后生成结构化规格说明。审批通过的需求会生成执行计划。

计划与执行（Plan & Execution）

计划由工作项组成，映射到执行节点（设计 → 编码 → 测试 → 评审）。编排器将节点分发到运行时守护进程。

运行时守护进程（Runtime Daemon）

运行在开发机器上的轻量级进程，发现已安装的 AI Agent CLI，注册到服务器，在隔离工作空间中执行任务。

质量门禁（Quality Gate）

执行完成后计算 7 维质量评分。根据可配置阈值，变更可以自动合并、要求人工评审或被阻断。

架构概览

┌─────────┐    ┌─────────────┐    ┌──────────────┐
│  Web UI │───▶│  API 服务器  │───▶│  PostgreSQL  │
│ (React) │    │  (FastAPI)  │    │  + pgvector  │
└─────────┘    └──────┬──────┘    └──────────────┘
                      │
┌─────────┐    ┌──────┴──────┐
│  桌面端  │───▶│    Redis    │
│ (Tauri) │    │  (事件总线)  │
└─────────┘    └──────┬──────┘
                      │
            ┌─────────┴─────────┐
            │   运行时守护进程    │
            │   (宿主机器)      │
            │  ┌─────────────┐  │
            │  │ 13 个 Agent 集成     │
            │  │ 6 个本机 Agent：显式选择 │
            │  └─────────────┘  │
            └───────────────────┘

数据层级

组织 → 工作空间 → 项目 → 需求 → 执行