🎉 init: 小龙的工作空间
This commit is contained in:
大海
@@ -0,0 +1,212 @@
|
||||
# Software Generator
|
||||
|
||||
> 需求文本 → 可发布软件。一条命令，370ms。
|
||||
|
||||
7 个 Agent 组成的端到端软件生成管线，从自然语言需求到可发布的桌面应用。
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
# 生成完整项目（以 PetCare 为例）
|
||||
node scripts/project-intake-agent.mjs --input "做一个宠物护理管理平台" --output /tmp/petcare/prd.json
|
||||
node scripts/architecture-agent.mjs --input /tmp/petcare/prd.json --output /tmp/petcare/arch.json
|
||||
node scripts/frontend-builder-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/frontend
|
||||
node scripts/backend-builder-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/backend
|
||||
node scripts/fullstack-composer-agent.mjs --prd /tmp/petcare/prd.json --arch /tmp/petcare/arch.json --output /tmp/petcare/fullstack
|
||||
node scripts/electron-builder-agent.mjs --input /tmp/petcare/fullstack --output /tmp/petcare/electron --prd /tmp/petcare/prd.json
|
||||
node scripts/release-builder-agent.mjs --input /tmp/petcare/fullstack --output /tmp/petcare/release
|
||||
```
|
||||
|
||||
## 架构
|
||||
|
||||
```
|
||||
需求文本
|
||||
↓ SF-01 project-intake-agent
|
||||
PRD JSON
|
||||
↓ SF-02 architecture-agent
|
||||
Architecture JSON
|
||||
↓ SF-03 frontend-builder-agent
|
||||
Web Frontend (Next.js)
|
||||
↓ SF-04 backend-builder-agent
|
||||
API Backend (Express + SQLite)
|
||||
↓ SF-05 fullstack-composer-agent
|
||||
Fullstack Monorepo
|
||||
↓ SF-06 electron-builder-agent
|
||||
Desktop App (Electron)
|
||||
↓ SF-07 release-builder-agent
|
||||
Release Package
|
||||
```
|
||||
|
||||
## 7 个 Agent
|
||||
|
||||
| Agent | 文件 | 职责 |
|
||||
|-------|------|------|
|
||||
| SF-01 | `scripts/project-intake-agent.mjs` | 需求分析 → PRD JSON |
|
||||
| SF-02 | `scripts/architecture-agent.mjs` | PRD → 架构设计 |
|
||||
| SF-03 | `scripts/frontend-builder-agent.mjs` | PRD + 架构 → Next.js 前端 |
|
||||
| SF-04 | `scripts/backend-builder-agent.mjs` | PRD + 架构 → Express 后端 |
|
||||
| SF-05 | `scripts/fullstack-composer-agent.mjs` | 前端 + 后端 → Monorepo |
|
||||
| SF-06 | `scripts/electron-builder-agent.mjs` | 全栈项目 → Electron 桌面应用 |
|
||||
| SF-07 | `scripts/release-builder-agent.mjs` | 桌面应用 → Release 包 |
|
||||
|
||||
## 各 Agent 用法
|
||||
|
||||
### SF-01 — 需求分析
|
||||
|
||||
```bash
|
||||
node scripts/project-intake-agent.mjs --input "需求描述" --output prd.json
|
||||
node scripts/project-intake-agent.mjs --input prd.md --output prd.json # 从文件读取
|
||||
```
|
||||
|
||||
输出: `prd.json` — 包含 projectName, domain, features, pages, apiRequirements, personas, userStories
|
||||
|
||||
### SF-02 — 架构设计
|
||||
|
||||
```bash
|
||||
node scripts/architecture-agent.mjs --input prd.json --output arch.json
|
||||
```
|
||||
|
||||
输出: `arch.json` — 包含 modules, dataFlows, directoryStructure, databaseSchema, apiDesign
|
||||
|
||||
### SF-03 — 前端生成
|
||||
|
||||
```bash
|
||||
node scripts/frontend-builder-agent.mjs --prd prd.json --arch arch.json --output frontend/
|
||||
```
|
||||
|
||||
输出: Next.js 项目 — app/, components/, hooks/, services/, types/
|
||||
|
||||
### SF-04 — 后端生成
|
||||
|
||||
```bash
|
||||
node scripts/backend-builder-agent.mjs --prd prd.json --arch arch.json --output backend/
|
||||
```
|
||||
|
||||
输出: Express + SQLite 项目 — src/routes/, src/services/, src/db/, src/middleware/
|
||||
|
||||
### SF-05 — 全栈组装
|
||||
|
||||
```bash
|
||||
node scripts/fullstack-composer-agent.mjs --prd prd.json --arch arch.json --output fullstack/
|
||||
```
|
||||
|
||||
输出: Monorepo — apps/web/, apps/api/, packages/shared-types/, packages/shared-config/
|
||||
|
||||
### SF-06 — 桌面封装
|
||||
|
||||
```bash
|
||||
node scripts/electron-builder-agent.mjs --input fullstack/ --output electron/ --prd prd.json
|
||||
```
|
||||
|
||||
输出: Electron 项目 — electron/main.ts, preload.ts, ipc.ts, tray.ts, updater.ts
|
||||
|
||||
### SF-07 — 发布打包
|
||||
|
||||
```bash
|
||||
node scripts/release-builder-agent.mjs --input fullstack/ --output release/
|
||||
```
|
||||
|
||||
输出: Release 包 — version.json, manifest.json, checksums.txt, release-notes.md, build-info.json, windows/, macos/, linux/
|
||||
|
||||
## 输出结构
|
||||
|
||||
### Fullstack Monorepo
|
||||
|
||||
```
|
||||
fullstack/
|
||||
├── apps/
|
||||
│ ├── web/ # Next.js 前端
|
||||
│ │ ├── app/ # 页面路由
|
||||
│ │ ├── components/
|
||||
│ │ ├── hooks/
|
||||
│ │ ├── services/
|
||||
│ │ └── types/
|
||||
│ └── api/ # Express 后端
|
||||
│ └── src/
|
||||
│ ├── routes/
|
||||
│ ├── services/
|
||||
│ ├── db/
|
||||
│ └── middleware/
|
||||
├── packages/
|
||||
│ ├── shared-types/
|
||||
│ └── shared-config/
|
||||
└── package.json
|
||||
```
|
||||
|
||||
### Release Package
|
||||
|
||||
```
|
||||
release/
|
||||
├── version.json # 版本元数据
|
||||
├── build-info.json # 构建环境信息
|
||||
├── README.md
|
||||
├── manifests/
|
||||
│ └── manifest.json # 文件列表 + SHA256
|
||||
├── checksums/
|
||||
│ └── checksums.txt # SHA256 校验
|
||||
├── release-notes/
|
||||
│ └── release-notes.md # 发布说明
|
||||
├── windows/ # Windows 安装器占位
|
||||
├── macos/ # macOS DMG 占位
|
||||
└── linux/ # Linux AppImage 占位
|
||||
```
|
||||
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
# 单元测试（各 Agent）
|
||||
node --test test/project-intake-agent.test.mjs
|
||||
node --test test/architecture-agent.test.mjs
|
||||
node --test test/frontend-builder-agent.test.mjs
|
||||
node --test test/backend-builder-agent.test.mjs
|
||||
node --test test/fullstack-composer-agent.test.mjs
|
||||
node --test test/electron-builder-agent.test.mjs
|
||||
node --test test/release-builder-agent.test.mjs
|
||||
|
||||
# E2E 回归测试（10 领域 × 7 阶段 = 170 检查）
|
||||
node --test test/e2e-regression.test.mjs
|
||||
```
|
||||
|
||||
## Benchmark
|
||||
|
||||
```bash
|
||||
# E2E Benchmark（10 领域全量）
|
||||
node scripts/e2e-benchmark-v1.mjs
|
||||
|
||||
# 单领域 Benchmark
|
||||
node scripts/domain-benchmark.mjs --domain petcare
|
||||
|
||||
# Release Benchmark
|
||||
node scripts/release-benchmark.mjs
|
||||
```
|
||||
|
||||
## 技术栈
|
||||
|
||||
| 层 | 技术 |
|
||||
|---|------|
|
||||
| 前端 | Next.js 15 + React 19 + Tailwind CSS 4 |
|
||||
| 后端 | Express + better-sqlite3 + JWT |
|
||||
| 桌面 | Electron 35 + electron-builder |
|
||||
| 测试 | Node.js built-in test runner |
|
||||
|
||||
## 已验证领域
|
||||
|
||||
| 领域 | 特性 | 页面 | API | 文件 |
|
||||
|------|------|------|-----|------|
|
||||
| PetCare | 7 | 6 | 5 | 162 |
|
||||
| CRM | 5 | 4 | 5 | 144 |
|
||||
| Inventory | 6 | 5 | 6 | 164 |
|
||||
| Ticket | 7 | 5 | 6 | 162 |
|
||||
| Blog CMS | 5 | 3 | 3 | 136 |
|
||||
| Project Mgmt | 5 | 4 | 5 | 126 |
|
||||
| HR | 7 | 5 | 6 | 162 |
|
||||
| Asset | 5 | 4 | 5 | 126 |
|
||||
| Course | 6 | 5 | 6 | 158 |
|
||||
| Appointment | 5 | 4 | 5 | 126 |
|
||||
|
||||
## 里程碑
|
||||
|
||||
- **v1.0.0-mvp** — Software Generator MVP v1 (2026-06-05)
|
||||
- 7 Agents, 7,941 LoC
|
||||
- 10/10 领域 E2E PASS
|
||||
- 170/170 回归测试 PASS
|
||||
Reference in New Issue
Block a user