Fulling - 基于 AI 的全栈开发平台

[!CAUTION] v2 开发中

我们正在将 Fulling 重构为一个智能体应用。预计会有重大变更。

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

Fulling 是什么？

Fulling 让你专注于编码，其他一切由 AI 处理。

你可以从 GitHub 导入项目，也可以从头开始。Claude Code 就像你的 AI 配对程序员——它会编写代码、运行测试、管理数据库，并将应用部署到生产环境。所有这些都在基于浏览器的开发环境中完成。

配置驱动的开发。 需要集成 Stripe 或 OAuth 吗？只需在项目设置中输入 API 密钥即可。服务会立即可用——无需安装 SDK、配置环境变量或编写集成代码。Claude Code 会读取你的配置并为你实现所需功能。

概览

Fulling 提供了一个沙盒环境，内置 Claude Code 和 PostgreSQL —— 你开发全栈应用所需的一切都已就绪。

Fulling 会自动为你设置好所有内容，一分钟内即可准备就绪：

• AI 配对程序员（Claude Code）
• 全栈开发环境
• 专用数据库（PostgreSQL）
• Web 终端和文件管理器
• 实时 HTTPS 域名

功能

• AI 配对程序员：Claude Code 已预装并随时可用。只需描述你的需求，它就会帮你编写代码。
• 零配置：全栈环境包含数据库、终端和文件管理器。所有内容均已预先配置，几秒钟内即可使用。
• Web 终端：在浏览器中使用完整的 Linux 终端。运行命令、安装软件包、调试——你本地能做的都可以在这里完成。
• 文件管理器：支持拖放文件，在浏览器中编辑代码。内置大文件支持。
• 实时域名：你的应用会立即获得 HTTPS URL。无需端口转发，也不用 ngrok。直接运行并分享即可。
• 配置驱动：只需在设置中输入 API 密钥，即可添加 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 操作
• DatabaseManager（lib/k8s/database-manager.ts）：KubeBlocks 操作
• 认证（lib/auth.ts）：多提供商 OAuth
• 事件监听器（lib/events/）：生命周期处理器

文档

• 架构：协调模式、事件系统
• 开发指南：本地开发
• 运维手册：部署、监控
• 故障排除：常见问题

安全性

• 认证：多提供商 OAuth（GitHub、密码、Sealos）
• 隔离：每个沙盒运行在用户专属的 Kubernetes 命名空间中
• 终端认证：HTTP Basic 认证，配合 URL 令牌注入
• 密钥管理：敏感数据存储在 Kubernetes Secrets 中
• 资源限制：防止资源耗尽

贡献

详细信息请参阅 贡献指南。

开发设置

1. 分支仓库
2. 创建特性分支
3. 进行修改
4. 运行测试：pnpm test
5. 提交拉取请求

许可证

MIT 许可证——详情请参阅 LICENSE。

发布历史请查看 CHANGELOG.md。

致谢

• Anthropic 提供的 Claude Code
• Sealos 提供的 Kubernetes 平台
• ttyd 提供的 Web 终端
• FileBrowser 提供的文件管理功能

联系方式

• GitHub: @fanux
• 问题反馈: GitHub Issues

如果想获取最新动态，请给项目点个星吧！

Fulling 快速上手指南

⚠️ 重要提示 当前主分支正在开发 v2.0.0（重构为 Agentic 应用），可能存在破坏性变更。 如需使用稳定版本，请切换至 v1.0.0 分支。

1. 环境准备

在开始之前，请确保您的系统满足以下前置依赖要求：

• Node.js: 版本 22.12.0 或更高
• 数据库: PostgreSQL 实例
• 容器编排: Kubernetes 集群，且已安装 KubeBlocks
• 认证服务: GitHub OAuth 应用凭证（Client ID 和 Secret）

2. 安装步骤

按照以下步骤在本地部署 Fulling 开发环境：

1. 克隆仓库

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

2. 安装依赖 本项目使用 pnpm 作为包管理器：

   pnpm install
   

3. 配置环境变量 复制模板文件并填入您的具体配置（包括数据库连接、GitHub OAuth 信息等）：

   cp .env.template .env.local
   

   请编辑 .env.local 文件，确保所有必要字段已正确填写。

4. 初始化数据库 生成 Prisma 客户端并推送数据库架构：

   npx prisma generate
   npx prisma db push
   

5. 启动开发服务器

   pnpm run dev
   

启动成功后，访问 http://localhost:3000 即可进入平台。

3. 基本使用

Fulling 旨在通过 AI 简化全栈开发流程。以下是核心工作流：

创建项目

• 从零开始：在平台中新建项目，系统将自动为您分配一个包含 PostgreSQL 数据库、Web 终端和文件管理器的沙箱环境。
• 导入 GitHub：直接关联您的 GitHub 仓库，Fulling 会自动拉取代码并配置环境。

AI 辅助开发 (Claude Code)

平台内置了 Claude Code 作为您的 AI 结对程序员：

1. 打开浏览器内的 Web Terminal。
2. 直接使用自然语言描述需求（例如：“创建一个带有 Stripe 支付的登录页面”）。
3. Claude Code 将自动编写代码、运行测试并管理数据库迁移。

配置驱动集成

无需手动编写 SDK 初始化代码或配置复杂的环境变量：

1. 进入项目设置 (Project Settings)。
2. 填入第三方服务（如 Stripe, OAuth 提供商）的 API Key。
3. Claude Code 会自动读取配置并实现相应的集成逻辑。

实时预览与部署

• 实时域名：应用运行后，系统会立即生成 HTTPS 链接，无需配置 ngrok 或端口转发，可直接分享预览。
• 一键部署：开发完成后，点击部署按钮即可将应用从沙箱发布到生产环境，无需编写 YAML 或配置 CI/CD 流水线。