# ai-builder-studio

**Repository Path**: zhao_pengfei_code/ai-builder-studio

## Basic Information

- **Project Name**: ai-builder-studio
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-05
- **Last Updated**: 2026-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Builder Studio

对话式 AI 全栈应用交付平台。输入需求后，平台可生成、运行、迭代并部署本地 Web 应用。

## 能做什么

- 四阶段流程：需求设计、概要设计、编码测试、部署
- OpenAI 兼容模型流式生成，支持图片附件
- 文件协议增量生成、版本快照、回退和自动修复
- 本地真实运行：安装依赖、构建、启动和预览生成物
- 独立生产发布、蓝绿切换、崩溃重启和虚拟域名访问
- 可选需求/概要设计文档，支持 Markdown、Word、PDF 导出
- 生成应用可按需使用 `node:sqlite`；平台数据库管理面只读

## 快速开始

需要 Node.js 22.13 或更高版本，推荐 Node.js 24 LTS。

```bash
npm ci
npm run dev
```

打开 <http://127.0.0.1:3001>，在设置中填写 OpenAI 兼容接口的 Base URL、API Key 和模型名，然后创建项目。

也可以使用环境变量：

```powershell
$env:OPENAI_BASE_URL = 'https://api.openai.com/v1'
$env:OPENAI_API_KEY = '替换为密钥'
$env:AI_MODEL = 'gpt-4o-mini'
npm run dev -- --port 3001
```

## 使用流程

1. 首页填写项目名称和首条需求。
2. 按需勾选需求文档、概要设计文档；都不选时直接进入编码。
3. 在文档面板编辑并确认文档，推进到下一阶段。
4. 在工作台对话生成或修改代码，查看预览、日志和版本。
5. 在部署面板绑定子域名前缀并发布版本。

刷新或断开页面不会取消后台生成任务；重新进入项目可以接回任务。主动停止才会取消模型请求。平台服务重启后，内存中的任务不会续跑，已保存的文档和版本仍保留。

## 界面预览

| 首页 | 工作台 |
| --- | --- |
| ![首页](docs/screenshots/home.png) | ![工作台](docs/screenshots/workbench.png) |

| 文档面板 | 数据库面板 |
| --- | --- |
| ![文档面板](docs/screenshots/docs-panel.png) | ![数据库面板](docs/screenshots/db-panel.png) |

## 常用命令

```bash
npm run typecheck   # TypeScript 检查
npm test            # 回归测试
npm run build       # 生产构建
npm start           # 启动生产服务
```

## 文档

详细说明见 [docs/ 文档中心](docs/README.md)：

- [快速开始与使用流程](docs/getting-started.md)
- [系统架构](docs/architecture.md)
- [HTTP API](docs/api.md)
- [运行与部署](docs/operations.md)
- [开发指南](docs/contributing.md)
- [故障排查](docs/troubleshooting.md)

## 技术栈

Next.js 15、React 19、TypeScript、Tailwind CSS、OpenAI 兼容 Chat Completions、marked、highlight.js、Node 内置 `node:sqlite`。

## 目录

```text
app/             Next.js 页面和 API 路由
components/      首页、工作台及各功能面板
lib/              存储、运行器、部署、代理和 AI 生成链路
data/             运行时数据（已被 Git 忽略）
docs/             使用、架构、API、运维和开发文档
tests/            回归测试
```

## 当前边界

平台面向可信用户的本地开发环境。生成代码以平台进程用户权限运行，当前没有账户权限体系、容器隔离或计费系统。平台数据保存在 `data/`，其中 `settings.json` 可能包含 API Key，请勿提交或公开。