# 快速开始

欢迎使用 Cook! 这是一个帮助你决定"今天吃什么"的应用。

## 环境准备

### 系统要求

- Node.js 24（`.nvmrc` 锁定；Node 26 上 ESLint 会原生崩溃，暂不支持）
- pnpm >= 11.21

### 安装依赖

```bash
# 克隆项目
git clone https://github.com/YunYouJun/cook.git
cd cook

# 安装依赖
pnpm install
```

## 开发

### 启动开发服务器

```bash
pnpm dev
```

访问 <http://localhost:3000> 查看应用。

### 数据管理

菜谱数据保存在本地 CSV 文件 `packages/data/recipe.csv` 中。

#### 更新菜谱数据

```bash
# 手动编辑 packages/data/recipe.csv 后转换为 JSON
pnpm convert
```

详细的 CLI 使用说明请查看 [Cook CLI 文档](/dev/cli)。

## 构建

### Web 应用

```bash
# 构建生产版本
pnpm build

# 预览构建结果
pnpm preview
```

## 项目结构

```
cook/
├── apps/web/           # Web 应用（Nuxt）
│   ├── app/            # 应用源码
│   │   ├── components/ # Vue 组件
│   │   ├── composables/# 组合式函数
│   │   ├── pages/      # 页面路由
│   │   └── utils/      # 工具函数
│   └── public/         # 静态资源
├── docs/               # 文档网站
├── packages/
│   ├── cook/           # CLI 工具与推荐/搜索核心
│   └── data/           # 菜谱数据 (CSV + JSON)
└── test/               # 测试
```

## 下一步

- 📖 查看 [CLI 文档](/dev/cli) 了解数据管理
- 💻 查看 [Web 应用开发](/dev/app) 了解技术栈与登录流程
- 🍳 开始添加你喜欢的菜谱!