Fulling - AI 驱动的全栈开发平台

[!CAUTION] v2 版本正在开发中

我们正在将 Fulling 重构为 Agentic（智能体）应用，预计会有重大变更。

如需稳定版本，请使用 v1.0.0。

什么是 Fulling？

Fulling 让您可以专注于编码，其余一切由 AI 处理。

您可以从 GitHub 导入项目或直接开始构建。Claude Code 是您的 AI 结对编程助手——它负责编写代码、运行测试、管理数据库并部署到生产环境。一切操作都在基于浏览器的开发环境中完成。

配置驱动开发。 需要 Stripe？需要 OAuth？只需在项目设置中输入您的 API Key。服务将立即变得可用，无需配置 SDK、无需设置环境变量、无需编写集成代码。Claude Code 会读取您的配置并为您实现功能。

概览

Fulling 提供了一个集成了 Claude Code 和 PostgreSQL 的沙盒环境——为您全栈式开发应用提供所需的一切。

Fulling 会自动设置您所需的一切，一分钟内即可就绪：

• AI 结对编程助手 (Claude Code)
• 全栈开发环境
• 专属数据库 (PostgreSQL)
• Web 终端和文件管理器
• 实时 HTTPS 域名

功能特性

• AI 结对编程助手 - 预装并配置好 Claude Code。描述您的需求，它就能编写相应的代码。

• 零配置启动 - 全栈环境配备数据库、终端和文件管理器。所有组件均已预配置，数秒内即可使用。

• Web 终端 - 在浏览器中运行完整的 Linux 终端。您可以运行命令、安装软件包、进行调试，如同在本地操作一样。

• 文件管理器 - 支持拖拽上传，在浏览器中即可编辑代码，并内置大文件支持。

• 实时域名 - 您的应用会立即获得 HTTPS URL。无需端口转发，无需 ngrok。只需运行并分享即可。

• 配置驱动 - 在设置中输入 API Key 即可添加 Stripe、OAuth 或任何其他服务。Claude Code 会读取您的配置并为您实现集成。

• GitHub 集成 - 导入仓库、推送更改、进行版本控制，体验符合预期。

• 一键部署 - 从沙盒到生产环境仅需一键。无需编写 YAML，无需配置 CI/CD 流水线。

技术栈

• 前端: Next.js, React, TypeScript
• 后端: Node.js, PostgreSQL
• 基础设施: Kubernetes

技术细节请参阅 架构文档。

安装

先决条件

• Node.js 22.12.0 或更高版本
• PostgreSQL 数据库
• 已安装 KubeBlocks 的 Kubernetes 集群
• GitHub OAuth 应用凭据

环境设置

1. 克隆仓库：

git clone https://github.com/FullAgent/fulling.git
cd fulling

2. 安装依赖：

pnpm install

3. 设置环境变量：

将 .env.template 复制为 .env.local 并填入您的值：

cp .env.template .env.local

4. 初始化数据库：

npx prisma generate
npx prisma db push

5. 运行开发服务器：

pnpm run dev

访问 http://localhost:3000 即可进入应用程序。

数据库模式

详细模式请参阅 数据库文档。

部署

Kubernetes 资源

平台为每个项目创建以下 Kubernetes 资源：

1. 数据库集群 (KubeBlocks):

   • PostgreSQL 14.8.0
   • 3Gi 存储空间
   • 自动生成凭据

2. 沙盒 StatefulSet:

   • 自定义 fullstack-web-runtime 镜像
   • 预装 Claude Code CLI
   • ttyd web 终端 (端口 7681)
   • FileBrowser (端口 8080)
   • 应用端口 (3000)

3. 服务与 Ingress:

   • 用于 Pod 联网的内部服务
   • 带 SSL 终止的 HTTPS Ingress
   • 支持终端的 WebSocket

资源限制

每个沙盒的默认资源分配：

• CPU: 20m (请求), 2000m (限制)
• 内存: 25Mi (请求), 4096Mi (限制)
• 存储: 10Gi (沙盒), 3Gi (数据库)

开发

项目结构

fulling/
├── app/                    # Next.js App Router 页面
│   ├── api/               # API 路由
│   ├── projects/          # 项目管理页面
│   └── layout.tsx         # 根布局
├── components/            # React 组件
│   ├── ui/               # Shadcn/UI 组件
│   └── terminal/         # 终端组件
├── lib/                   # 核心库
│   ├── k8s/              # Kubernetes 管理器
│   ├── events/           # 事件系统
│   ├── jobs/             # 后台任务
│   ├── repo/             # 仓库层
│   └── services/         # 业务服务
├── prisma/               # 数据库模式
├── runtime/              # 沙盒 Docker 镜像
└── docs/                 # 文档

核心服务

• SandboxManager (lib/k8s/sandbox-manager.ts) - 处理 StatefulSet 操作