# codex-design

**Repository Path**: sevenclear/codex-design

## Basic Information

- **Project Name**: codex-design
- **Description**: open-design改造了一下，简化了项目保留基本原型生成工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-12
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mundo Design

基于 Electron 的 AI 原型设计工具，使用 Codex CLI 的 `codex app-server` 协议对接模型能力，通过自然语言描述生成完整的交互式 HTML 原型。

## 架构

```
Electron 主进程
  ├── Express 服务 (localhost:7456)
  │   ├── /api/health, /api/agents, /api/skills
  │   ├── /api/projects (CRUD)
  │   └── /api/chat (SSE) → CodexAppServer
  └── BrowserWindow → 加载 React 前端

Codex App Server (子进程)
  └── codex app-server (JSON-RPC 2.0 over stdio)
```

## 核心功能

- **自然语言生成原型** — 描述需求，自动生成多页面完整 HTML 原型
- **项目持久化** — 项目数据存储在 `.od/projects/` 目录，重启不丢失
- **对话上下文** — 后续对话自动携带历史消息和已有文件信息
- **技能系统** — 支持多种设计风格与工作流
- **桌面体验** — Electron 主进程统一承载 API、进程管理、窗口启动

## 快速开始

```bash
# 前置条件
# - Node.js ~24
# - pnpm >= 10.33.2
# - Codex CLI 已安装并可用

pnpm install
pnpm dev
```

## 主要命令

```bash
# 启动 Electron 开发模式
pnpm dev

# 单独启动前端开发
pnpm dev:web

# 构建 Electron 主进程 / preload / renderer
pnpm build
```

## API

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/health` | GET | 健康检查 |
| `/api/version` | GET | 版本信息 |
| `/api/agents` | GET | 检测已安装代理 |
| `/api/skills` | GET | 技能列表 |
| `/api/projects` | GET | 项目列表 |
| `/api/projects` | POST | 创建项目 |
| `/api/projects/:id` | GET | 项目详情 |
| `/api/projects/:id` | PUT | 更新项目 |
| `/api/projects/:id` | DELETE | 删除项目 |
| `/api/projects/:id/messages` | POST | 保存对话消息 |
| `/api/projects/:id/raw/:path` | GET | 读取项目文件 |
| `/api/chat` | POST | SSE 流式对话 |

## 项目文件结构

```
.od/projects/{projectId}/
  project.json
  .messages.json
  index.html
  prototype-spec.json
```

## 技能系统

- `skills/*/SKILL.md` — YAML frontmatter + Markdown body
- frontmatter 字段：`name`, `description`, `od.mode`, `od.category`, `od.example_prompt`

## License

MIT